forked from BilalY/Rasagar
44 lines
4.6 KiB
Markdown
44 lines
4.6 KiB
Markdown
# Set Position (Shape : Circle)
|
||
|
||
Menu Path : **Position > Set Position (Shape : Circle)**
|
||
|
||
The **Set Position (Shape : Circle)** Block calculates a position based on an input [ArcCircle](Type-ArcCircle.md) and stores the result in the [position attribute](Reference-Attributes.md), based on composition.
|
||
|
||
The Arc-Circle shape adds an arc property to the circle to determine its arc angle, in radians. setting an arc value of pi creates a half-circle.
|
||
|
||
This Block can calculate the position either from the ArcCirlce's **Surface**, **Volume**, or **Thick Surface** where thickness can be relative to the size of the shape, or an absolute value.
|
||
|
||
|
||
This Block also calculates a direction vector based on the calculated position on the shape, and stores it to the [direction attribute](Reference-Attributes.md), based on composition. This direction is equal to the normalized vector from the center of the circle to the calculated position.
|
||
|
||
**Note**: [Velocity from Direction and Speed](Block-VelocityFromDirectionAndSpeed(ChangeSpeed).md) Blocks can then process the direction attribute.
|
||
|
||
Main.gif)
|
||
|
||
## Block compatibility
|
||
|
||
This Block is compatible with the following Contexts:
|
||
|
||
- [Initialize](Context-Initialize.md)
|
||
- [Update](Context-Update.md)
|
||
- Any output Context
|
||
|
||
## Block settings
|
||
|
||
| **Setting** | **Type** | **Description** |
|
||
| ------------------------- | -------- | ------------------------------------------------------------ |
|
||
| **Position Mode** | Enum | Specifies how this Block uses the shape to calculate a position. The options are:<br/>• **Surface**: Calculates positions only on the shape’s surface.<br/>• **Volume**: Calculates positions inside the entire shape’s volume.<br/>• **Thickness Absolute**: Calculates positions on a thick surface of given absolute thickness.<br/>• **Thickness Relative** will compute a position on a thick surface of a given percentage of the Shape’s size. |
|
||
| **Spawn Mode** | Enum | The method this Block uses to distribute particles along the shape’s arc. <br/>• **Random**: Calculates a per-particle random progress (0..1) on the arc. <br/>• **Custom**: Allows you to specify the progress in the **Arc Sequencer** property. |
|
||
| **Composition Position** | Enum | **(Inspector)** Specifies how this Block composes the position attribute. The options are:<br/>• **Set**: Overwrites the position attribute with the new value.<br/>• **Add**: Adds the new value to the position attribute value.<br/>• **Multiply**: Multiplies the position attribute value by the new value.<br/>• **Blend**: Interpolates between the position attribute value and the new value. You can specify the blend factor between 0 and 1. |
|
||
| **Composition Direction** | Enum | **(Inspector)** Specifies how this Block composes the direction attribute. The options are:<br/>• **Set**: Overwrites the position attribute with the new value.<br/>• **Add**: Adds the new value to the position attribute value.<br/>• **Multiply**: Multiplies the position attribute value by the new value.<br/>• **Blend**: Interpolates between the position attribute value and the new value. You can specify the blend factor between 0 and 1. |
|
||
|
||
## Block properties
|
||
|
||
| **Input** | **Type** | **Description** |
|
||
| ------------------- | ------------------------------ | ------------------------------------------------------------ |
|
||
| **ArcCircle** | [ArcCircle](Type-ArcCircle.md) | The ArcCircle that determines the shape to calculate the position from. Arc Circles are determined on the XY plane. |
|
||
| **Thickness** | Float | The thickness of the shape’s surface for position calculation.<br/>This property only appears if you set **Position Mode** to **Thickness Relative** or **Thickness Absolute**. |
|
||
| **Arc Sequencer** | Float | The position in the arc to spawn particles.<br/>This property only appears if you set **Spawn Mode** to **Custom**. |
|
||
| **Blend Position** | Float | The blend percentage between the current position attribute value and the newly calculated position value.<br/>This property only appears if you set **Composition Position** to **Blend**. |
|
||
| **Blend Direction** | Float | The blend percentage between the current direction attribute value and the newly calculated direction value.<br/>This property only appears if you set **Composition Direction** to **Blend**. |
|