> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lightcraft.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Locations

> Add, replace and adjust the world a 3D scene takes place in.

A location is usually a Gaussian splat scan. Each 3D scene holds one location, and every setup in it shares that location.

![The scene editor with the Opulent Hall location selected. Box 1 is on Replace location on the Locations row, 2 on the Opulent Hall row with its eye and trash, and 3 on Location Properties.](https://mintcdn.com/lightcraft/pm0on6iM7wuwWTJD/images/spark/scene-editor/locations-overview.jpg?fit=max\&auto=format\&n=pm0on6iM7wuwWTJD\&q=85\&s=61ce4b87867a484cf06ad75e52ada531)

1. **Replace location**
2. Location row: eye, trash
3. **Location Properties**

## Add a location

### 1. Open the location library

In the Outliner, click **+** on the **Locations** row.

![The Outliner of an empty 3D scene, with a box on the plus button of the Locations row.](https://mintcdn.com/lightcraft/pm0on6iM7wuwWTJD/images/spark/scene-editor/add-location.jpg?fit=max\&auto=format\&n=pm0on6iM7wuwWTJD\&q=85\&s=751ff66d3d331963b9fbb1046a56f21c)

### 2. Add a location

Hover a location, then click **Add to Scene**. A default location you haven't used yet says **Import & Add**. To use your own file, click **Add to Library** first. See [Location Settings](#location-settings).

![The location library. The pointer is on the Opulent Hall card, with a box on its Import and Add button.](https://mintcdn.com/lightcraft/pm0on6iM7wuwWTJD/images/spark/scene-editor/add-location-card.jpg?fit=max\&auto=format\&n=pm0on6iM7wuwWTJD\&q=85\&s=38d6bf671d8ec47bcbd7b947c97cc115)

### 3. Wait for it to load

The location's row shows in the Outliner within seconds. The splat itself can take about 30 seconds to render.

## Replace a location

Once a scene has a location, the **+** on the **Locations** row becomes **Replace location** (↻). Click it, pick another location, then click **Replace** to confirm.

![The Replace Location window: This will overwrite Opulent Hall with P5 test room, with Cancel and a box on Replace.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scene-editor/replace-location.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=925b65cbab86ff15eabd4d7fb23eb73b)

> [!NOTE]
>
> The camera preview can keep showing the old location for a minute or more. The 3D canvas shows the new one.

## Location Settings

**Location Settings** opens when you upload a location with **Add to Library**. It takes a splat or a USD set: `.ply`, `.splat`, `.spz`, `.usd`, `.usdc`, `.usda` or `.usdz`.

![The Location Settings window for an uploaded splat. Box 1 is on the Preview, 2 on Subcategory, 3 on Invert Up and Z-Up, and 4 on Add to Library.](https://mintcdn.com/lightcraft/pm0on6iM7wuwWTJD/images/spark/scene-editor/location-settings.png?fit=max\&auto=format\&n=pm0on6iM7wuwWTJD\&q=85\&s=5795ee4a9b7df6b41880cd2eeb9db12f)

1. **Preview**
2. **Subcategory**
3. **Invert Up** and **Z-Up**
4. **Add to Library**

* In the **Preview**, drag to look around, and use **W**, **A**, **S**, **D**, **Q** and **E** to move.
* **Subcategory** is required: **Interior** or **Exterior**.
* Tick **Invert Up (Flip 180°)** or **Z-Up (Blender/3ds Max)** if the location loads upside down or on its side.

Step 3 of the window sets the scale. Add the human figure to check that the world is the right size. If you leave the scale as it is, Spark asks **Scale hasn't been adjusted. Are you sure it's right?**

## Fix orientation or scale

Select the location, then change **Position**, **Rotation** or **Scale** under **Transformation** in **Location Properties**. **Scale** has a lock beside it.

![Location Properties with a box on Position, Rotation and Scale, the scale showing 2.05 and a lock.](https://mintcdn.com/lightcraft/pm0on6iM7wuwWTJD/images/spark/scene-editor/location-transformation.png?fit=max\&auto=format\&n=pm0on6iM7wuwWTJD\&q=85\&s=abad583059a520252090fd30ec9bb105)

## Set the render quality

The **Rendering** panel sets how splats are drawn. Open it in one of two ways:

* Click **Settings** (the gear) in the canvas toolbar, then **Rendering…**.
* Select a splat location, then click **Render quality settings** under **Rendering** in its properties.

The panel opens under the toolbar, and you can keep working in the scene. To close it, click **X** or press **Esc**.

![The Rendering panel with Medium chosen. Box 1 is on the presets Low, Medium, High and Custom, 2 on Opacity cutoff, 3 on Level of detail with Splats drawn, and 4 on Antialiasing.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scene-editor/rendering-panel.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=a2c6bd427877d37eb92b6e072255f01e)

1. Presets
2. **Opacity cutoff**
3. **Level of detail**, **Splats drawn**
4. **Antialiasing**

* Under **Opacity cutoff**, a line gives the share of the scene's splats this setting hides. It turns amber above the **Low** preset's value.
* Under **Splats drawn**, Spark shows the scene's splat count. With **Level of detail** on, it also says how many of those it draws.

A preset sets every value at once. **Medium** is the default.

| Setting | Low | Medium | High |
| - | - | - | - |
| **Opacity cutoff** | 20% | 12% | 3.9% |
| **Splat extent** | 1.00 | 1.50 | 2.50 |
| **Max splat size** | 16 px | 32 px | 128 px |

Every preset sets **Render resolution** to 2×, with **Level of detail** and **Antialiasing** off.

Move any slider or switch, and the preset becomes **Custom**. Your choice stays after a reload, and applies to every scene on this device. Exports and upload thumbnails always use the **High** values.

| Setting | What it does |
| - | - |
| **Opacity cutoff** | Splats fainter than this aren't drawn. Too high, and clouds, haze and glass disappear. |
| **Splat extent** | How far each splat's soft edge reaches. |
| **Max splat size** | The largest one splat can get on screen. Too low leaves holes in near surfaces, such as foliage. |
| **Render resolution** | The highest pixel ratio the canvas renders at. It never goes above your screen's own. |
| **Level of detail** | On, Spark draws a lighter version of large locations. Off, it draws every splat the other settings allow. |
| **Splats drawn** | The most splats **Level of detail** draws each frame, across all locations. Spark draws fewer when the view already has enough detail. |
| **Antialiasing** | Smooths the edges of models and the grid. Splats look the same either way, but large splat scenes get much slower. |

A change to **Antialiasing** takes effect after a reload. The panel shows **Takes effect after a reload.** Click **Reload now** to reload the page.

## Hide a location

Hover the location's row, then click the eye. The location disappears from the 3D canvas and the camera preview, and the row turns dim.

![The Outliner with a box on the dim Opulent Hall row and its crossed-out eye. The canvas behind shows no location.](https://mintcdn.com/lightcraft/pm0on6iM7wuwWTJD/images/spark/scene-editor/location-hidden.jpg?fit=max\&auto=format\&n=pm0on6iM7wuwWTJD\&q=85\&s=64fae76c7ce784baf1591dc59cffcbec)

To take the location out of the scene, click **Remove from Scene** in **Location Properties**.

## Related

> [card] [Asset Library](https://docs.lightcraft.pro/spark/scene-editor/asset-library.md)
>
> Upload your own locations.

> [card] [Move around a scene](https://docs.lightcraft.pro/spark/scene-editor/move-around-a-scene.md)
>
> See the floor plan with Top-Down View.

> [card] [Bring in an Unreal scene](https://docs.lightcraft.pro/spark/scene-editor/importing-unreal-scenes.md)
>
> Make a location from Unreal Engine.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.