sbslibclasses | Substance 3D Automation ToolKit

Search
Substance 3D Automation Toolkit

Substance 3D Automation Toolkit

Open app
Note

Documentation for Substance Automation Toolkit is now included in the SAT package. You can access the documentation by opening html-doc.zip inside your downloaded SAT package.

sbslibclasses

 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()

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

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: 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()

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

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: 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()

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: 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()

Get all the input identifiers 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: 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()

Get all the input identifiers 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: 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)

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)

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)

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: 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)

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()

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

Adobe, Inc.

Get help faster and easier

New user?

Quick links

View all your plans Manage your plans
View quick links
Hide quick links

Legal Notices    |    Online Privacy Policy