Singlecam Takes and Jobs

A singlecam take is a take that defines a recording session with only a single camera. A single take can be associated with a video file and optional additional files. Currently, we plan on supporting the following additional file types:

• DEPTH
• INTRINSIC
• ODOMETRY
• VISION

To create mocap output for a singlecam take you must first create a take.

Creating files

See here for how to create files

Creating a singlecam take

First, create the singlecam take using the file ids that you have created and uploaded

mutation CreateSingleCamTake {
    take: createSingleCamTake(
        sources: [{
            deviceLabel:"human-readable-device-label",
            fileId: "file-2be2463e-ffa3-419b-beb4-ea0f99c79592",  // (1)
            format:MP4
        },
        {
            // This file is optional - a singlecam take will work with only a video input
            deviceLabel:"human-readable-device-label",
            fileId:"file-2f6e07be-19b1-49e8-b136-513be3f66560",  // (2)
            format:DEPTH
        }]
    ) {
        id
    }
}

1. This is the original video file id. This is typically the RGB video file to be used for the take.
2. This is the file id for the (optional) additional file.

Processing a singlecam take

This will return a take ID which you can process any time you want by using our singlecam jobs interface.

Processing with default outputs

Unless specified, Singlecam runs will generate the following default output files: render_video, main_fbx, main_usdc, main_usdz, main_blend, motion_data and render_overlay_video.

mutation ProcessTake {
    job: createSingleCamJob(takeId: <take.id>) {
        id
        status
    }
}

Processing with specific outputs

You can also specify the outputs you want to generate by passing the outputs parameter. You can find the list of available outputs here.

mutation ProcessTake {
    job: createSingleCamJob(takeId: <take.id>, outputs: [RENDER_VIDEO, MAIN_FBX]) {
        id
        status
    }
}