> For the complete documentation index, see [llms.txt](https://stage-precision.gitbook.io/grid/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stage-precision.gitbook.io/grid/unity-integration/point-data/display-a-particle-cloud.md).

# Display a particle cloud

Use SPNet Particle Cloud to display incoming Point Data through a Unity Particle System. Each received point is represented by a particle at its tracked position.

This example uses Point Data Object ID `1`. Start with the connection described in **Connect Grid Studio and Unity**.

{% content-ref url="/pages/Ja1auhvBW5GmFp7vcqtE" %}
[Connect Grid Studio and Unity](https://stage-precision.gitbook.io/grid/unity-integration/getting-started/connect-grid-studio-and-unity.md)
{% endcontent-ref %}

#### Send point data from Grid Studio

1. Select a **Volume** with a point-data input, or a **Point Cloud Volume** producing tracked points or clusters.
2. In **Maps**, add an **SPNet Point Data Map Output** and assign your SPNet sender.
3. Set the outgoing object ID to `1`.
4. Choose **Global** coordinates for this example.

<div align="left"><figure><img src="https://1380116828-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc4nPw8BslCHXa7bL2mf8%2Fuploads%2FynMrF6zIAVws3fKHEDkE%2FPowerToys_znGda7fP91.gif?alt=media&amp;token=5a29e9e1-cad8-4152-9ca3-f1ca20c607fa" alt="" width="411"><figcaption></figcaption></figure></div>

{% content-ref url="/spaces/A6FCGfFOA45eEE2SR3Sp" %}
[Spatial Interactive Experiences](https://stage-precision.gitbook.io/grid/spatial-interactive-experiences/)
{% endcontent-ref %}

#### Create the particle cloud in Unity

1. Choose **GameObject → SPNet → Particle Cloud**.<br>

   <div align="left"><figure><img src="https://1380116828-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc4nPw8BslCHXa7bL2mf8%2Fuploads%2FoJyeoMH8vMPIXN22db0d%2FPowerToys_qexz99Qh7z.gif?alt=media&amp;token=28374b4b-7c88-4f05-b3bf-221b9e00b99b" alt="" width="347"><figcaption></figcaption></figure></div>
2. Select the new **SPNet Particle Cloud** in the Hierarchy.
3. Set the **Object ID** to the same number like the Grid Studio SPNet map out.<br>

   <div align="left"><figure><img src="https://1380116828-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc4nPw8BslCHXa7bL2mf8%2Fuploads%2FESeFl0mebmbA4B7dSwCy%2FPowerToys_WVV4dMbtCT.gif?alt=media&amp;token=30f78bc4-c1fc-43b7-9bd3-5b79868e9b9f" alt="" width="295"><figcaption></figcaption></figure></div>

The Receiver is assigned automatically or created when needed. The object also includes a configured Particle System and the default URP particle material.

**Object ID** selects the complete Point Data stream. Received point positions are applied in Unity world coordinates.

With **Preview In Edit Mode** enabled on the Receiver, the cloud updates in the Editor. It also updates in Play mode.

{% hint style="info" %}
Particles may initially be difficult to see because **Minimum Point Size** defaults to `0.02` Unity units.

Increase this value to `0.1` or `0.2` as a starting point, then adjust it to suit your scene scale and camera distance.
{% endhint %}

#### Point settings

| Setting                | Default | Effect                                                                                            |
| ---------------------- | ------- | ------------------------------------------------------------------------------------------------- |
| **Use Color**          | Off     | Uses each point's received color when enabled. Otherwise, uses the Particle System's Start Color. |
| **Use Size**           | Off     | Uses each point's received size to determine its particle diameter.                               |
| **Minimum Point Size** | `0.02`  | Sets the fixed diameter when Use Size is off, or the minimum diameter when Use Size is on.        |
| **Maximum Points**     | `20000` | Limits the number of displayed particles. Adjustable from `1` to `50000`.                         |

When **Use Size** is enabled, the largest absolute component of the received XYZ size becomes the particle diameter. **Minimum Point Size** keeps smaller points visible.

Particle sizes are expressed in Unity scene units.

#### Change the appearance

With **Use Color** disabled, change **Start Color** in the Particle System's **Main** module to choose the cloud's color.

To change the particle material, open the Particle System's **Renderer** module and assign a material in **Material**. Use a URP-compatible particle material that supports particle color when displaying received colors.

<figure><img src="https://1380116828-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc4nPw8BslCHXa7bL2mf8%2Fuploads%2F0z2BaNivY6Ugjdw1Upvj%2FPowerToys_64nBMJASxS.gif?alt=media&amp;token=dac2df74-bac4-4132-89df-0212646f2573" alt=""><figcaption></figcaption></figure>
