How to use Motion Array node in Oraphim

Type ID: motion.layout.repeater
Category: Generator

What this node does

The Motion Array node is registered in Oraphim's Generator category and performs the graph operation represented by its sockets and controls below.

The current Oraphim runtime registers 8 sockets and 63 properties for this node. Its main registered inputs are Source A / Custom Shape, Source B, Source C; its main outputs are Instances, Count, Metadata. The tables below are generated from the runtime registry rather than a handwritten approximation.

Inputs

Socket	Key	Type
Source A / Custom Shape	in_geometry	Geometry3D
Source B	in_geometry_b	Geometry3D
Source C	in_geometry_c	Geometry3D
Source D	in_geometry_d	Geometry3D
Custom Path	in_path	Path

Outputs

Socket	Key	Type
Instances	out_geometry	Geometry3D
Count	out_count	Int
Metadata	out_metadata	Metadata

Controls

Control	Key	Type	Group	Registry default
Layout	mode	String	Array	Linear
Dimension	dimension	String	Source	Auto
Source Shape	sourceShape	String	Source	Auto Shape
Instance Asset	instanceAssetId	String	Shared Asset	0.0
Shape Size	shapeSize	Float	Source	1.0
Shape Depth	shapeDepth	Float	Source	1.0
Shape Resolution	shapeSegments	Int	Source	32.0
Source Selection	prototypeMode	String	Source	Primary
Source A Weight	weightA	Float	Source Weights	1.0
Source B Weight	weightB	Float	Source Weights	1.0
Source C Weight	weightC	Float	Source Weights	1.0
Source D Weight	weightD	Float	Source Weights	1.0
Copies	count	Int	Array	5.0
Start Index	startIndex	Int	Linear	0.0
Distribution	distribution	String	Linear	Incremental
Offset X	offsetX	Float	Transform	2.0
Offset Y	offsetY	Float	Transform	0.0
Offset Z	offsetZ	Float	Transform	0.0
Rotation X Step	rotationX	Float	Transform	0.0
Rotation Y Step	rotationY	Float	Transform	0.0
Rotation Z Step	rotationZ	Float	Transform	0.0
Scale Mode	scaleMode	String	Scale	Add
Scale X Step	scaleStepX	Float	Scale	0.0
Scale Y Step	scaleStepY	Float	Scale	0.0
Scale Z Step	scaleStepZ	Float	Scale	0.0
Circular Plane	axis	String	Circular	XY
Radius X	radius	Float	Circular	4.0
Radius Y	radiusSecondary	Float	Circular	4.0
Spiral Step	radiusStep	Float	Circular	0.0
Depth Step	axialStep	Float	Circular	0.0
Start Angle	startAngle	Float	Circular	0.0
Arc Angle	arcAngle	Float	Circular	360.0
Close Circle	closeLoop	Bool	Circular	1.0
Face Center	faceCenter	Bool	Circular	0.0
Columns	columns	Int	Grid	3.0
Rows	rows	Int	Grid	3.0
Depth Layers	layers	Int	Grid	1.0
Center Grid	centered	Bool	Grid	1.0
Gap X	gapX	Float	Grid	2.0
Gap Y	gapY	Float	Grid	2.0
Gap Z	gapZ	Float	Grid	2.0
Curve	curveIndex	Int	Custom Path	0.0
Path Resolution	pathResolution	Int	Custom Path	24.0
Align To Path	alignToPath	Bool	Custom Path	1.0
Include End Point	pathIncludeEnd	Bool	Custom Path	1.0
Path Roll	pathRoll	Float	Custom Path	0.0
Path Offset X	pathOffsetX	Float	Custom Path	0.0
Path Offset Y	pathOffsetY	Float	Custom Path	0.0
Path Offset Z	pathOffsetZ	Float	Custom Path	0.0
Position Jitter X	randomPositionX	Float	Random	0.0
Position Jitter Y	randomPositionY	Float	Random	0.0
Position Jitter Z	randomPositionZ	Float	Random	0.0
Rotation Jitter X	randomRotationX	Float	Random	0.0
Rotation Jitter Y	randomRotationY	Float	Random	0.0
Rotation Jitter Z	randomRotationZ	Float	Random	0.0
Scale Jitter	randomScale	Float	Random	0.0
Material Variation	materialMode	String	Material	Keep Source
Material Count	materialCount	Int	Material	1.0
Material ID Offset	materialOffset	Int	Material	0.0
Deformation Attribute	deformationMode	String	Variation	None
Deformation Amount	deformationAmount	Float	Variation	0.0
Deformation Frequency	deformationFrequency	Float	Variation	1.0
Seed	seed	Int	Random	1.0

How to use it

1. Add Motion Array from node search. Use motion.layout.repeater when you need the exact registry entry.
2. Connect a compatible Geometry3D source to Source A / Custom Shape. Add the other inputs only when the operation needs them.
3. Start with the registry defaults and adjust Layout, Dimension, Source Shape first so you can see the node's effect in isolation.
4. Route Instances (Geometry3D) into a compatible downstream node, viewer, or output path.
5. Preview a representative frame, change one input/control at a time, and save/reopen reusable graphs to verify persistence.

Practical example

Create a small test graph with Motion Array. Feed a compatible source into Source A / Custom Shape. Change Layout away from its registry default and compare the result. Connect Instances to a compatible downstream stage so the result is visible. Keeping this test graph small makes socket-type, context, and parameter mistakes easier to diagnose before the node is used in a production graph.

Troubleshooting

• If a connection is rejected, compare the exact socket data types in the tables above; Oraphim graph connections are typed.
• If the result looks unchanged, confirm this node is on the active path to the viewer/output and that the expected graph/resource is selected.
• If a control is unavailable, check required inputs and whether the property belongs to an internal or mode-dependent group.
• If a saved graph behaves differently later, reopen it and verify node identity, connections, and edited property values before rendering.

Related nodes

• Grid Array — motion.layout.grid
• Radial Array — motion.layout.radial
• Array Modifier — motion.layout.blender_array
• Bar Chart Generator — motion.chart.bar
• Data Chart — motion.chart.data

Return to the complete Oraphim node reference.