cdl_convert

Project Info

PyPI Version Build Status Coverage

Introduction

cdl_convert converts between common ASC CDL formats. The American Society of Cinematographers Color Decision List (ASC CDL, or CDL for short) is a schema to simplify the process of interchanging color data between various programs and facilities.

The ASC has defined schemas for including the 10 basic numbers in 6 different formats:

  • Avid Log Exchange (ALE)

  • Film Log EDL Exchange (FLEx)

  • CMX EDL

  • XML Color Correction (cc)

  • XML Color Correction Collection (ccc)

  • XML Color Decision List (cdl)

Unofficial Formats:

  • OpenTimelineIO (OTIO) timeline files with embedded CDL metadata

  • Nuke’s OCIOCDLTransform nodes, from The Foundry Nuke

  • Space separated CDL (RCDL), a Rhythm & Hues internal cdl format

cdl_convert converts ASC CDL information between these basic formats to further facilitate the ease of exchange of color data within the Film and TV industries.

cdl_convert supports parsing ALE, FLEx, CC, CCC, CDL, CMX EDL, Nuke (.nk), OTIO, and RCDL. We can write out CC, CCC, CDL, Nuke (.nk), and RCDL.

cdl_convert uses the Academy Software Foundation’s OpenTimelineIO project for reading ALE, CMX, and OTIO files. This dependency was added because OTIO provides robust EDL parsing with much better compatibility.

cdl_convert is not associated with the American Society of Cinematographers

Quick Start

Install via pip:

pip install cdl_convert

Convert a file:

cdl_convert input.flex -o cc

Use the Python API:

import cdl_convert as cdl

# Parse a CDL file
cc = cdl.parse_cc('path/to/file.cc')

# Access values
print(cc.slope, cc.offset, cc.power, cc.sat)

# Write to different format
cdl.write_ccc(cc)

See Script Usage for command-line examples and Color Corrections for Python API usage.

Table of Contents

Indices and tables