The SDK is here!

NeonBoomBox · 02-01-2008, 03:55 PM

ok folks. those of you that want tinker around making your own module now you can have at it! this is in the very early stages so post any problems you may have so we can provide you with a great SDK.

NeonDev · 02-19-2008, 10:12 AM

so I have taken quite a bit of time ironing out the SDK and putting all the features in that the main application has (arrangeable buttons, color changing tables/buttons/sliders etc, border-less animating windows, bezels, lots more)

the best part in the new version is that for sliders and windows you simply use Apple's NSSliderCell and NSWindow in your custom module and NeonBoombox will automatically load my subclasses in place so that greatly reduces the care that 3rd parties need to take to make a compatible module.

I will not be posting the new SDK for sometime. Mainly due to a compatible version of Neonboombox itself not yet being available. If anyone has genuine interest in developing modules at this time feel free to contact me with a request and I will help you out.

NeonDev · 06-09-2008, 02:01 PM

I know its been a long while since I have updated the SDK. Fact is that the framework is done enough for anybody with know how to accomplish alot; it is the documentation that is lacking. I just don't have the time right now.

If you do decide to make you own module before I release the updated documentation be aware that there are several classes that will either disappear or be fundamentally reworked after I release NBB 1.0. (off the top of my head I would stay away from any of the window related classes and any table cell class or just be aware that those will undergo some hefty changes that will break any modules that rely on them. some may disappear and be reconstituted as categories instead.

control classes are safe for now (except for table cells).

with that said here is a sample xcode module project that you can download and do whatever you want to. all it does right now (I will continue to improve it over time) is create a control bar with a home and options button. the purpose however is to allow you to embed 3rd party applications by editing the launch.scpt and exit.scpt files included (they are just blank apple scripts right now). if you can't tell from the name they are scripts that will execute on module launch and exit respectively. you may also add scripts to the existing modules as well by creating scripts titled as explained above to a scripts subfolder in the module resource directory.

NOTE: for the scripts to be executed you must be using NBB release 9G (as of this writing it is unreleased)

hope somebody does something useful with this

EDIT:to recompile the projects you may need to relink the neonboomboxSDK framework to the one located at Noeonboombox/contents/frameworks. once it is built the resulting module can be dumped into anybody's NBB modules folder and work

EDIT2: you may also need to delete your prefs if you have set custom positions for the dial buttons. alternatively you can rename the module built in this project to something that comes after P. it will probably be many months before I create a way for the module loader to work around this issue unless 3rd party interest ramps up significantly

Edit3: new example project below

NeonDev · 06-22-2008, 10:39 PM

here is an updated example project. you will probably want to build it against the 1.0 RC 1 now available from the site but there should be no reason it wont link against the last build.

the module is prebuilt this time so you don't need xcode to compile it if you just want to edit the launch script to embed a different program (example uses safari).

still not perfect but I think it could work well enough with some tweaks.

EDIT: as I have mentioned elsewhere; if you have specified custom button positions for the dial you will likely need to delete your NBB prefs file to use this. Still working on a fix for this issue.