<< Click to Display Table of Contents >> Navigation:  Nodes > Tasks > Render Engines > ARRI Reference Tool

 

Purpose

 

Integrates the ARRI Reference Tool (art-cmd) command-line application into a Mistika Workflow. It supports four operation modes: Process, Trim, Verify and Export. It allows configuring the target colour space, video codec, output resolution and optional image processing such as deflip, desqueeze and ARRI look application.

 

The ARRI Reference Tool (art-cmd) must be installed separately on the system before using this node. The binary path can be configured in the Config section.

 

Inputs

 

input: ARRI camera files to be processed.

 

Outputs

 

output: Files generated by the ARRI Reference Tool after processing.

 

Standard properties

Object Name

Color

Bypass

Lock

Name Convention

Code

 

Node specific properties

 

Mode: Selects the operation mode of the ARRI Reference Tool. Available options are:

• process — Transcodes and applies image processing to the input files.

• trim — Creates a trimmed copy of the input files between the specified start frame and duration.

• verify — Validates the integrity of the input files and optionally exports metadata, video or audio.

• export — Exports properties to a JSON CLI file for use with external tools.

 

Output: Destination folder or file path for the processed output. Supports Name Convention tokens and drag-and-drop from the file system.

 

JSON CLI: Optional path to a .json file containing a pre-built art-cmd job definition (with input, recipe and output keys). When a JSON CLI file is provided, the individual processing parameters below are ignored and the job definition in the file is used instead.

 

Process

 

XSD Params: Optional path to an .xsd XML file with additional decoding parameters for the ARRI Reference Tool.

 

Deflip: When enabled, applies the deflip correction to the input footage.

 

Desqueeze: When enabled, applies anamorphic desqueeze to the input footage.

 

Embedded Look: When enabled, applies the ARRI look embedded in the camera file.

 

ARRI Look File: Optional path to an external ARRI look file (.aml, .alf4 or .alf4c) to apply to the output.

 

Target Colorspace: Output colour space for the transcoded files. The list is populated dynamically from the installed version of the ARRI Reference Tool. Set to Auto to let the tool decide.

 

Video Codec: Output codec for the transcoded files. The list is populated dynamically from the installed version of the ARRI Reference Tool. Set to Auto to let the tool decide.

 

Resolution: Output resolution. Select a named resolution from the list, Same As Input to preserve the source resolution, or Custom to enter specific pixel dimensions in the Image Res X and Image Res Y fields that appear when this option is selected.

 

Trim

 

Start: Starting point for the trim. Set to auto to begin from the first frame of the clip, or select a fixed value to enter a specific frame number in the Start Value field.

 

Duration: Number of frames to include from the start point. Set to auto to include the entire clip, or select a fixed value to enter a specific number of frames in the Duration Value field.

 

Verify

 

Skip Metadata: When enabled, metadata verification and export are skipped.

 

Skip Video: When enabled, video verification and export are skipped.

 

Skip Audio: When enabled, audio verification and export are skipped.

 

Export

 

Export JSON CLI: When enabled, exports a JSON file containing the art-cmd job definition (mode, input, output and recipe) for use with external tools or for debugging. The destination path is set in the JSON Output field.

 

JSON Output: Destination path and file name for the exported JSON CLI file. Must have a .json extension. Visible only when Export JSON CLI is enabled.

 

Config

 

Bin Path: Full path to the art-cmd executable. Default paths are C:/Program Files/Arri_CMD/bin/art-cmd.exe on Windows and /usr/Arri_CMD/bin/art-cmd on Linux/macOS. Supports drag-and-drop from the file system.

 

Render Platform: Hardware platform used for rendering. Options are Auto, CPU, CUDA, Metal and OpenCL.

 

Render Device: Specific rendering device within the selected platform. The list is populated dynamically by querying the installed ARRI Reference Tool.

 

Threads: Number of parallel execution threads. Available options are 1, 2, 4 and 8.

 

NOTE: The node reads the available colour spaces, codecs and render devices directly from the installed art-cmd binary. If these lists appear empty, verify that the Bin Path is correct and that the ARRI Reference Tool is properly installed. For troubleshooting, check the Render Log panel after running the workflow.

 

Developer reference (Python - ArriReferenceTool.[Property ID], API Rest - node/ArriReferenceTool/property/[Property ID])