Patch Editor
Patch Groups and Patch Assets

Patch Groups and Patch Assets

You can save and share groups of patches with other Spark AR Studio creators, and import ready-made patch groups into your own projects. It's a great way to efficiently build effects with logic and interactivity.

Creating a Patch Group

Once you're happy with your graph:

  1. Selecting your graph.
  2. Right-click on the patches, and select Group.

Your patch group will look like this:

You can change the name of the patch group by right-click on the name at the top of the patch group.

Editing a Patch Group

To edit the properties of a patch asset:

  1. Right-click the Patch Group.
  2. Select Group Properties.

A new window will appear where you can edit the patch asset’s properties, such as the name and the inputs and outputs:



You can reorder the inputs and outputs by clicking and dragging to new locations. The new order will be reflected automatically in the patch group.

Converting a Patch Group to a Patch Asset

In order to save and share a patch group, convert it to a patch asset. To do so:

  1. Right-click the Patch Group.
  2. Select Convert to Patch Asset.

The patch group will now be orange in color. It will be listed in the Assets panel because you’ve converted it to a patch asset:

If your patch asset is a Patch Asset Material Patch Asset Material, it’s worth familiarising yourself with this documentation to make sure you’ve set the right values for the input and output ports.

Sharing Patch Assets

If you right click on the patch group in the Assets panel and select Reveal in Finder, you'll see that an .arp file has been be created. You can share this file with other creators!

Any groups of patches you've added to a project will be saved in the patch library, under Saved Patches:

Importing a Patch Group

Now you’ve created a shareable patch asset file either import or drag the .arp file directly into the Assets panel, like you would any other asset.

Add the patch asset to the Patch Editor by dragging it from the Asset panel straight into the Patch Editor and connecting it to other patches in your project.

Editing a Patch Asset

You can use the patch asset as many times as you want in your patch graph and quickly edit all instances of this patch asset at the same time.

Any changes you make to the patch asset, either in the Asset panel or in your graph, will be applied to the patch asset wherever it is used in the project.

Properties

To edit the properties of a patch asset:

  1. In the Assets panel, select the patch asset.
  2. In the Inspector and click Properties.
  3. A new window will appear where you can edit the patch asset’s properties and reorder the inputs and outputs:

Patches

You can view and edit the individual patches even after you’ve created it. To do so:

  1. In the Assets panel, select the patch asset.
  2. In the Inspector and click Patches.

Finding and Sharing Patch Assets

A great way to find and share patch assets is by joining the Spark AR Creator Group.

You can also import patch assets into your project directly from AR Library to quickly add logic and interactivity to your effect.

Was this article helpful?