Save time by abstracting frequently used patches and layers, building a library of reusable components and sharing them with your team.
Create components to reduce clutter and encapsulate a group of patches that perform a function. Similar to creating functions in programming. To group multiple patches into one component, select them and choose Component > Create Component ⌃⌘G. Layer property patches cannot be grouped into a patch component - to build patch groups with layers, use layer components.
To enter a patch group, double-click it or press ⌥↓. To leave it and go back, press ⌥↑. Menu items for entering and leaving a patch group are Component > Enter Component and Component > Exit Component.
To create a component, select layers and choose Component > Create Component ⌃⌘G. This will group them into a component in the layer list. Enter and exit the component using ⌥↓ and ⌥↑. Copy and paste patches into the component to encapsulate existing logic in patch editor. Create inputs and outputs using the Patch Info Popover ⇧⌘I.
Use the Touch menu to access the outputs of components.
Components Inputs and Outputs
To add, edit, re-order or remove the individual inputs and outputs, select the patch group and choose Patch > Patch Info ⇧⌘I to bring up the Patch Info popover. The Port Setup tab allows you to change the port type and other properties like default, maximum and minimum values.
To publish inputs or outputs from inside a patch component, select a port and choose Patch > Publish Port ⌥P. This will add a purple or blue patch that represents an input or output on the patch group.
Components also have a number of special port tags available in the dropdown menu - for example, using the Enable tag will reveal the eye icon on your component for quick enabling or disabling. When a special tag isn’t needed, use the generic Custom tag.
If you have a patch component that you use over and over, it may make sense to add it to your patch library. Select the patch component and choose Component > Add to User Library ⌘⌥L. Reveal the patch library folder by choosing Component > Show Patch Folder.
Once a component is in your library, you will be able to add it the same way as you add other patches and layers next time you start or open a document. To make it available in your current document, close and re-open it.
To make changes or add functionality to a component in your library, insert the patch or layer component to your document, make your changes and choose Component > Add to User Library again. Close and re-open any documents using this patch group or component, and Origami Studio will prompt you to upgrade the patches to the new version.
Make one-off changes to any patch or component by unlinking it from the library. Select the patch or layer component and choose Component > Unlink Component from Library.
To limit a patch or component to a platform, specify a platform in the Patch Setup tab of the Patch Info popover. This will make your patch or component available only if the current device matches the chosen platform.
Sharing a Folder of Patches and Components
To make components accessible to other team members, create a shared Dropbox folder and add your components to it. To save a component in your document to a shared folder, use the Component > Add to Other Library.
Members of the team can add this folder to the list of loaded libraries using the + button in Systems tab in Origami Studio preferences.