> For the complete documentation index, see [llms.txt](https://scenegroup.gitbook.io/cavalry/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scenegroup.gitbook.io/cavalry/nodes/behaviours/visibility-sequence.md).

# Visibility Sequence

Affect the visibilty of Sub-Meshes

### Intro

The **Visibilty Sequence** Behaviour can be used to affect the visibility of [sub-meshes](/cavalry/nodes/behaviours/sub-mesh.md) like a [Duplicator](/cavalry/nodes/shapes/duplicator.md) or [Text](/cavalry/nodes/shapes/text-shape.md). The visibility for each sub-mesh can be determined by setting a range. Any sub-meshes that fall outside the range will have their visibility set to off.

For example, if you were using a **Visibility Sequence** connected to a [Duplicator](/cavalry/nodes/shapes/duplicator.md) with a **Count** of 10, a **Start** value of **10%** would set the visibility of the first sub-mesh in the Duplicator to off (10% of 10 is 1 and so the first sub-mesh falls outside the range).

![](https://1676825895-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LT2-S1m8aSPAI_Gg3Q1%2F-MRf8klvW6mIA7F60Xr4%2F-MRfHStXjuDNZQE79cJr%2FvisSequence.png?alt=media\&token=6b3c4daf-0f74-4d07-afa7-01584e48246a)

### **UI**

**Start** - set a percentage to mark the start of the range.

**End** - set a percentage to mark the end of the range.

**Travel** - incrementally offset the range by one sub-mesh at a time.

**Always On** - enter a comma separated list of Ids to always remain visible. Colons can also be used to set ranges - `1,3,5:8`

**Always Off** - enter a comma separated list of Ids to always remain invisible. Colons can also be used to set ranges - `1,3,5:8`

**Invert** - invert the resulting range so anything outside of the range is set to on.

{% hint style="info" %}
Example usage:

1. Hold **option/alt** and click the **Ellipse tool** to create an **Ellipse**.
2. With the **Ellipse** selected, click the [Duplicator](/cavalry/nodes/shapes/duplicator.md) icon in the [Shelf](/cavalry/user-interface/menus/window-menu/shelf.md).
3. Set **Distribution** to **Linear**.
4. Set **Count** to **10**.
5. Set **Size** to **1000**.
6. Right click on the **Shape Visibility** attribute.
7. Choose **Add Behaviour > Visibility Sequence**.
8. Load the **Visibility Sequence** into the [Attribute Editor](/cavalry/user-interface/menus/window-menu/attribute-editor.md).
9. Set **Start** to 50%.

The first 5 sub-meshes of the Duplicator will be hidden.
{% endhint %}
