sbslibclasses module

class pysbs.sbslibrary.sbslibclasses.CompNodeInput(aIdentifier, aType=3, aIsPrimary=True, aIsMultiInput=False, aLabel=None)

Bases: NodeInput

This class contains the definition of an input of a Compositing node.

Members:

  • mIdentifier (InputEnum or str): identifier of the input.

  • mType (ParamTypeEnum): type of the input.

  • mIsPrimary (bool): defines if the input is the primary input of the node

  • mLabel (str, optional): user label

getIdentifier()

Get the input identifier as an enum value if possible, or as a string if it is a custom input

Returns:

the input identifier as an integer if possible, or as a string otherwise

getIdentifierStr()

Get the input identifier as a string

Returns:

the input identifier as a string

getLabel()

Get the input label (“Label” is set by the user in the Ds app to give a meaningful name that will be displayed on the node inputs in the graph editor view)

Returns:

the input label as a string

isVariant()

Check if input has a variant type.

Returns:

True if this input is variant, False otherwise.

class pysbs.sbslibrary.sbslibclasses.CompNodeOutput(aIdentifier, aType=3)

Bases: NodeOutput

This class contains the definition of an output of a Compositing node.

Members:
getIdentifier()

Get the output identifier as an enum value if possible, or as a string if it is a custom output

Returns:

the output identifier as an integer if possible, or as a string otherwise

getIdentifierStr()

Get the output identifier as a string

Returns:

the output identifier as a string

class pysbs.sbslibrary.sbslibclasses.CompNodeParam(aParameter, aType=256, aDefaultValue='', aIsConnectable=False)

Bases: NodeParam

This class contains the definition of a parameter of a Compositing node.

Members:

  • mParameter (CompNodeParamEnum): identifier of the parameter.

  • mType (ParamTypeEnum): type of the parameter.

  • mDefaultValue (depends on the type): default value of the parameter.

  • mIsConnectable boolean. decides whether the param is connectable in a graph

getIdentifier()

Get the parameter identifier as an enum value if possible, or as a string if it is a custom parameter

Returns:

the parameter identifier as an integer if possible, or as a string otherwise

getIdentifierStr()

Get the parameter identifier as a string

Returns:

the parameter identifier as a string

getIsConnectable()

Returns True if the input is connectable

Returns:

(bool)

class pysbs.sbslibrary.sbslibclasses.CompNodeDef(aIdentifier, aOutputs=None, aInputs=None, aParameters=None, aInheritance=None, aInputValues=None)

Bases: NodeDef

This class contains the definition of a Compositing node.

Members:

  • mIdentifier (FilterEnum): identifier of the compositing node

  • mInputs (list of CompNodeInput): the input entries of the node.

  • mOutputs (list of CompNodeOutput): the outputs of the node.

  • mParameters (list of CompNodeParam): the parameters available on this node.

  • mInheritance(list of ParamInheritanceEnum): the available inheritance property on this compositing node

addBaseParameters()

Add all the base parameters to the CompNode definition

getAllInputIdentifiers()

Get all the input identifiers as strings of this node definition

Returns:

a list of string

getAllInputLabels()

Get all the input labels as strings of this node definition

Returns:

a list of string

getAllInputs()

Get all the inputs of this node definition

Returns:

a list of NodeInput if found

getAllOutputIdentifiers()

Get all the output identifiers as strings of this node definition

Returns:

a list of string

getAllOutputs()

Get all the outputs of this node definition

Returns:

a list of NodeOutput if found

getAllParameterIdentifiers()

Get all the parameter identifiers as strings of this node definition

Returns:

a list of string

getAllParameters()

Get all the parameters of this node definition

Returns:

a list of NodeParam

getFirstInputOfType(aType)

Gets the first imput of a specific type, checks both inputs and connectable parameters

Parameters:

aType (ParamTypeEnum) – The type to look for

Returns:

NodeInput or CompNodeParam object if found, None otherwise

getFirstOutputOfType(aType)

Get the first NodeOutput with the given type. This considers the variant types as compatible types.

Parameters:

aType (sbsenum.ParamTypeEnum) – The required type

Returns:

a NodeOutput object if found, None otherwise

getIdentifier()
Returns:

The identifier of the node definition as a string

getInput(aInput)

Get the input with the given identifier

Parameters:

aInput (InputEnum or str) – The required input

Returns:

a NodeInput if found, None otherwise

getOutput(aOutput)

Get the output with the given identifier

Parameters:

aOutput (OutputEnum or str) – The required output

Returns:

a NodeOutput if found, None otherwise

getParameter(aParameter)

Get the required parameter

Parameters:

aParameter (NodeParamEnum or str) – The parameter

Returns:

a NodeParam object if found, None otherwise

static isBaseParameter(aParam)

Check if the given parameter is one of the base parameter or not (Output size, Pixel format, …)

Parameters:

aParam (CompNodeParamEnum or NodeParam) – The parameter to check

Returns:

True if there is at least one variant output and no COLOR_MODE parameter, False otherwise

isVariant()

Check if at least one NodeOutput has a variant type.

Returns:

True if there is at least one variant output and no COLOR_MODE parameter, False otherwise

setInputs(aInputs)
setOutputs(aOutputs)
class pysbs.sbslibrary.sbslibclasses.FunctionInput(aIdentifier, aType=3)

Bases: NodeInput

This class contains the definition of an input of a Function node.

Members:
getIdentifier()

Get the input identifier as an enum value if possible, or as a string if it is a custom input

Returns:

the input identifier as an integer if possible, or as a string otherwise

getIdentifierStr()

Get the input identifier as a string

Returns:

the input identifier as a string

getLabel()

Get the input label (“Label” is set by the user in the Ds app to give a meaningful name that will be displayed on the node inputs in the graph editor view)

Returns:

the input label as a string

class pysbs.sbslibrary.sbslibclasses.FunctionOutput(aIdentifier, aType=3)

Bases: NodeOutput

This class contains the definition of an output of a Function node.

Members:
getIdentifier()

Get the output identifier as an enum value if possible, or as a string if it is a custom output

Returns:

the output identifier as an integer if possible, or as a string otherwise

getIdentifierStr()

Get the output identifier as a string

Returns:

the output identifier as a string

class pysbs.sbslibrary.sbslibclasses.FunctionParam(aParameter, aType=256, aDefaultValue='')

Bases: NodeParam

This class contains the definition of a parameter of a Function node.

Members:

  • mParameter (FunctionEnum): identifier of the parameter.

  • mType (ParamTypeEnum): type of the parameter.

  • mDefaultValue (depends on the type): default value of the parameter.

getIdentifier()

Get the parameter identifier as an enum value if possible, or as a string if it is a custom parameter

Returns:

the parameter identifier as an integer if possible, or as a string otherwise

getIdentifierStr()

Get the parameter identifier as a string

Returns:

the parameter identifier as a string

getIsConnectable()

Returns True if the input is connectable

Returns:

(bool)

class pysbs.sbslibrary.sbslibclasses.FunctionDef(aIdentifier, aOutputs=None, aInputs=None, aFunctionDatas=None, aTemplate1=None)

Bases: BaseNodeDef

This class contains the definition of a Function node.

Members:

  • mIdentifier (FunctionEnum): identifier of the function node

  • mInputs (list of FunctionInput): the inputs of the node.

  • mOutputs (list of FunctionOutput): the outputs of the node.

  • mFunctionDatas (list of FunctionParam): the parameters available on this node.

  • mTemplate1 (ParamTypeEnum): for a function with a variant type, provide the allowed types.

getAllInputIdentifiers()

Get all the input identifiers as strings of this node definition

Returns:

a list of string

getAllInputLabels()

Get all the input labels as strings of this node definition

Returns:

a list of string

getAllInputs()

Get all the inputs of this node definition

Returns:

a list of NodeInput if found

getAllOutputIdentifiers()

Get all the output identifiers as strings of this node definition

Returns:

a list of string

getAllOutputs()

Get all the outputs of this node definition

Returns:

a list of NodeOutput if found

getAllParameterIdentifiers()

Get all the parameter identifiers as strings of this node definition

Returns:

a list of string

getAllParameters()

Get all the parameters of this node definition

Returns:

a list of NodeParam

getFirstInputOfType(aType)

Get the first NodeInput with the given type. This considers the variant types as compatible types.

Parameters:

aType (sbsenum.ParamTypeEnum) – The required type

Returns:

a NodeInput object if found, None otherwise

getFirstOutputOfType(aType)

Get the first NodeOutput with the given type. This considers the variant types as compatible types.

Parameters:

aType (sbsenum.ParamTypeEnum) – The required type

Returns:

a NodeOutput object if found, None otherwise

getIdentifier()
Returns:

The identifier of the node definition as a string

getInput(aInput)

Get the input with the given identifier

Parameters:

aInput (InputEnum or str) – The required input

Returns:

a NodeInput if found, None otherwise

getInputType(aInput, aResolved=False)

Get the input type of the input with the given identifier

Parameters:

  • aInput (FunctionInputEnum or str) – The required input

  • aResolved (bool) – In the case of a Template type, True to return the value of the template, False to get TEMPLATE1

Returns:

a ParamTypeEnum if found, None otherwise

getOutput(aOutput)

Get the output with the given identifier

Parameters:

aOutput (OutputEnum or str) – The required output

Returns:

a NodeOutput if found, None otherwise

getParameter(aParameter)

Get the required parameter

Parameters:

aParameter (FunctionEnum or str) – The parameter

Returns:

a FunctionParam object if found, None otherwise

setInputs(aInputs)
setOutputs(aOutputs)
class pysbs.sbslibrary.sbslibclasses.FxMapNodeDef(aIdentifier, aOutputs=None, aInputs=None, aParameters=None, aInheritance=None)

Bases: NodeDef

This class contains the definition of a FxMap node.

Members:

  • mIdentifier (FxMapNodeEnum): identifier of the compositing node

  • mInputs (list of CompNodeInput): the input entries of the node.

  • mOutputs (list of CompNodeOutput): the outputs of the node.

  • mParameters (list of CompNodeParam): the parameters available on this node.

  • mInheritance(list of ParamInheritanceEnum): the available inheritance property on this compositing node

getAllInputIdentifiers()

Get all the input identifiers as strings of this node definition

Returns:

a list of string

getAllInputLabels()

Get all the input labels as strings of this node definition

Returns:

a list of string

getAllInputs()

Get all the inputs of this node definition

Returns:

a list of NodeInput if found

getAllOutputIdentifiers()

Get all the output identifiers as strings of this node definition

Returns:

a list of string

getAllOutputs()

Get all the outputs of this node definition

Returns:

a list of NodeOutput if found

getAllParameterIdentifiers()

Get all the parameter identifiers as strings of this node definition

Returns:

a list of string

getAllParameters()

Get all the parameters of this node definition

Returns:

a list of NodeParam

getFirstInputOfType(aType)

Get the first NodeInput with the given type. This considers the variant types as compatible types.

Parameters:

aType (sbsenum.ParamTypeEnum) – The required type

Returns:

a NodeInput object if found, None otherwise

getFirstOutputOfType(aType)

Get the first NodeOutput with the given type. This considers the variant types as compatible types.

Parameters:

aType (sbsenum.ParamTypeEnum) – The required type

Returns:

a NodeOutput object if found, None otherwise

getIdentifier()
Returns:

The identifier of the node definition as a string

getInput(aInput)

Get the input with the given identifier

Parameters:

aInput (InputEnum or str) – The required input

Returns:

a NodeInput if found, None otherwise

getOutput(aOutput)

Get the output with the given identifier

Parameters:

aOutput (OutputEnum or str) – The required output

Returns:

a NodeOutput if found, None otherwise

getParameter(aParameter)

Get the required parameter

Parameters:

aParameter (NodeParamEnum or str) – The parameter

Returns:

a NodeParam object if found, None otherwise

static isBaseParameter(aParam)

Check if the given parameter is one of the base parameter or not (Output size, Pixel format, …)

Parameters:

aParam (NodeParam) – The parameter to check

Returns:

False, there is no base parameters on the FxMap nodes

isVariant()

Check if at least one NodeOutput has a variant type.

Returns:

True if there is at least one variant output and no COLOR_MODE parameter, False otherwise

setInputs(aInputs)
setOutputs(aOutputs)
class pysbs.sbslibrary.sbslibclasses.GradientKey(aPosition, aValue, aMidpoint=None)

Bases: LibObject

Class that provides a description of a gradient key for the Gradient Map filter.

Members:

  • mPosition (float): the position of the key between 0 and 1

  • mValue (list of 4 floats): the color value of the key.

  • mMidpoint (float, optional): default is -1

class pysbs.sbslibrary.sbslibclasses.CurveKey(aPosition, aLeft, aRight, aIsLeftBroken=False, aIsRightBroken=False, aIsLocked=True)

Bases: LibObject

Class that provides a description of a curve key for the Curve filter.

Members:

  • mPosition (list of two float) : position of the key in two dimensions between 0 and 1

  • mLeft (list of two float) : position of the left handle of the key

  • mRight (list of two float) : position of the right handle of the key

  • mIsLeftBroken (boolean) : True to set the left handle squared instead of rounded. Default to False

  • mIsRightBroken (boolean) : True to set the right handle squared instead of rounded. Default to False

  • mIsLocked (boolean) : True to lock the key handle. Default to True

class pysbs.sbslibrary.sbslibclasses.CurveDefinition(aIdentifier, aCurveKeys)

Bases: LibObject

Class that provides a description of a curve for the Curve filter.

Members:

  • mIdentifier (CurveTypeEnum): the identifier of the curve

  • mCurveKeys (list of CurveKey) : the list of keys

addCurveKey(aCurveKey)

Add the given curve key to the curve definition

Parameters:

aCurveKey (CurveKey) – The key to add

static initCurve(aIdentifier)

Create the initial curve with the bottom left and top right keys.

Parameters:

aIdentifier (CurveTypeEnum) – Identifier of the curve

Returns:

the CurveDefinition object initialized with the default keys

moveKeyTo(aCurveKey, aPosition)

Move the given key to the given position. The resulting position is clamped to the allowed space for this key, considering the previous and next key.

Parameters:

  • aCurveKey (CurveKey) – The key to move

  • aPosition (list of two float between 0 and 1) – The target position

Returns:

The resulting position for this key

class pysbs.sbslibrary.sbslibclasses.WidgetOption(aOption, aType, aValue)

Bases: LibObject

This class provide the definition of an option of a GUI widget associated to an Input Parameter of a Graph.

Members
class pysbs.sbslibrary.sbslibclasses.InputParamWidget(aWidget, aType, aOptions=None)

Bases: LibObject

Class providing the definition of the GUI widget associated to an Input Parameter of a Graph.

Members:

  • mWidget (WidgetEnum): identifier of the widget

  • mType (ParamTypeEnum): type of the value driven by this widget

  • mOptions (list of WidgetOption): options of this widget (min and max values, step, clamp, …)

getDefaultValue()

Get the default value of this widget.

Returns:

the default value as a string if it is defined on this widget, None otherwise

getOption(aOption)

Get the given option.

Parameters:

aOption (WidgetOptionEnum) – The option to get

Returns:

the option as a WidgetOption if it is defined on this widget, None otherwise

getOptions()

Get all the options of this widget.

Returns:

the options of this widget as a list of WidgetOption

hasOption(aOption)

Check if the given option is defined on this widget

Parameters:

aOption (WidgetOptionEnum) – The option to get

Returns:

True if the option is defined on this widget, False otherwise