Joe Kaplan

If you've worked with Min Devkit enough to recognize how awesome it is, you might also have run into a few of its limitations when working with Max's more advanced features such as dictionaries, notifications, UI objects, etc.

Min Devkit is a wrapper around Max SDK, and in fact, the entire Max SDK Base is included in the min-api folder.  Mixing and matching Min Devkit and Max SDK takes some care.  There are also there are a few essential, undocumented, setup components that need to be addressed before you're able to do anything substantial here.  The notes below are assembled from my learnings across several threads in this forum.  Thanks especially to 11OLSEN and Rob Ramirez for all the support.

Two Methods for Using Max SDK in Min Devkit Projects

1)  Call Max SDK Functions in Min Devkit Source Code

If you want to use a feature of the Max SDK that isn't fully implement in Min, you can call any Max SDK function by prefixing it with c74::max.  For example: c74::max::object_notify().

Follow these suggestions and you should be able to leverage most of the Max features supported by MaxSDK inside MinDevkit.

2)  Create a Max SDK Object in a Min Devkit Solution

Sometimes calling a few Max SDK functions inside a Min object is not sufficient.  Min's support for UI Objects is either incomplete, incompletely documented, or both.  You might run into something that can be done in Max SDK that is very difficult to achieve in Min (textfields  are a good example).   In this case it can be easier just to build a Min SDK object and include it  in your MinDevkit package.

There are probably a few ways to do this. Below is my preferred solution:

1) Create a new Min Object the way you normally would.

2) Delete the contents of the source file.

3) Replace the contents of the source file with well-formed Max SDK source code.  Ideally, paste in an entire example from the Max-SDK.

4)  Somewhere early in the ext_main function you will find the line where class_new() creates the class.

In the simplemax example from Max SDK it looks like this:

c = class_new("simplemax", (method)simplemax_new, (method)simplemax_free,  ....

The first argument, the string in quotes, needs to match the name of your file.  So if your source file is "MyNewObject.cpp" then the first argument of class_new() should be "MyPatch". eg:

c = class_new("MyNewObject", (method)simplemax_new, (method)simplemax_free,  ...

You can replace the name of your template (in this case, simplemax) throughout the code, but the only one that matter is the first argument of class_new().  If you don't do this, your object will appear red in Max and there will be no indicator as to why.

5)  You could stop here, but it's possible to go a step further.  Delete all the includes from the top of the file.  Replace them with: 

Now we are literally running Max SDK inside of Min.  We could even call Min functions inside it using the  c74::min:: prefix.  (Very cool in theory, use in practice at your own risk)

Most importantly, the new Max SDK object is running entirely on modern C++ which means you get access to the C++ standard libraries and any third party C++ libs you want to use.

The same concern about common symbols applies.  Be sure to include 

 in your cmakelists.txt as described above.

. Include this as well using the same method.

Your cmakelists.txt for a Min object that uses Max SDK to create a UI Object should have the following:

	${MAX_SDK_INCLUDES}/common/jpatcher_syms.c

Armed with this, you should be able achieve anything Max SDK is capable of inside a Min Devkit Package.

I hope this is helpful to someone.  I offer it as gratitude to the folks who helped me figure this stuff out.

Hi all,

If you've worked with Min Devkit enough to recognize how awesome it is, you might also have run into a few of its limitations when...

Using Max SDK in MIN Devkit Projects: A How To Guide