RenderingAPI¶

Render Output Location¶

RenderingAPI.RenderOutputLocation.GetPlugin()¶

RenderingAPI.RenderOutputLocation.GetPluginNames()¶

class RenderingAPI.RenderOutputLocation.RenderOutputLocationPlugin¶

render output location plugin

computeFilePath(outputAttrs, locationAttrs, renderSettingsAttrs, imageInfo, makeVersionTemplate) → string¶

Uses the RenderOutputLocation plugin to resolve a file path for the render. The first three arguments should be dictionaries of string -> string or dictionaries of string -> FnAttribute.Attribute. makeVersionTemplate should be an boolean value.

computeLocation(outputAttrs, locationAttrs, renderSettingsAttrs, imageInfo) → string¶

Uses the RenderOutputLocation plug-in to compute a location for the render. Arguments should be dictionaries of string -> string or dictionaries of string -> FnAttribute.Attribute.

getLocationSettingsAttr() → GroupAttr¶

TODO

Render Outputs¶

RenderingAPI.RenderOutputs.GetDefaultRendererSettingsAttr(outputType, producer=None, producerBaseName=None)¶

RenderingAPI.RenderOutputs.GetRenderOutputs(client, includeMerge=False)¶

Render Plugins¶

RenderingAPI.RenderPlugins.GetAllRenderMethods()¶

RenderingAPI.RenderPlugins.GetBatchRenderMethodForRenderer(rendererName)¶

RenderingAPI.RenderPlugins.GetDefaultRendererPluginName()¶

Use the Configuration Singleton to get the default renderer. If there is no entry in the Singleton then returns the first available renderer.

RenderingAPI.RenderPlugins.GetInfoPluginName(rendererName)¶

RenderingAPI.RenderPlugins.GetInfoPluginNameForShaderType(shaderType)¶

RenderingAPI.RenderPlugins.GetProcessedParams(paramList, hintDict={})¶

Iterates over a list of parameters from a RendererInfoPlugin and adds additional hints for better formatting.

This is used in GetOutputChannelAttr above as well as from within the OutputChannelDefineDefaultAttrProducer.

RenderingAPI.RenderPlugins.GetRenderMethodByName(methodName, rendererName=None)¶

RenderingAPI.RenderPlugins.GetRenderMethodForRendererAndMethodName(rendererName, methodName, includeBatch=True)¶

RenderingAPI.RenderPlugins.GetRenderMethodsForRenderer(rendererName)¶

RenderingAPI.RenderPlugins.GetRendererPluginDir(name)¶

RenderingAPI.RenderPlugins.GetRendererPluginNameForShaderType(shaderType)¶

RenderingAPI.RenderPlugins.GetRendererPluginNames(includeViewer=True)¶

RenderingAPI.RenderPlugins.GetRendererSettingsAttr(outputType, producer=None, producerBaseName=None)¶

RenderingAPI.RenderPlugins.GetRendererShaderTypeParamsAttr(rendererName=None)¶

RenderingAPI.RenderPlugins.GetRendererShaderTypeShaderAttr(rendererName=None)¶

RenderingAPI.RenderPlugins.GetRendererShaderTypes(renderer=None)¶

Renderer¶

RenderingAPI.Renderer.GetPlugin()¶

RenderingAPI.Renderer.ReleaseManager()¶

class RenderingAPI.Renderer.RendererPlugin¶

renderer plugin

configureDiskRenderOutputProcess(outputName, outputPath, outputFileName, renderMethodName, frameTime) → GroupAttr¶

Get render output process information wrapped in a group attribute.

RendererInfo¶

RenderingAPI.RendererInfo.FlushPluginCaches()¶

RenderingAPI.RendererInfo.GetPlugin()¶

RenderingAPI.RendererInfo.ReleaseManager()¶

class RenderingAPI.RendererInfo.RendererInfoPlugin¶

renderer info plug-in

addObjectLocation(type, location)¶

Adds a filename or asset ID location directly to the list of renderer objects for the given primary type.

clearObjectLocations()¶

clearObjectLocations(type) Clears the list of additional filenames and asset IDs. If type is specified, only clears the specified list. Otherwise, clears all lists.

getBatchRenderMethod() → GroupAttr¶

Returns the supported batch render method wrapped in a group attribute.

getLiveRenderTerminalOps(stateArgs) → [(opType, opArgs), (opType, opArgs), ...]¶

Returns a list of terminal Ops to be used during Live Rendering.

getRegisteredRendererName() → str¶

Returns the registered renderer name that corresponds to this renderer info plug-in.

getRegisteredRendererVersion() → str¶

Returns the registered renderer version that corresponds to this renderer info plug-in.

getRenderMethods() → GroupAttr¶

Returns a list of supported render methods wrapped in a group attribute.

getRenderTerminalOps(stateArgs) → [(opType, opArgs), (opType, opArgs), ...]¶

Returns a list of terminal Ops to be used during specified render mode.

getRendererCoshaderType() → str¶

Returns the co-shader type if it exists.

getRendererObjectDefaultType(type) → str¶

Returns the default output type name for a given input type (e.g. shader).

getRendererObjectInfo(name, type, inputData) → RendererObjectInfo¶

Returns info for a renderer object by name and type. Input data can be provided as Attribute (optional).

getRendererObjectNames(type, typeTags) → [str, str, ...]¶

Returns a list of names of objects provided by this renderer, filtered by primary type and optional typeTags.

getRendererObjectTypes(type) → [str, str, ...]¶

Returns a list of names of object types provided by this renderer for a given input type (e.g. shader).

getRendererShaderTypeTags(shaderType) → [str, str, ...]¶

Returns a list of names of shader types (surface, displacement, etc.) provided by this renderer.

getShaderInputNames(shader) → [str, str, ...]¶

Returns a list of names of inputs for a given shader.

getShaderInputTags(shader, inputName) → [str, str, ...]¶

Returns a list of tags for a given shader input.

getShaderOutputNames(shader) → [str, str, ...]¶

Returns a list of names of outputs for a given shader.

getShaderOutputTags(shader, outputName) → [str, str, ...]¶

Returns a list of tags for a given shader output.

isNodeTypeSupported(nodeType) → str¶

Katana will call this function to determine if the renderer supports specific nodes. Currently ShadingNode and OutputChannelDefine will be queried. True should be returned if the renderer supports this node type.

isPolymeshFacesetSplittingEnabled() → str¶

Declares if polymesh faces are split into sub-meshes where each mesh represents a single face set as required by some renderers.

isPresetLocalFileNeeded() → str¶

Declares if a renderer output requires a pre-declared temp file (accessible in scene graph with implicit resolvers).

setKatanaPath(katanaPath)¶

Sets Katana’s directory so that the plug-in can access its resources.

setPluginPath(pluginPath)¶

Sets the renderer info plug-in directory.

setPluginRootPath(pluginRootPath)¶

Sets the renderer info plug-in’s root directory so that the plug-in can access its resources.

setTmpPath(tmpPath)¶

Sets the current session’s temporary directory so that the plug-in uses it.

setTypeTagNameFilter(filter, typeTag)¶

Set a filename-style match string for automatically assigning a typeTag based on object name.

class RenderingAPI.RendererInfo.RendererObjectInfo¶

renderer object info

getContainerHints() → ScenegraphAttr.Attr¶

Returns a group attribute of container hints.

getFullPath() → str¶

Returns the absolute filename of the renderer object (if applicable).

getLocation() → str¶

Returns the relative filename or asset ID of the renderer object.

getName() → str¶

Returns the name of the renderer object.

getOutputType() → str¶

Returns the renderer object’s output type (one of the kRendererObjectValueType* constants).

getParam(string) → param¶

Returns an individual parameter by name or None if it doesn’t exist.

getParams() → [param, param, ...]¶

Returns a list of parameters.

getType() → str¶

Returns the primary type of the renderer object.

getTypeTags() → [str, str, ...]¶

Returns additional type tags for the renderer object.

class RenderingAPI.RendererInfo.RendererObjectParamInfo¶

renderer object param info

getArraySize() → int¶

Returns the array size of the parameter, or 0 if it contains a single value.

getDefault() → ScenegraphAttr.Attr¶

Returns an attribute containing default value(s) for the parameter.

getEnums() → ScenegraphAttr.Attr¶

Returns an attribute containing enums for the parameter, or None if the parameter has no enums.

getHints() → ScenegraphAttr.Attr¶

Returns an attribute containing hints for the parameter, or None if the parameter has no hints.

getName() → str¶

Returns the name of the parameter.

getType() → int¶

Returns the type of the parameter (one of the kRendererObjectValueType* constants).