Difference between revisions of "Component: Clone Matrix (Misc)"
From Flowcode Help
Jump to navigationJump to search (Created page with "{| style="width:50%" |- | width="20%" style="color:gray;" | Author | Matrix Ltd |- | width="20%" style="color:gray;" | Version | 1.1 |- | width="20%" style="color:gray...") |
|||
| Line 15: | Line 15: | ||
Takes a single object and produces a three dimensional array of evenly spaced clones. Inidividual items in the array can be found from their position and individually modified after the array has been created. | Takes a single object and produces a three dimensional array of evenly spaced clones. Inidividual items in the array can be found from their position and individually modified after the array has been created. | ||
| − | ==Component | + | ==Component Source Code== |
| − | + | Please click here for the component source code: [https://www.flowcode.co.uk/wikicopy/componentsource/FC_Comp_Source_Clone_Matrix.fcfx FC_Comp_Source_Clone_Matrix.fcfx] | |
==Detailed description== | ==Detailed description== | ||
| + | |||
| + | |||
| Line 32: | Line 34: | ||
==Examples== | ==Examples== | ||
| + | |||
| + | |||
| Line 148: | Line 152: | ||
|- | |- | ||
| colspan="2" | Whether the original object should be hidden once copied into the array. The object will be revealed automatically if the target object is changed or disconnected. | | colspan="2" | Whether the original object should be hidden once copied into the array. The object will be revealed automatically if the target object is changed or disconnected. | ||
| + | |- | ||
| + | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
| + | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | X Axis | ||
| + | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type-21-icon.png]] | | width="10%" align="center" | [[File:Fc9-type-21-icon.png]] | ||
| Line 158: | Line 166: | ||
|- | |- | ||
| colspan="2" | Distance between columns along the X-axis. | | colspan="2" | Distance between columns along the X-axis. | ||
| + | |- | ||
| + | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
| + | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Y Axis | ||
| + | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type-21-icon.png]] | | width="10%" align="center" | [[File:Fc9-type-21-icon.png]] | ||
| Line 168: | Line 180: | ||
|- | |- | ||
| colspan="2" | Distance between rows along the Y-axis. | | colspan="2" | Distance between rows along the Y-axis. | ||
| + | |- | ||
| + | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
| + | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Z Axis | ||
| + | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type-21-icon.png]] | | width="10%" align="center" | [[File:Fc9-type-21-icon.png]] | ||
| Line 178: | Line 194: | ||
|- | |- | ||
| colspan="2" | Distance between layers along the Z-axis. | | colspan="2" | Distance between layers along the Z-axis. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|} | |} | ||
Revision as of 17:44, 9 November 2022
| Author | Matrix Ltd |
| Version | 1.1 |
| Category | Misc |
Contents
Clone Matrix component
Takes a single object and produces a three dimensional array of evenly spaced clones. Inidividual items in the array can be found from their position and individually modified after the array has been created.
Component Source Code
Please click here for the component source code: FC_Comp_Source_Clone_Matrix.fcfx
Detailed description
No detailed description exists yet for this component
Examples
The clone matrix can be used to create multiple panel objects based on the geometry of a single object.
Here we have a sphere object on the panel
By adding the Clone Matrix component and configuring the component properties we generate the cloned objects. If we need to re-clone the objects at any time then we can simply refresh the properties of the clone matrix component.
Here is the final output result on the panel.
Once the matrix is generated you can control the properties of the individual items.
Example showing how to collect the handle of one of the clones to allow it's individual characteristics to be edited. For example in creating the simulation for a LED Cube or Array.
CloneMatrix
Downloadable macro reference
|
GetHandleFor |
| Gets the handle of the Nth object in the matrix. Index counts in the order along X, then Y, then Z. | |
 - UINT
|
Index |
| Index of the object to get a handle for. | |
 - HANDLE
|
Return |
|
|
GetHandleAt |
| Gets the handle of the object at position [X, Y, Z] in the matrix. | |
 - BYTE
|
IndexX |
| - BYTE
|
IndexY |
| - BYTE
|
IndexZ |
| - HANDLE
|
Return |
|
|
Update |
| Updates the matrix to reflect any changes to the source object. NB) This will discard any changes made to individual objects within the array. | |
 - VOID
|
Return |
Property reference
|
Properties |
|
Target Object |
| Chooses the original panel object to be cloned into the matrix. | |
|
Hide Target |
| Whether the original object should be hidden once copied into the array. The object will be revealed automatically if the target object is changed or disconnected. | |
|
X Axis |
|
Count |
| Number of columns of clones along the X-axis. | |
|
Spacing |
| Distance between columns along the X-axis. | |
|
|
Y Axis |
|
|
Count |
| Number of rows of clones along the Y-axis. | |
|
|
Spacing |
| Distance between rows along the Y-axis. | |
|
|
Z Axis |
|
|
Count |
| Number of layers of clones along the Z-axis. | |
|
|
Spacing |
| Distance between layers along the Z-axis. | |
