Tutorial Project

This chapter guides you through a very simple tutorial to understand onCore's basics.

Aims of this Tutorial:

Adding → Units to an empty Workflow.
Adding a → Trigger Unit.
Connecting → Cables between Units.
Setting → Unit attributes.
→ Running the Project.
Using the → Message Log to see Unit output.

Adding Units

Visual Instructions	Instructions	Notes
	Click on the Library tab in the Inspector.	You can access the Library quickly by using the option + space shortcut.
	Activate the "Search:" field and enter the name of the Unit you are looking for – in this case enter "print". Double click on the Print String Unit which shows up after entering the search term.	After entering a search term you can directly jump to the list of found Units by using the tabulator key. Select the desired Unit and add it to the Workflow View by pressing the enter key.
	The Print String Unit should now be visible in the Workflow View.
	Now add the Trigger on Start Unit. Use the same procedure as described above.	After entering a search term you can directly jump to the list of found Units by using the tabulator key. Select the desired Unit and add it to the Workflow View by pressing the enter key.
	Both Units should be visible in the Workflow View by now. As you can see they are overlapping.	You can also use the Align & Distribute functions of onCore to reorder Units in the Workflow View.
	Drag the Trigger on Start Unit to the left side of the Print String Unit. After dragging, it should look like this.	By now you have added two Units to create the most minimal Workflow.

Connecting Units

Visual Instructions

Instructions

Notes

Click on the Out Port of the Trigger on Start Unit. A single click is sufficient.
Now connect the Cable to the In Port of the Print String Unit by clicking on the In port.

By connecting the Trigger Ports you make sure that the Print String Unit gets executed after starting (= running) the Project.

For detailed information about Cables, please refer to the chapter → Cables.
For detailed information about Unit Triggers, please refer to the chapter → Unit Triggers & Events.

Modifying Unit Attributes

Visual Instructions

Instructions

Notes

Double click the "String:" Port on the Print String Unit.

Instead of modifying the Unit directly in the Workflow View you can also use the Inspector in the Project Panel. For more info refer to the chapter → Unit Attributes.

Enter "Hello World" and press the enter key.

You have now modified one of the attributes of the Print String Unit. The text you defined previously will alter be printed to the Message Log.

For detailed information about Unit Attributes, please refer to the chapter → Unit Attributes.

Running the Project

Visual Instructions	Instructions	Notes
	Open the Project menu. Select Run Project (shortcut: command + R).	For detailed information about running onCore Projects, please refer to the chapter → Running an onCore Project.

	Project Running Indicator: This indicator is visible as soon as you run a Project.
	Message Log Entry: The Message Log shows the value which you have specified on the Print String Unit.