Generators

Generator module to be used by Processors and Renderers.

class lablib.generators.OCIOConfigFileGenerator(context, family=None, operators=None, config_path=None, working_space=None, views=None, description=None, staging_dir=None, environment_variables=None)

Class for generating and manipulating OCIO Config files.

context

The context of the OCIO Config file.

Type:

str

config_path

The path to the OCIO Config file.

Type:

Optional[str]

family

The family of the OCIO Config file.

Type:

Optional[str]

operators

A list of OCIO Transform objects.

Type:

Optional[List[OCIO.Transform]]

working_space

The working space of the OCIO Config file.

Type:

Optional[str]

views

A list of views.

Type:

Optional[List[str]]

description

The description of the OCIO Config file.

Type:

Optional[str]

staging_dir

The staging directory of the OCIO Config file.

Type:

Optional[str]

environment_variables

A dictionary of environment variables.

Type:

Optional[Dict]

Example

>>> from lablib.operators import LUT
>>> from lablib.generators import OCIOConfigFileGenerator
>>> lut = LUT(src="src", dst="dst")
>>> ocio = OCIOConfigFileGenerator(
...     context="context",
...     config_path="config.ocio",
...     operators=[lut],
...     working_space="working_space",
...     views=["view1", "view"],
...     description="description",
...     staging_dir="staging_dir",
...     environment_variables={"key": "value"},
... )
>>> ocio.create_config()
'<staging_dir_path>/config.ocio'

Raises:

• ValueError – If config_path is not set and the OCIO environment variable is not set.

• FileNotFoundError – If the OCIO Config file is not found.

append_operators(*args)

Append operators.

Parameters:

*args – A list of lablib.operators objects.

append_vars(**kwargs)

Append environment variables.

Parameters:

**kwargs – A key/value map of environment variables.

append_views(*args)

Append views.

Parameters:

*args – A list of views.

clear_operators()

Clear the operators.

clear_vars()

Clear the environment variables.

clear_views()

Clear the views.

create_config(dest=None)

Create an OCIO Config file.

Parameters:

dest (str) – The destination path to write the OCIO Config file.

Returns:

The destination path to the OCIO Config file.

Return type:

str

get_config_path()

Return the path to the OCIO Config file.

Returns:

The path to the OCIO Config file.

Return type:

str

get_description_from_config()

Return the description from the OCIO Config file.

Returns:

The description text.

Return type:

str

get_oiiotool_cmd()

Return arguments for the oiiotool command.

Returns:

The arguments for the oiiotool command.

Return type:

List

load_config_from_file(filepath)

Load an OCIO Config file from a file.

Parameters:

filepath (str) – The path to the OCIO Config file.

process_config()

Process the OCIO Config file.

This will add the environment variables, description, group transform, color space transform, color space, look, display view, active views, and validate the OCIO Config object.

set_ocio_config_name(name)

Set the name of the OCIO Config file.

Parameters:

name (str) – The name of the OCIO Config file.

set_operators(*args)

Set operators.

Attention

This will clear any existing operators.

Parameters:

*args – A list of lablib.operators objects.

set_vars(**kwargs)

Set the environment variables for the OCIO Config file.

Attention

This will clear any existing environment variables.

Parameters:

**kwargs – A key/value map of environment variables.

set_views(*args)

Set the views for the OCIO Config file.

Attention

This will clear any existing views.

Parameters:

*args – A list of views.

write_config(dest=None)

Write the OCIO Config object to file.

Parameters:

dest (str) – The destination path to write the OCIO Config file.

class lablib.generators.SlateHtmlGenerator(data=<factory>, width=1920, height=1080, staging_dir=None, slate_template_path=None, source_files=<factory>, is_source_linear=True)

Class to generate a slate from a template.

Attention

This class is functional but not yet tested.

Todo

• refactor into a plain python class

• add tests

data

A dictionary containing the data to be formatted in the template.

Type:

Dict

width

The width of the slate.

Type:

int

height

The height of the slate.

Type:

int

staging_dir

The directory where the slate will be staged.

Type:

str

slate_template_path

The path to the template.

Type:

str

source_files

A list of source files.

Type:

List

is_source_linear

A boolean to set whether the source files are linear.

Type:

bool