# Scattered objects

## Objects

An *object* is a SketchUp group or component that will be scattered thousands of times over [hosts](https://skatter.help.lindale.io/manual/hosts). Each copy of a scattered object is called an *instance*.

To add new objects, click the <img src="https://777932824-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJXK0YXrcDUpbe_Du_o%2F-MkGyk1zfPLyhhp0wLEQ%2F-MkGz2xrqs2NTJcR1KgP%2Fadd_objects.png?alt=media&#x26;token=8d5f7adf-fb79-45c4-b3ee-bf6688a8b1cf" alt="" data-size="original"> icon and pick groups or components in the model. When you're happy with your selection, click anywhere in the Skatter interface to stop picking objects.

![](https://777932824-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJXK0YXrcDUpbe_Du_o%2F-MkC3TkHbsmQ0Z98TfiZ%2F-MkCub6V4dsWI-xg9FLn%2Fpick_objects.gif?alt=media\&token=bf2b9fe6-048f-4300-942e-6a082d4988b7)

Another way to pick several objects is to first select them in SketchUp and then click the <img src="https://777932824-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJXK0YXrcDUpbe_Du_o%2F-MkGyk1zfPLyhhp0wLEQ%2F-MkGz2xrqs2NTJcR1KgP%2Fadd_objects.png?alt=media&#x26;token=8d5f7adf-fb79-45c4-b3ee-bf6688a8b1cf" alt="" data-size="original"> icon while pressing the Shift key.

![](https://777932824-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJXK0YXrcDUpbe_Du_o%2F-MkGw7pWnsm3FiQ0QZ3e%2F-MkGy5cpzA3GmuOiGz0H%2Fpick_selected_objects.gif?alt=media\&token=757cbcd0-b031-497a-a38f-30e8f181d995)

| Parameter        | Description                                                        |
| ---------------- | ------------------------------------------------------------------ |
| Probability      | Relative probability of the object to be assigned                  |
| Insertion point  | Local origin of the picked object                                  |
| Scale multiplier | Adjusts the size of the instance with respect to the picked object |

### Probability

By default, objects have a probability of 100% so a composition contains an equal quantity of each object's instances.

Probabilities are relative. For example, if object A has probability `300%` and object B has probability `100%` then object A is 3 times more likely to appear.

### Insertion point

The `Insertion point` parameter adjusts the final position of instances depending on its object's internal axes.

| Insertion point | Description                                                                                                                                                                                                             |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Origin          | Simply places instances using the axes of their group/component.                                                                                                                                                        |
| Center          | <p>Uses the center of the actual geometry contained in the object.</p><p></p><p>This is particularly useful when a group/component has off-center axes but we want to ignore this offset when scattering instances.</p> |
| Bottom center   | <p>Same as <code>Center</code> but at the bottom of the group/component.</p><p></p><p>This is particularly useful for objects like trees or street lights.</p>                                                          |

### LODs

LODs (*Level of Detail*) are placeholder objects that replace the main object depending on their distance to the camera.

They are typically used to replace a detailed object with variants with lower and lower resolutions as they get farther away from the camera, which enhances performance in the viewport and when rendering.

![](https://777932824-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJXK0YXrcDUpbe_Du_o%2F-MkGw7pWnsm3FiQ0QZ3e%2F-MkGyhB8zg_KnCwz1FgC%2Flod.svg?alt=media\&token=ad47b5a6-cb60-4329-89cd-7c5cc4f01d83)

{% hint style="warning" %}
LODs are dependent on their position relative to a user-defined [camera](https://skatter.help.lindale.io/filters#camera-filter). Please make sure that this camera is properly set up.
{% endhint %}

## Object groups

It's possible to create *object groups* in order to keep closely related objects together.

Object groups become particularly powerful when used for [zoning](https://skatter.help.lindale.io/distribution#zones), as they make it possible to create zones that contain mixed bags of objects, as well as empty zones.

To create a new object group, click the ![](https://777932824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXK0YXrcDUpbe_Du_o%2Fuploads%2FYnhVRULkTdFTPJeDTslm%2Ffolder-plus.svg?alt=media\&token=4a5e1f15-a1ed-45d0-8ca8-ccd8c83c35c6) icon. You can then drag existing objects into that new group. To move an object out of a group, drag it to the drop zone at the top of the interface.

![](https://777932824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXK0YXrcDUpbe_Du_o%2Fuploads%2F7Dbic54nZ5m7nhPkQ3pp%2Fgroup1.gif?alt=media\&token=c8e1e956-8ccc-45e7-b6f6-be248e9dbfa9)

### Probability

Object groups have their own probability. When [zones](https://skatter.help.lindale.io/distribution#zones) are enabled, the probability of object groups (as well as the probability of *standalone objects* that are not part of a group) controls the number of zones associated with that group (respectively, with that standalone object).

The probability of objects inside an object group controls the number of instances of that specific object in that group.

![](https://777932824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXK0YXrcDUpbe_Du_o%2Fuploads%2FqDrLNzhPiWvAcRk2RqwT%2Fgroup3.gif?alt=media\&token=29f2aaef-4cd2-4269-9241-1709a283417d)

{% hint style="info" %}
When zones are disabled, the probability of a group is still taken into account. This can be useful to fine-tune the chance of each object appearing in your composition.

For instance, you can organize all your flower objects in a *Flowers* group and then set each flower's probability independently from the other object types.
{% endhint %}
