Illumination Software Creator
Tutorial : Custom Blocks
Occasionally you'll want to accomplish something that Illumination simply isn't capable of “out of the
box”. This is where Custom Blocks come in.
Custom Blocks allow you to use actual “code” to create new functionality that can be re-used in your
Custom Block to extend the functionality of the HTML5 target.)
Each Custom Blocks is stored in its own “.isb” file. This file can be easily moved between machines
(and even distributed to other people using Illumination Software Creator). In this way, it becomes
possible to extend the capabilities of Illumination almost infinitely.
And, other than the part where you need to write some “code”, the process is actually pretty easy. Let's
walk through it step by step.
Step 1) Create The Custom Block
This part is nice and easy. From the File menu, choose “New Custom Block...”
Step 2) Set The Properties
Each Custom Block has a set of properties that
you can set:
Block Name : This is the name of the
Block as you would see it within
Category & Description : These fields
can be set to anything you like for your
own reference (these will be used in a
future version of Illumination for categorizing Custom Blocks).
Input Name : This is the text for the input. Could be anything you like (“Go”, “Start”, etc).
Step 3) Choose Your Outputs
Custom Blocks can have up to two unique Outputs that you can name whatever you like. This allows
you to have multiple possible branches of logic (perhaps your block is a true/false test... one Ouput
could be named “True”, the other “False”).
Simply check “Enabled” next to the Output you'd like to use and set the text that will show for that
Output within Illumination.
Step 4) Choose Your Variables
On the right hand side of the Custom Block editor is where you can set which project variables will be
used by your Custom Block.
Whatever variables you set here (including the type of variable you'll require and the description) is
what you'll set using the right hand side block property in the main Illumination project view.
Example: If you want your block to use a Number variable from your project, you'd check the
“Enabled” checkbox for a variable and select “Number” from the drop down box.
Step 5) Write The Code
This is the tricky bit where you'll need to write some code (and so you'll need to have some ability to
write code in whatever language you want this Custom Block for).
But here are a few things to know as you work on developing your Custom Block:
Each Custom Block can be built for any individual target (HTML5, Android, etc) that
Illumination supports... or all of them at once. You can toggle between the code for each target
by selecting the target you'd like to work on from the list on the left.
If you would like to call an output in your code, simply add the text from “Code To Use” for the
desired Output to the spot in your project where you'd like the output to be triggered (typically
this is something like “#Output1”).
The same goes for Variables. Whenever you'd like to use a variable within your code, simply
add in the “CodeToUse” from the desired variable in your code.
If your new Custom Block requires some additional import statements, be sure to add those
statements to the “Import Statements” box in the center of the Custom Block Editor window.
That's it! Once you've created (and saved) a Custom Block you can use them by selecting the “Custom
Block” from the block category drop down on the main Illumination window.