> For the complete documentation index, see [llms.txt](https://docs.polygonflow.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.polygonflow.io/dash-tools/volumescatter.md). # Volume Scatter ## Short Description Scatters objects inside a mesh. ## Description The Volume Scatter tool scatters objects inside a specified mesh or volume. It allows users to customize various parameters such as density, scale, and rotation to control the appearance of scattered objects. ## Properties ### Base Properties * **Meshes**: Meshes to use as a volume. * **Scatter**: Objects to scatter inside the volume meshes/curves. * **Density**: Density of your scatter. The higher the value, the more scattered meshes you'll have. * **Randomness**: Randomness of the scatter. The higher the value, the more random the scatter will be. * **Randomness Multiplier**: Multiplier for the randomness of the scatter. The higher the value, the more random the scatter will be. * **Min Scale**: Minimum scale of your scattered meshes. * **Max Scale**: Maximum scale of your scattered meshes. * **Seed**: Randomizes the result of the scatter. ### Rotation Properties * **Override Rotation**: If set to True, the rotation will be overridden by the values below. * **X Override**: Overrides the rotation along the X axis. * **Y Override**: Overrides the rotation along the Y axis. * **Z Override**: Overrides the rotation along the Z axis. * **Random Spin**: This ensures that all instances have a random angle/spin to them, which ensures great rotation variation. * **Uniform Angle**: Adjust the angle/spin of your instances. By default, they all have a random spin. * **X Jitter**: Randomizes the rotation along the X axis. * **Y Jitter**: Randomizes the rotation along the Y axis. * **Z Jitter**: Randomizes the rotation along the Z axis. ### Proximity Mask * **Objects**: You can pass meshes, curves and even instancers to use them as masks. * **Distance**: Distance of the objects' proximity mask. * **Sampling**: A higher value results in more precise proximity masking, but at a heavier cost (especially if your proximity objects are scatter instances). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.polygonflow.io/dash-tools/volumescatter.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.