Document toolboxDocument toolbox

2023.1.116.1 Box Asset Synchronizer



Overview

A BoxAssetSynchronizer can link multiple axes/segments of BoxAssets to each other so that they will scale along with each other as defined by the user.
The BoxAssetSynchronizer will act as a manager that oversees the link between BoxAssets but has no part the scaling of BoxAssets itself. To make use of an existing link, simply scale the BoxAssets as normal and any linked BoxAssets will automatically scale along with it.

Two conveyors that have their X-Axis synchronized

Where to find

The feature can be found under Add Component > BoxAssetSynchronizer


Feature Layout

Fields

 

1

An open foldout that shows the settings for an existing link.
It show a summary of the link, stating the two assets linked, the direction of the link and the type of link.
If it was set up correctly, it is colored green. Otherwise it is colored red.

2

A delete button for an existing link.

3

A button to create a new link.

4

Assign a BoxAsset the be the first asset in the link.

5

Assign an Axis or a Segment on the first BoxAsset to be linked.

6

Assign a BoxAsset the be the second asset in the link.

7

Assign an Axis or a Segment on the second BoxAsset to be linked.

8

The direction of the link. Bidirectional applies the link. Forward applies the link from the first to the second BoxAsset. Backward applies the link from the second to the first BoxAsset.

9

The type of the link. Absolute applies the absolute change in length to the linked BoxAsset. Relative applies the percentual change in length to the linked BoxAsset.

 

Important: In order for the link to be set up correctly, some restrictions apply.

A link will be incorrectly set up when one of the following conditions is true:

  • A BoxAsset has not been assigned.

  • The first and second BoxAsset are the same BoxAsset and the same Axis has been selected on both.

  • The first and second BoxAsset are the same BoxAsset and the selected Segment on one of the BoxAssets is part of the selected Axis on the other BoxAsset.


How to use

  1. Create a BoxAssetSynchronizer by adding the component to a GameObject. This can be the same GameObject as a BoxAsset you wish to link, but it can also be its own separate GameObject.

     

  2. Add a new Link.

     

  3. Assign the first BoxAsset in the link. Assign the second BoxAsset in the link. This can be the same BoxAsset as the first.

     

  4. Assign an Axis or Segment to link for the first BoxAsset. Assign an Axis or Segment to link for the second BoxAsset.

     

  5. Set the direction and type of the link.

If the link was correctly set up, it should be marked green. The link is now active and ready to use. Scaling the selected BoxAssets will now make use of the link and automatically scale the linked BoxAsset along with it.


Prespective Documentation