The File Rules are a set of filepath to color space mappings that are evaluated from first to last. The first rule to match is what determines which color space is returned. There are four types of rules available. Each rule type has a name key that may be used by applications to refer to that rule. Name values must be unique i.e. using a case insensitive comparison. The other keys depend on the rule type: More...

#include <OpenColorIO.h>

Public Member Functions
FileRulesRcPtr	createEditableCopy () const
	The method clones the content decoupling the two instances. More...

size_t	getNumEntries () const noexcept
	Does include default rule. Result will be at least 1. More...

size_t	getIndexForRule (const char *ruleName) const
	Get the index from the rule name. More...

const char *	getName (size_t ruleIndex) const
	Get name of the rule. More...

const char *	getPattern (size_t ruleIndex) const
	Setting pattern will erase regex. More...

void	setPattern (size_t ruleIndex, const char *pattern)

const char *	getExtension (size_t ruleIndex) const
	Setting extension will erase regex. More...

void	setExtension (size_t ruleIndex, const char *extension)

const char *	getRegex (size_t ruleIndex) const
	Setting a regex will erase pattern & extension. More...

void	setRegex (size_t ruleIndex, const char *regex)

const char *	getColorSpace (size_t ruleIndex) const
	Set the rule's color space (may also be a role). More...

void	setColorSpace (size_t ruleIndex, const char *colorSpace)

size_t	getNumCustomKeys (size_t ruleIndex) const
	Get number of key/value pairs. More...

const char *	getCustomKeyName (size_t ruleIndex, size_t key) const
	Get name of key. More...

const char *	getCustomKeyValue (size_t ruleIndex, size_t key) const
	Get value for the key. More...

void	setCustomKey (size_t ruleIndex, const char key, const char value)

void	insertRule (size_t ruleIndex, const char name, const char colorSpace, const char pattern, const char extension)
	Insert a rule at a given ruleIndex. More...

void	insertRule (size_t ruleIndex, const char name, const char colorSpace, const char *regex)

void	insertPathSearchRule (size_t ruleIndex)
	Helper function to insert a rule. More...

void	setDefaultRuleColorSpace (const char *colorSpace)
	Helper function to set the color space for the default rule. More...

void	removeRule (size_t ruleIndex)

void	increaseRulePriority (size_t ruleIndex)
	Move a rule closer to the start of the list by one position. More...

void	decreaseRulePriority (size_t ruleIndex)
	Move a rule closer to the end of the list by one position. More...

bool	isDefault () const noexcept

	FileRules (const FileRules &)=delete

FileRules &	operator= (const FileRules &)=delete

virtual	~FileRules ()
	Do not use (needed only for pybind11). More...

Static Public Member Functions
static FileRulesRcPtr	Create ()

Static Public Attributes
static const char *	DefaultRuleName
	Reserved rule name for the default rule. More...

static const char *	FilePathSearchRuleName
	Reserved rule name for the file path search rule. More...

Friends
class	Config

Detailed Description

The File Rules are a set of filepath to color space mappings that are evaluated from first to last. The first rule to match is what determines which color space is returned. There are four types of rules available. Each rule type has a name key that may be used by applications to refer to that rule. Name values must be unique i.e. using a case insensitive comparison. The other keys depend on the rule type:

Basic Rule: This is the basic rule type that uses Unix glob style pattern matching and is thus very easy to use. It contains the keys:
- name: Name of the rule
- colorspace: Color space name to be returned.
- pattern: Glob pattern to be used for the main part of the name/path.
- extension: Glob pattern to be used for the file extension. Note that if glob tokens are not used, the extension will be used in a non-case-sensitive way by default.
Regex Rule: This is similar to the basic rule but allows additional capabilities for power-users. It contains the keys:
- name: Name of the rule
- colorspace: Color space name to be returned.
- regex: Regular expression to be evaluated.
OCIO v1 style Rule: This rule allows the use of the OCIO v1 style, where the string is searched for color space names from the config. This rule may occur 0 or 1 times in the list. The position in the list prioritizes it with respect to the other rules. StrictParsing is not used. If no color space is found in the path, the rule will not match and the next rule will be considered. see insertPathSearchRule. It has the key:
- name: Must be "ColorSpaceNamePathSearch".
Default Rule: The file_rules must always end with this rule. If no prior rules match, this rule specifies the color space applications will use. see setDefaultRuleColorSpace. It has the keys:
- name: must be "Default".
- colorspace : Color space name to be returned.

Custom string keys and associated string values may be used to convey app or workflow-specific information, e.g. whether the color space should be left as is or converted into a working space.

Getters and setters are using the rule position, they will throw if the position is not valid. If the rule at the specified position does not implement the requested property getter will return NULL and setter will throw.

When loading a v1 config, a set of FileRules are created with ColorSpaceNamePathSearch followed by the Default rule pointing to the default role. This allows getColorSpaceFromFilepath to emulate OCIO v1 code that used parseColorSpaceFromString with strictparsing set to false.

Definition at line 1454 of file OpenColorIO.h.

Constructor & Destructor Documentation

OCIO_NAMESPACE::FileRules::FileRules ( const FileRules & )

delete

virtual OCIO_NAMESPACE::FileRules::~FileRules ( )

virtual

Do not use (needed only for pybind11).

Member Function Documentation

static FileRulesRcPtr OCIO_NAMESPACE::FileRules::Create ( )

static

Creates FileRules for a Config. File rules will contain the default rule using the default role. The default rule cannot be removed.

FileRulesRcPtr OCIO_NAMESPACE::FileRules::createEditableCopy ( ) const

The method clones the content decoupling the two instances.

void OCIO_NAMESPACE::FileRules::decreaseRulePriority ( size_t ruleIndex )

Move a rule closer to the end of the list by one position.

const char* OCIO_NAMESPACE::FileRules::getColorSpace ( size_t ruleIndex ) const

Set the rule's color space (may also be a role).

const char* OCIO_NAMESPACE::FileRules::getCustomKeyName	(	size_t	ruleIndex,
		size_t	key
	)		const

Get name of key.

const char* OCIO_NAMESPACE::FileRules::getCustomKeyValue	(	size_t	ruleIndex,
		size_t	key
	)		const

Get value for the key.

const char* OCIO_NAMESPACE::FileRules::getExtension ( size_t ruleIndex ) const

Setting extension will erase regex.

size_t OCIO_NAMESPACE::FileRules::getIndexForRule ( const char * ruleName ) const

Get the index from the rule name.

const char* OCIO_NAMESPACE::FileRules::getName ( size_t ruleIndex ) const

Get name of the rule.

size_t OCIO_NAMESPACE::FileRules::getNumCustomKeys ( size_t ruleIndex ) const

Get number of key/value pairs.

size_t OCIO_NAMESPACE::FileRules::getNumEntries ( ) const

noexcept

Does include default rule. Result will be at least 1.

const char* OCIO_NAMESPACE::FileRules::getPattern ( size_t ruleIndex ) const

Setting pattern will erase regex.

const char* OCIO_NAMESPACE::FileRules::getRegex ( size_t ruleIndex ) const

Setting a regex will erase pattern & extension.

void OCIO_NAMESPACE::FileRules::increaseRulePriority ( size_t ruleIndex )

Move a rule closer to the start of the list by one position.

void OCIO_NAMESPACE::FileRules::insertPathSearchRule ( size_t ruleIndex )

Helper function to insert a rule.

Uses Config:parseColorSpaceFromString to search the path for any of the color spaces named in the config (as per OCIO v1).

void OCIO_NAMESPACE::FileRules::insertRule	(	size_t	ruleIndex,
		const char *	name,
		const char *	colorSpace,
		const char *	pattern,
		const char *	extension
	)

Insert a rule at a given ruleIndex.

Rule currently at ruleIndex will be pushed to index: ruleIndex + 1. Name must be unique.

"Default" is a reserved name for the default rule. The default rule is automatically added and can't be removed. (see FileRules::setDefaultRuleColorSpace ).
"ColorSpaceNamePathSearch" is also a reserved name (see FileRules::insertPathSearchRule ).

Will throw if pattern, extension or regex is a null or empty string.

Will throw if ruleIndex is not less than FileRules::getNumEntries .

void OCIO_NAMESPACE::FileRules::insertRule	(	size_t	ruleIndex,
		const char *	name,
		const char *	colorSpace,
		const char *	regex
	)

bool OCIO_NAMESPACE::FileRules::isDefault ( ) const

noexcept

Check if there is only the default rule using default role and no custom key. This is the default FileRules state when creating a new config.

FileRules& OCIO_NAMESPACE::FileRules::operator= ( const FileRules & )

delete

void OCIO_NAMESPACE::FileRules::removeRule ( size_t ruleIndex )

Note: Default rule can't be removed. Will throw if ruleIndex + 1 is not less than FileRules::getNumEntries .

void OCIO_NAMESPACE::FileRules::setColorSpace	(	size_t	ruleIndex,
		const char *	colorSpace
	)

void OCIO_NAMESPACE::FileRules::setCustomKey	(	size_t	ruleIndex,
		const char *	key,
		const char *	value
	)

Adds a key/value or replace value if key exists. Setting a NULL or an empty value will erase the key.

void OCIO_NAMESPACE::FileRules::setDefaultRuleColorSpace ( const char * colorSpace )

Helper function to set the color space for the default rule.

void OCIO_NAMESPACE::FileRules::setExtension	(	size_t	ruleIndex,
		const char *	extension
	)

void OCIO_NAMESPACE::FileRules::setPattern	(	size_t	ruleIndex,
		const char *	pattern
	)

void OCIO_NAMESPACE::FileRules::setRegex	(	size_t	ruleIndex,
		const char *	regex
	)

Friends And Related Function Documentation

friend class Config

friend

Definition at line 1569 of file OpenColorIO.h.

Member Data Documentation

const char* OCIO_NAMESPACE::FileRules::DefaultRuleName

static

Reserved rule name for the default rule.

Definition at line 1459 of file OpenColorIO.h.

const char* OCIO_NAMESPACE::FileRules::FilePathSearchRuleName

static

Reserved rule name for the file path search rule.

See Also: FileRules::insertPathSearchRule.

Definition at line 1461 of file OpenColorIO.h.

The documentation for this class was generated from the following file:

OpenColorIO/OpenColorIO.h

Public Member Functions

Static Public Member Functions

Static Public Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation