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

# VFX Pass Generator

**VFX Pass Generator** uses our foundation model, [SwitchLight 3.0](https://beeble.ai/research/switchlight-3-0-is-here), to convert your footage into VFX-ready assets by generating:

* **PBR Maps:** Normal, Base color, Metallic, Roughness, Specular for relighting
* **Alpha:** foreground matte for background replacement
* **Depth Map:** For compositing and 3D integration

Your image or video becomes a **rotoscoped, relightable 2.5D asset**, ready for use in 3D Relight, Blender, Unreal or other 3D tools for further VFX work.

***

## Key Features

<CardGroup cols={2}>
  <Card title="PBR, Alpha & Depth Pass Generation" icon="wand-magic-sparkles">
    Powered by **SwitchLight 3.0**. Convert footage into full PBR passes with alpha and depth maps.
  </Card>

  <Card title="2K Resolution, up to 1-minute" icon="video">
    Process up to 2K resolution and one-minute videos or 2,000-frame sequences on cloud.
  </Card>

  <Card title="Image Sequence Support" icon="images">
    Upload image sequence for professional workflow. Export VFX passes as image sequence.
  </Card>

  <Card title="Nuke, Blender & Unreal Engine Plugin" icon="cube">
    Direct integration plugins for seamless VFX pass import into Nuke, Blender, and Unreal Engine workflows.
  </Card>
</CardGroup>

***

## Available VFX Passes

| Pass           | Description                                   |
| -------------- | --------------------------------------------- |
| **Alpha**      | Clean background removal and matte extraction |
| **Depth**      | Normalized depth map for compositing          |
| **Normal**     | Surface normal map for realistic relighting   |
| **Base Color** | Diffuse color without lighting information    |
| **Roughness**  | Surface roughness for material properties     |
| **Specular**   | Specular highlights and reflections           |
| **Metallic**   | Metallic surface properties                   |

***

## Specifications

<Note>
  These specifications are for **Beeble (Cloud)**. For higher resolution and
  longer duration, see [Beeble Studio (Desktop)](/beeble-studio/vfx-pass-generator).
</Note>

### Upload Format

<Tabs>
  <Tab title="Image Sequence">
    <div className="narrow-table">
      |                 | Beeble (Cloud app)                                                                          |
      | --------------- | ------------------------------------------------------------------------------------------- |
      | **File Format** | PNG, JPG, JPEG                                                                              |
      | **Max Size**    | 100 MB per file                                                                             |
      | **Resolution**  | <span style={{fontWeight: '700'}}>Up to 2K (2048 px)</span><br />*- Rejected if larger*     |
      | **Max Frames**  | <span style={{fontWeight: '700'}}>Up to 2000 frames</span>                                  |
      | **Color**       | sRGB for best quality<br />*- Other color spaces, such as Log, may degrade quality*         |
      | **Alpha**       | If alpha is provided (e.g. RGBA PNG), the uploaded alpha will be used as the final VFX Pass |
    </div>
  </Tab>

  <Tab title="Image">
    <div className="narrow-table">
      |                 | Beeble (Cloud app)                                                                          |
      | --------------- | ------------------------------------------------------------------------------------------- |
      | **File Format** | PNG, JPG, JPEG                                                                              |
      | **Max Size**    | 100 MB                                                                                      |
      | **Resolution**  | <span style={{fontWeight: '700'}}>Up to 2K (2048 px)</span><br />*- Downscaled if larger*   |
      | **Color**       | sRGB for best quality<br />*- Other color spaces, such as Log, may degrade quality*         |
      | **Alpha**       | If alpha is provided (e.g. RGBA PNG), the uploaded alpha will be used as the final VFX Pass |
    </div>
  </Tab>

  <Tab title="Video">
    <div className="narrow-table">
      |                 | Beeble (Cloud app)                                                                             |
      | --------------- | ---------------------------------------------------------------------------------------------- |
      | **File Format** | MP4 (H.264), MOV (ProRes 422, 4444, H.265)                                                     |
      | **Max Size**    | 2 GB                                                                                           |
      | **Resolution**  | <span style={{fontWeight: '700'}}>Up to 2K (2048 px)</span><br />*- Downscaled if larger*      |
      | **Duration**    | <span style={{fontWeight: '700'}}>Up to 60 seconds</span>                                      |
      | **FPS**         | <span style={{fontWeight: '700'}}>Up to 30 FPS</span><br />*- Reduced if higher*               |
      | **Color**       | Rec. 709 for best quality<br />*- Other color spaces, such as Log, may degrade quality*        |
      | **Alpha**       | If alpha is provided (e.g. ProRes 4444), the uploaded alpha will be used as the final VFX Pass |
    </div>
  </Tab>
</Tabs>

<Tip>
  **Best Quality Settings** - Use Rec. 709 / sRGB color space. Beeble (Cloud
  app) supports up to 2K and 60 seconds.
</Tip>

### Output Format

Beeble Cloud provides two output formats:

* **PNG**: 8-bit PNG sequences for each VFX pass.
* **MP4**: 8-bit MP4 files for each VFX pass.

<Note>
  **EXR export** is only available in [Beeble Studio
  (Desktop)](/beeble-studio/vfx-pass-generator).
</Note>

<Tabs>
  <Tab title="PNG">
    <div className="narrow-table">
      | Map           | Color Channels   | Bit Depth    | Color Space | Note                             |
      | ------------- | ---------------- | ------------ | ----------- | -------------------------------- |
      | **Source**    | RGB (3-ch)       | 8-bit        | sRGB        |                                  |
      | **Alpha**     | Grayscale (1-ch) | 8-bit        | —           | 0.0–1.0 matte                    |
      | **Normal**    | RGB (3-ch)       | 8-bit        | —           | Object space / OpenGL normal map |
      | **BaseColor** | RGB (3-ch)       | 8-bit        | sRGB        |                                  |
      | **Roughness** | Grayscale (1-ch) | 8-bit        | —           | White = Rough surface            |
      | **Specular**  | Grayscale (1-ch) | 8-bit        | —           |                                  |
      | **Metallic**  | Grayscale (1-ch) | 8-bit        | —           | White = Metallic surface         |
      | **Depth**     | Grayscale (1-ch) | 16-bit float | —           | **Saved as .exr** for precision  |
    </div>
  </Tab>

  <Tab title="MP4">
    <div className="narrow-table">
      | Map           | Color Channels   | Bit Depth | Color Space | Note                                                   |
      | ------------- | ---------------- | --------- | ----------- | ------------------------------------------------------ |
      | **Source**    | RGB (3-ch)       | 8-bit     | sRGB        |                                                        |
      | **Alpha**     | Grayscale (1-ch) | 8-bit     | —           | 0.0–1.0 matte                                          |
      | **Normal**    | RGB (3-ch)       | 8-bit     | —           | Object space / OpenGL normal map                       |
      | **BaseColor** | RGB (3-ch)       | 8-bit     | sRGB        |                                                        |
      | **Roughness** | Grayscale (1-ch) | 8-bit     | —           | White = Rough surface                                  |
      | **Specular**  | Grayscale (1-ch) | 8-bit     | —           |                                                        |
      | **Metallic**  | Grayscale (1-ch) | 8-bit     | —           | White = Metallic surface                               |
      | **Depth**     | Grayscale (1-ch) | 8-bit     | —           | Normalize depth to \[0, 1] within the foreground range |
    </div>
  </Tab>
</Tabs>

***

## Good vs. Bad Footage

Even though our AI models generate VFX passes from your footage—like depth, normals, or lighting layers—we don't "invent" details. The **quality of the output depends entirely on the input**. Make sure your footage contains enough visual detail by following these examples.

### ✅ Good Footage

![Good footage example](https://cdn.beeble.ai/docs/good-footage.avif)

**Footage should be ready for compositing** with:

* **Includes clear subjects** – such as people or objects
* **Strong separation** between subject and background
* **High-quality** – sharp focus, high bitrate, and detailed visuals
* **Soft, even lighting** – avoid harsh shadows or blown highlights
* **Correct white balance and proper exposure**

### ❌ Bad Footage

![Bad footage example](https://cdn.beeble.ai/docs/bad-footage.avif)

**Avoid footage** with these problems:

* **No visible subject**, or subject is too small in frame
* **Grayscale footage** – color is required
* **Non-sRGB/Rec.709 color space** – make sure your footage uses standard sRGB or Rec.709
* **Poor quality** – low bitrate, blurry, noisy, or out of focus
* **Improper exposure** – overexposed, underexposed, or extreme contrast
* **Too much camera movement** – shaky or unstable footage is hard to work with