> For the complete documentation index, see [llms.txt](https://jeratools.gitbook.io/gridbuilder/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jeratools.gitbook.io/gridbuilder/documentation/grid-modes/spherical-grid.md).

# Spherical Grid

A complete guide on the Spherical Grid.

<figure><img src="/files/tULlgakSaSdBUajzEUsP" alt=""><figcaption></figcaption></figure>

Take any assets and align them in a Spherical grid. By default, the assets will be distributed in a perfect sphere within 3D space.

***

**Important notice:** Grid Rotation is missing on purpose. Due to the 3D distribution and Grid Rotation mimicking the Z-Rotation is not necessary as it is within other grid modes.

***

## Parameters

<details>

<summary>Grid</summary>

### Radius

Defines the radius of the spherical grid. This is being calculated within 3D space.

</details>

<details>

<summary>Transform</summary>

### Twist X | Twist Y | Twist X

Twist allows you to individually rotate the assets on all three axes. All assets are affected equally by these parameters.

***

### Stagger

Stagger will calculate a defined offset to the Twist Rotation values, creating an offset that grows the further down the assetline.&#x20;

In calculation, the Stagger value is the value that gets added to your last asset. If the Twist X value is 0 and the Stagger value +90, then the first asset will remain 0 degrees rotation and the last asset will recieve a 90 degrees value. All assets in between are calculated to create a staggered effect.

***

### Stagger Axis

Defines which Twist Axis is being affected by the Stagger. On default, Stagger calculation is applied to all three axis (XYZ). When changed to "X", then the Stagger effect is only applied to the X Rotation.

***

### Global Opacity

Instead of animating every asset individually, Global Opacity controls the opacity of all assets. But it will respect any manual adaptions on the individual asset. Global Opacitys value represent the percentage of the set opacity. If your assets are set on 30% opacity individually, the Global Opacitys value of 100 means 30%, Global Opacity value of 50 will mean 15% on every asset and so furth.

</details>

<details>

<summary>Scale by Position</summary>

Scale by Position allows you to create different looks based on the assets position by scaling the assets.

In general, "Front" always means the first Index, where "Back" means the last index. All assets in between are calculated to create a smooth staggering effect.

***

### Scale Front

The scale value of the first asset in your grid.

***

### Scale Back

The scale value of the last asset in your grid.

***

### Scale by Position

Enable the "Scale by Position" checkbox to use the "Linear Direction" angle control.\
"Front" and "Back" values are now attached to the angle control that follows below. The Front is no longer the first asset.

***

### Pitch | Yaw

Those controls slightly differ from the "Linear direction" angle controls in other modes. Due to the spherical attributes in 3D space, we need two controls to rotate on both axes.

A 90 degrees value on "Yaw" lets the utmost right asset be 100% influenced by the "Scale Front" value. A 90 degrees value on "Pitch" lets the utmost front facing assets be 100% influenced by the "Scale Front".

***

### Scale Falloff

A parameter to control the falloff of how strong is being transitioned between the "Front" or "Back" scale values and neighboured assets.

***

### Focus Target

One of Grid Builders most impactful features. Instead of adjusting all three axes to center one of the elements, the focus target slider will do that for you fully automatically. \
For this slider, you can animate from any asset index to any asset index. The magic: only the keyframe values are being considered to calculate the perfect, most direct way towards the second chosen index. \
For example: when you animate from 1 to 4, the slider will show the typical increments of 2 and 3. The calculation however ignores these in between numbers entirely and finds the most direct way from asset 1 to asset 4.

</details>

<details>

<summary>Options</summary>

### Orientation

**Inward** - the default orientation, where the assets will remain facing toward the center into the middle of the sphere

**Outward** - the assets will face towards the outside of the sphere.

**Screen** - no matter the rotation on the control Null, all assets will consistenly face towards the screen

***

### Shuffle

Randomly reassign each asset a different position within the grid.

***

### Random Offset

Generate random position offset for each asset within the grid

***

### Random Seed

A seed generator to give you different result for "Random Offset" for each value

</details>