The '''CircleAligner''' component is used to position a list of slots in a circle.
The CircleAligner component is used to position a list of slots in a circle.
<!--T:2-->
<!--T:2-->
== Fields ==
== Fields ==
{{Table ComponentFields
{{Table ComponentFields
|AutoAddChildren|Bool| Controls whether slots below this component's slot in the hierarchy are automatically added to <code>_targets</code>
|AutoAddChildren|Bool| Controls whether slots below this component's slot in the hierarchy are automatically added to <code>Items</code>
|AutoAddIgnoreTags|{{RootFieldType|SyncFieldList`1|[[Type:String|String]]}}|TypeAdv1=true| If a slot has a Tag matching one of the tags in this list, it will not be auto added to <code>Items</code>
|Axis|Float3| The axis around which the slots will be aligned.
|Axis|Float3| The axis around which the slots will be aligned.
|Radius|Float| The radius of the circle that the slots will be positioned on.
|Radius|Float| The radius of the circle that the slots will be positioned on.
Line 20:
Line 19:
|FillWholeArc|Bool| If true, the last slot will be at the very end of the arch, otherwise there will be a gap after the last slots.
|FillWholeArc|Bool| If true, the last slot will be at the very end of the arch, otherwise there will be a gap after the last slots.
|RotationOffset|Float| An offset, in degrees, that is applied to the rotation of the target slots.
|RotationOffset|Float| An offset, in degrees, that is applied to the rotation of the target slots.
|Items|{{RootFieldType|SyncList`1|[[#Item|Item]]}}|TypeAdv7=true| The list of slots to be aligned.
|Items|{{RootFieldType|SyncList`1|[[#Item|CircleAligner.Item]]}}|TypeAdv8=true| The list of slots to be aligned.
}}
}}
== Item ==
== Item ==
{{stub}}
{{Table TypeFields
{{Table TypeFields
|Root|Slot| The slot to align.
|AngleOffset|Float| The offset amount of degrees the object should rotate from the default of pointing towards the center.
|_position|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv2=true| The position field of <code>Root</code>.
|_rotation|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv3=true| The Rotation field of <code>Root</code>.
}}
}}
<!--T:3-->
<!--T:3-->
== Usage ==
== Usage ==
{{stub}}
<!--T:4-->
<!--T:4-->
== Examples ==
== Examples ==
* [https://www.youtube.com/watch?v=5nX-eb9p9s4 CircleAligner tutorial] by [[User:ProbablePrime|ProbablePrime]]
* [https://www.youtube.com/watch?v=5nX-eb9p9s4 CircleAligner tutorial] by [[User:ProbablePrime|ProbablePrime]]
360 by default. If smaller, the slots will only fill that section of a circle. Likewise, if it is larger than 360, the slots will wrap around the circle multiple times.