# SubModels

## Node Range SubModels

This setting allows the user to specify parts of a model to be controlled as if it were its own model. For example, you could defined the horizontal and vertical section of a windows frame.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-Mc-N1qkFg1xC4yqvNaO%2F-Mc-NbXfLvIjsyfTcjiY%2Fimage.png?alt=media\&token=ea78e112-d870-480b-92c7-6eb9040e510b)

Click Add to create a new submodel. Then add the nodes that will be included in the submodel. On the right side you will see the model and selected nodes will be highlighted.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-LxnsOsC9N2nxnQwc2B0%2Fimage.png?generation=1581749171791935\&alt=media)

On the right side, the model will be displayed with the selected nodes highlighted. If the user clicks the row header(Top or Bottom), the display will highlight only the nodes in the selected row. If the user clicks the "Node Ranges" column header, all the nodes from all the rows will be highlighted.

The Node Ranges 'Grid' represents the submodels render buffer. A grid five row high with five nodes listed per row will create a 5x5 Render buffer.&#x20;



![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ2Jwp7mRP9HqIZtQ_h%2Fuploads%2FQVX183wspMUmiT1t4ZC8%2F5by5.png?alt=media\&token=fea48a4c-3a38-4ecd-aaa8-62ea74433043)

Empty Commas(,) can be used to create empty spaces in the render buffer. The example below will create 5x5 a outline with a 3x3 'hole' in the middle.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-Lji9O_o2BgwV8njiCxv%2Fimage.png?generation=1581749194084671\&alt=media)

{% hint style="info" %}
Always Press 'Tab' after changing the submodel name or adding nodes to a row. This will guarantee the changes will "stick" and not disappear.
{% endhint %}

{% hint style="info" %}
The 'Vertical Buffer Layout' checkbox with rotate the underlining render buffer 90 degrees.
{% endhint %}

To graphically select the nodes, double click the row header or row cell and select the desired nodes. This option will only populate one row at a time.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-Mc-N1qkFg1xC4yqvNaO%2F-Mc-Nwdfn8PWjoyTmPgk%2Fimage.png?alt=media\&token=1d331669-ae31-4d3a-9fad-93d4d1e9cfcd)

{% hint style="info" %}
Un-check 'Ordered Selection' to enable 'Click and Drag' Mode
{% endhint %}

## Draw Model

To Draw a model, like a Cross, across the whole model click the Draw Model Button.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-LZSGtDBwmPwaIOkOcJh%2Fimage.png?generation=1581749189798782\&alt=media)

Click and drag to select nodes(blue highlight). The selected node will turn grey once selected. Double clicking on a node number also toggles between selected and not selected. 'Select All' will select all the nodes. 'Select None' will deselect all the nodes. The 'Ordered Selection' checkbox enables a single select mode that disables 'Click and Drag'(blue highlight) Mode. 'Ordered Selection' is used to select the individual nodes in a specific order to be used by the underlying buffer.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-MDBQxs9iotrJbugSGVz%2F-MDBSmu7d2KwoAfX1saj%2Fimage.png?alt=media\&token=111dd3d3-64db-48f2-8f14-5fb90d3a5e25)

The "From Model" button allows the user to select nodes based on the custom model "shape". For Example, you can import a snowflake model file to overlay it on a matrix.

Hold the 'Ctrl'/'Cmd' Key highlight the cells and press Ctrl+C to copy them. Ctrl+V can then be used to paste the cells. This data can also be copied to and from Excel.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-LpZuPx8t4zO5eX7lOnZ%2Fimage.png?generation=1581749190058246\&alt=media)

Click Ok to Close the select window.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-LsgjAnQyhAC61Z-PHFF%2Fimage.png?generation=1581749162990949\&alt=media)

## SubBuffer SubModel

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-LaXoE1JNIR28NNPOnWp%2Fimage.png?generation=1581749179470535\&alt=media)

The SubBuffer tab allows the user to select sections of the buffer instead of the nodes. This can be used to divide mega trees/matrices into slices for singing face or individual effects.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-M06aAFDbPcsg53Bcg0_%2Fimage%20\(754\).png?generation=1581749196173705\&alt=media)

Click The Action Button and Select Generate Slices to automatically generate different size slices.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-Mc-N1qkFg1xC4yqvNaO%2F-Mc-PDeO5UHmOuv-4rrG%2Fimage.png?alt=media\&token=010853ee-1caf-4b14-b58c-b91c137ed9e2)

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-M06aAFFEvoHVL5Kb2IQ%2Fimage%20\(778\).png?generation=1581749196318125\&alt=media)

Vertical Slices will create 'count' number of vertical slices that are equal size.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-Mc-N1qkFg1xC4yqvNaO%2F-Mc-PUn9V2WoJ9KvyLwi%2Fimage.png?alt=media\&token=d5d2f3df-895e-43c9-b236-c078aa3b59e7)

## Delete

Delete the currently selected submodel(s).

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-LbzzVkH-WQRNEc-pKe_%2Fimage.png?generation=1581749178890430\&alt=media)

{% hint style="info" %}
To select multiple submodel to delete, hold the shirt or ctrl/command key.
{% endhint %}

## Copy

Copy the currently selected submodel.

## Action

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-Mc-N1qkFg1xC4yqvNaO%2F-Mc-QLmtRvFDNx_wVQ4l%2Fimage.png?alt=media\&token=812bce73-8c76-4fa3-9267-b64acdf2a2a7)

### Generate Slices

Select Generate Slices to automatically generate Subbuffer style Submodels.

### Flip All SubModels Vertical

This will flip all the node number rows, top to bottom, bottom to top.

### Flip All SubModels Horizontial

This will flip all the node number row values, left to right, right to left.

### Shift All Nodes in All SubModels

This will Shift all the submodels nodes numbering 1->21, 100->120

### Reverse All Nodes in All SubModels

This will reverse all the submodels nodes numbering. 1->100, 100->1.

## Import

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-Mc-N1qkFg1xC4yqvNaO%2F-Mc-PikPy2RT-cIacAmD%2Fimage.png?alt=media\&token=0e97dee5-5968-4c85-a8d8-c74e872ff3f2)

### Import SubModels from Model

This allows the user to 'copy' submodels from another similar model. Example, if multiple mini-trees, are defined in your layout, only create the sub-models on one tree and then use this option to import the sub-models on all the other trees.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-Ld5ugbJQToHlGZfqTpS%2Fimage.png?generation=1581749185662413\&alt=media)

### Import SubModels from File

This allows the user to 'copy' submodels from a XModel file.

### Import Custom Model Overlay

This option will use a custom model file(.xmodel) to create submodels based on X/Y location of the node locations. The height and width of the custom model file must be smaller than the matrix height and width. This will also import the singing face and model state defines.

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-LZSI3En4361WbEcX3Y_%2Fimage.png?generation=1581749184292839\&alt=media)

## Export

![](https://1941201815-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-Mc-N1qkFg1xC4yqvNaO%2F-Mc-Q9f9NAOsOFVDRyOZ%2Fimage.png?alt=media\&token=bae1b171-fc4d-49d8-b665-a3b29a24bc48)

### Export SubModels as CSV

This exports all the submodel definitions as a CSV file for viewer with Excel or other spreadsheet software.

### Export SubModel as xModel

This generates a Custom Model xModel file of the currently selected submodel.
