User Guide Cancel

sbslibclasses | Substance 3D Automation ToolKit

sbslibclasses

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

Bases: pysbs.sbslibrary.sbslibclasses.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
getIdentifier()
getIdentifier()
 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()
getIdentifierStr()
 getIdentifierStr()  

Get the input identifier as a string

Returns:the input identifier as a string
isVariant()
isVariant()
 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)
class pysbs.sbslibrary.sbslibclasses.CompNodeOutput(aIdentifier, aType=3)
 class pysbs.sbslibrary.sbslibclasses.CompNodeOutput(aIdentifier, aType=3)  

Bases: pysbs.sbslibrary.sbslibclasses.NodeOutput

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

Members:
getIdentifier()
getIdentifier()
 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()
getIdentifierStr()
 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)
class pysbs.sbslibrary.sbslibclasses.CompNodeParam(aParameter, aType=256, aDefaultValue='', aIsConnectable=False)
 class pysbs.sbslibrary.sbslibclasses.CompNodeParam(aParameter, aType=256, aDefaultValue='', aIsConnectable=False)  

Bases: pysbs.sbslibrary.sbslibclasses.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()
getIdentifier()
 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()
getIdentifierStr()
 getIdentifierStr()  

Get the parameter identifier as a string

Returns:the parameter identifier as a string
getIsConnectable()
getIsConnectable()
 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)
class pysbs.sbslibrary.sbslibclasses.CompNodeDef(aIdentifier, aOutputs=None, aInputs=None, aParameters=None, aInheritance=None, aInputValues=None)
 class pysbs.sbslibrary.sbslibclasses.CompNodeDef(aIdentifier, aOutputs=None, aInputs=None, aParameters=None, aInheritance=None, aInputValues=None)  

Bases: pysbs.sbslibrary.sbslibclasses.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()
addBaseParameters()
 addBaseParameters()  

Add all the base parameters to the CompNode definition

getAllInputIdentifiers()
getAllInputIdentifiers()
 getAllInputIdentifiers()  

Get all the input identifiers as strings of this node definition

Returns:a list of string
getAllInputs()
getAllInputs()
 getAllInputs()  

Get all the inputs of this node definition

Returns:a list of NodeInput if found
getAllOutputIdentifiers()
getAllOutputIdentifiers()
 getAllOutputIdentifiers()  

Get all the output identifiers as strings of this node definition

Returns:a list of string
getAllOutputs()
getAllOutputs()
 getAllOutputs()  

Get all the outputs of this node definition

Returns:a list of NodeOutput if found
getAllParameterIdentifiers()
getAllParameterIdentifiers()
 getAllParameterIdentifiers()  

Get all the parameter identifiers as strings of this node definition

Returns:a list of string
getAllParameters()
getAllParameters()
 getAllParameters()  

Get all the parameters of this node definition

Returns:a list of NodeParam
getFirstInputOfType(aType)
getFirstInputOfType(aType)
 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)
getFirstOutputOfType(aType)
 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()
getIdentifier()
 getIdentifier()  
Returns:The identifier of the node definition as a string
getInput(aInput)
getInput(aInput)
 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)
getOutput(aOutput)
 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)
getParameter(aParameter)
 getParameter(aParameter)  

Get the required parameter

Parameters:aParameter (NodeParamEnum or str) – The parameter
Returns:a NodeParam object if found, None otherwise
static isBaseParameter(aParam)
static isBaseParameter(aParam)
 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()
isVariant()
 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)
setInputs(aInputs)
 setInputs(aInputs)  
setOutputs(aOutputs)
setOutputs(aOutputs)
 setOutputs(aOutputs)  
class pysbs.sbslibrary.sbslibclasses.FunctionInput(aIdentifier, aType=3)
class pysbs.sbslibrary.sbslibclasses.FunctionInput(aIdentifier, aType=3)
 class pysbs.sbslibrary.sbslibclasses.FunctionInput(aIdentifier, aType=3)  

Bases: pysbs.sbslibrary.sbslibclasses.NodeInput

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

Members:
getIdentifier()
getIdentifier()
 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()
getIdentifierStr()
 getIdentifierStr()  

Get the input identifier as a string

Returns:the input identifier as a string
class pysbs.sbslibrary.sbslibclasses.FunctionOutput(aIdentifier, aType=3)
class pysbs.sbslibrary.sbslibclasses.FunctionOutput(aIdentifier, aType=3)
 class pysbs.sbslibrary.sbslibclasses.FunctionOutput(aIdentifier, aType=3)  

Bases: pysbs.sbslibrary.sbslibclasses.NodeOutput

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

Members:
getIdentifier()
getIdentifier()
 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()
getIdentifierStr()
 getIdentifierStr()  

Get the output identifier as a string

Returns:the output identifier as a string
class pysbs.sbslibrary.sbslibclasses.FunctionParam(aParameter, aType=256, aDefaultValue='')
class pysbs.sbslibrary.sbslibclasses.FunctionParam(aParameter, aType=256, aDefaultValue='')
 class pysbs.sbslibrary.sbslibclasses.FunctionParam(aParameter, aType=256, aDefaultValue='')  

Bases: pysbs.sbslibrary.sbslibclasses.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()
getIdentifier()
 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()
getIdentifierStr()
 getIdentifierStr()  

Get the parameter identifier as a string

Returns:the parameter identifier as a string
getIsConnectable()
getIsConnectable()
 getIsConnectable()  

Returns True if the input is connectable

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

Bases: pysbs.sbslibrary.sbslibclasses.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()
getAllInputIdentifiers()
 getAllInputIdentifiers()  

Get all the input identifiers as strings of this node definition

Returns:a list of string
getAllInputs()
getAllInputs()
 getAllInputs()  

Get all the inputs of this node definition

Returns:a list of NodeInput if found
getAllOutputIdentifiers()
getAllOutputIdentifiers()
 getAllOutputIdentifiers()  

Get all the output identifiers as strings of this node definition

Returns:a list of string
getAllOutputs()
getAllOutputs()
 getAllOutputs()  

Get all the outputs of this node definition

Returns:a list of NodeOutput if found
getAllParameterIdentifiers()
getAllParameterIdentifiers()
 getAllParameterIdentifiers()  

Get all the parameter identifiers as strings of this node definition

Returns:a list of string
getAllParameters()
getAllParameters()
 getAllParameters()  

Get all the parameters of this node definition

Returns:a list of NodeParam
getFirstInputOfType(aType)
getFirstInputOfType(aType)
 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)
getFirstOutputOfType(aType)
 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()
getIdentifier()
 getIdentifier()  
Returns:The identifier of the node definition as a string
getInput(aInput)
getInput(aInput)
 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)
getInputType(aInput, aResolved = False)
 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)
getOutput(aOutput)
 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)
getParameter(aParameter)
 getParameter(aParameter)  

Get the required parameter

Parameters:aParameter (FunctionEnum or str) – The parameter
Returns:a FunctionParam object if found, None otherwise
setInputs(aInputs)
setInputs(aInputs)
 setInputs(aInputs)  
setOutputs(aOutputs)
setOutputs(aOutputs)
 setOutputs(aOutputs)  
class pysbs.sbslibrary.sbslibclasses.FxMapNodeDef(aIdentifier, aOutputs=None, aInputs=None, aParameters=None, aInheritance=None)
class pysbs.sbslibrary.sbslibclasses.FxMapNodeDef(aIdentifier, aOutputs=None, aInputs=None, aParameters=None, aInheritance=None)
 class pysbs.sbslibrary.sbslibclasses.FxMapNodeDef(aIdentifier, aOutputs=None, aInputs=None, aParameters=None, aInheritance=None)  

Bases: pysbs.sbslibrary.sbslibclasses.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()
getAllInputIdentifiers()
 getAllInputIdentifiers()  

Get all the input identifiers as strings of this node definition

Returns:a list of string
getAllInputs()
getAllInputs()
 getAllInputs()  

Get all the inputs of this node definition

Returns:a list of NodeInput if found
getAllOutputIdentifiers()
getAllOutputIdentifiers()
 getAllOutputIdentifiers()  

Get all the output identifiers as strings of this node definition

Returns:a list of string
getAllOutputs()
getAllOutputs()
 getAllOutputs()  

Get all the outputs of this node definition

Returns:a list of NodeOutput if found
getAllParameterIdentifiers()
getAllParameterIdentifiers()
 getAllParameterIdentifiers()  

Get all the parameter identifiers as strings of this node definition

Returns:a list of string
getAllParameters()
getAllParameters()
 getAllParameters()  

Get all the parameters of this node definition

Returns:a list of NodeParam
getFirstInputOfType(aType)
getFirstInputOfType(aType)
 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)
getFirstOutputOfType(aType)
 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()
getIdentifier()
 getIdentifier()  
Returns:The identifier of the node definition as a string
getInput(aInput)
getInput(aInput)
 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)
getOutput(aOutput)
 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)
getParameter(aParameter)
 getParameter(aParameter)  

Get the required parameter

Parameters:aParameter (NodeParamEnum or str) – The parameter
Returns:a NodeParam object if found, None otherwise
static isBaseParameter(aParam)
static isBaseParameter(aParam)
 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()
isVariant()
 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)
setInputs(aInputs)
 setInputs(aInputs)  
setOutputs(aOutputs)
setOutputs(aOutputs)
 setOutputs(aOutputs)  
class pysbs.sbslibrary.sbslibclasses.GradientKey(aPosition, aValue, aMidpoint=None)
class pysbs.sbslibrary.sbslibclasses.GradientKey(aPosition, aValue, aMidpoint=None)
 class pysbs.sbslibrary.sbslibclasses.GradientKey(aPosition, aValue, aMidpoint=None)  

Bases: pysbs.sbslibrary.sbslibclasses.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)
class pysbs.sbslibrary.sbslibclasses.CurveKey(aPosition, aLeft, aRight, aIsLeftBroken=False, aIsRightBroken=False, aIsLocked=True)
 class pysbs.sbslibrary.sbslibclasses.CurveKey(aPosition, aLeft, aRight, aIsLeftBroken=False, aIsRightBroken=False, aIsLocked=True)  

Bases: pysbs.sbslibrary.sbslibclasses.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)
class pysbs.sbslibrary.sbslibclasses.CurveDefinition(aIdentifier, aCurveKeys)
 class pysbs.sbslibrary.sbslibclasses.CurveDefinition(aIdentifier, aCurveKeys)  

Bases: pysbs.sbslibrary.sbslibclasses.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)
addCurveKey(aCurveKey)
 addCurveKey(aCurveKey)  

Add the given curve key to the curve definition

Parameters:aCurveKey (CurveKey) – The key to add
static initCurve(aIdentifier)
static initCurve(aIdentifier)
 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)
moveKeyTo(aCurveKey, aPosition)
 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)
class pysbs.sbslibrary.sbslibclasses.WidgetOption(aOption, aType, aValue)
 class pysbs.sbslibrary.sbslibclasses.WidgetOption(aOption, aType, aValue)  

Bases: pysbs.sbslibrary.sbslibclasses.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)
class pysbs.sbslibrary.sbslibclasses.InputParamWidget(aWidget, aType, aOptions=None)
 class pysbs.sbslibrary.sbslibclasses.InputParamWidget(aWidget, aType, aOptions=None)  

Bases: pysbs.sbslibrary.sbslibclasses.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()
getDefaultValue()
 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)
getOption(aOption)
 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()
getOptions()
 getOptions()  

Get all the options of this widget.

Returns:the options of this widget as a list of WidgetOption
hasOption(aOption)
hasOption(aOption)
 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

Get help faster and easier

New user?