> ## 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.

# Composite and record

> Composite a performer into a 3D scene, record a take, then render it.

The app composites a real performer into your 3D scene live, with or without a green screen. Each take keeps its layers separate for the Gallery and the Editor.

[Video walkthrough](https://player.vimeo.com/video/1221837068)

## Turn on compositing and key a performer

Tap **Off** at the top. The **CAMERA/KEY** menu opens.

![The camera button, in box 1, with its CAMERA/KEY menu open in box 2: Person, Chroma, Depth and Off.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/spark-ios/key-menu.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=64d684177dafe1616e75763af5db4131)

1. Camera button
2. **CAMERA/KEY**

* **Person**: AI segmentation mattes the performer into the 3D scene, with no green screen
* **Chroma**: keys out a green or blue screen, and gives a cleaner key than segmentation
* **Off**: records the 3D scene with no camera

With **Chroma**, tap **Pick color**, then tap the screen.

![Chroma on, with the message Tap the green or blue screen to set the key color. Box 1 is on Pick color, 2 on Match floor with a tick and 3 on Find Screen.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/spark-ios/chroma-row.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=897ef01bba2a0436cec7d8ef89d93fd1)

1. **Pick color**
2. **Match floor**
3. **Find Screen**

* **Find Screen** finds the edges of a small screen, and the 3D scene fills everything outside it.
* **Clip black** and **Clip white** in **Tools** fine-tune the key.

## Views and switches

Tap **Tools** to switch views and set what shows on screen.

![Person on with Tools open. Box 1 is on Match floor, 2 on Align, 3 on Tools, 4 on the Comp, Cam, Depth and Matte tabs, and 5 on the three switches.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/spark-ios/person-tools.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=3a085ad7f8c5cd2b7dcc9452d2b9b239)

1. **Match floor**
2. **Align**
3. **Tools**
4. Views
5. Switches

| View | Shows |
| - | - |
| **Comp** | The performer keyed over the 3D scene |
| **Cam** | The raw camera feed |
| **Depth** | Per-frame depth map |
| **Matte** | The matte used for the key |

| Switch | Does |
| - | - |
| **Show Virtual World** | Off shows the full camera view, and the floor grid stays |
| **Floor grid** | Shows the grid on screen. It's never recorded |
| **Match Floor uses splat** | Off assumes the scene's floor is at height 0 |

## Place a performer

Point the camera at the real floor and tap **Match floor**. It measures the distance and sets your height, then shows a tick. It can't run while you're locked to a camera.

Tap **Align** to seat the performer in the scene, such as behind a desk or in a car seat.

## Record a take

1. Pick the setup and camera. See [Camera setups on iPhone](https://docs.lightcraft.pro/spark/spark-ios/setups-and-cameras-on-iphone.md).
2. Tap **Record**. The button shows the time and the take number.
3. Tap it again to stop.

![Recording in P5 stairwell, with a box on the red button reading 00:05, Take 1.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/spark-ios/record.jpg?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=7ac40f1941bb175073b1b07bf207aefb)

Takes number themselves in each setup. A take with the camera off reads **No camera**, and shows **BG ONLY** in the Gallery.

> [!NOTE]
>
> Recording claims the camera, so screen sharing over Zoom or Meet stops until the take ends.

## Render now or later

Tap the clapperboard to open Takes. A new take shows **Render** and **Upload**.

![Takes for Rooftop Test with Take 1 and Take 2. Box 1 is on Render All (2), 2 on Upload All (2), 3 on the Auto-upload video switch and 4 on the layer chips cam, comp, depth, matte and bg.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/spark-ios/takes-render.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=54796b005c37d7b0aa6baffa35d1fa4c)

1. **Render All**
2. **Upload All**
3. **Auto-upload video**
4. Layers

Tap **Render** on one take, or **Render All**. Rendering later saves heat and battery on a fast set. Two takes of about 7 seconds took about a minute on an iPhone 14 Pro Max.

![The Rendering Takes sheet: Take 1 of 2, This take and All takes progress bars, 5 of 164 frames, and Pause.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/spark-ios/render-sheet.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=ee276c928739aab30de44453af967384)

## Record offline, sync later

A take recorded offline saves on the iPhone. It syncs to the web app when the iPhone reconnects.

## Take files on the device

Each take keeps its elements as separate files, sorted by production, then script scene.

| File prefix | Contents |
| - | - |
| `cam_*` | Raw camera footage |
| `comp_*` | The live composite |
| `depth_*` | Per-frame depth map |
| `tracking_*.json` | 3D camera tracking data |
| `meta_*.json` | Take metadata |

> [!WARNING]
>
> Takes stay on the device until they're uploaded. An app update is safe, but deleting the app may not be.

## Related

> [card] [Upload takes from iPhone](https://docs.lightcraft.pro/spark/gallery/spark-desktop.md)
>
> Send takes to the Gallery.

> [card] [Browse and play takes](https://docs.lightcraft.pro/spark/gallery/gallery.md)
>
> See every take in the Gallery.


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