Singlecam Takes and Jobs

A singlecam take is a take that defines a recording session with only a single camera.

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
        }]
    ) {
        id
    }
}

1. This is the original video file id. This is typically the RGB video file to be used for the take.

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
    }
}

Check status of job

You can check the status of the job using the getJob query. See here for all available attributes.

The output files will return a "not found" error message if the job is not completed.

{
    getJob(jobId: "job-6da06f7b-6145-4a7a-beb7-13adc27454ab") { // (1)
        id
        name
        progress {
            state
            percentageComplete
        }
        inputs {
            options {
                mocapModel
                trackBall
                trackFingers
            }
            numberOfActors
        }
        outputs {
            key
            file{
                id
                presignedUrl
                created
            }
        }
    }
}

1. This is the job ID returned from the createSingleCamJob mutation.