Cooking with Producers

Producers are objects that cook the scene graph from a particular node. There are two kinds of producers available in Katana – geometry producers and render producers – which correspond to having implicit resolvers disabled or enabled.

API Reference

Nodes3DAPI.GetGeometryProducer(node=None, graphState=None, portIndex=0)

Creates and returns a geometry producer for a node.

The new producer will represent the /root location.

Calls Nodes3DAPI.GetOp() with the given arguments to obtain the Op with which to configure the Geolib3 Client that is passed to the initializer of the FnGeolibProducers.GeometryProducer class.

Return type:

FnGeolibProducers.GeometryProducer or None

Parameters:

node (NodegraphAPI.Node or None) – The node for which to create a geometry producer, or None to create a geometry producer for the node from which the scene is currently being viewed.
graphState (NodegraphAPI.GraphState or float or None) – The graph state or frame timea for which to obtain an Op that is to be used in creating the geometry producer, or None to use the current graph state.
portIndex (int) – The index of the port on the node for which to obtain an Op that is to be used in creating the geometry producer.

Returns:

A geometry producer that represents the /root location that is generated by the nodes that end in the given node or the view node.

Raises:

TypeError – If the given node or graphState object is not of the expected type.

See:

GetRenderProducer()

Nodes3DAPI.GetRenderProducer(node=None, graphState=None, useMaxSamples=False, portIndex=0, applyRenderSelectedMask=True)

Creates and returns a renderable geometry producer for a node.

The new producer will represent the /root location.

Calls Nodes3DAPI.GetRenderOp() with the given arguments to obtain the Op with which to configure the Geolib3 Client that is passed to the initializer of the FnGeolibProducers.GeometryProducer class.

A renderable geometry producer has additional Ops applied that resolve necessary attributes on the producer. This includes things like texture, material, and constraint resolution.

Return type:

FnGeolibProducers.GeometryProducer or None

Parameters:

node (NodegraphAPI.Node or None) – The node for which to create a geometry producer, or None to create a geometry producer for the node from which the scene is currently being viewed.
graphState (NodegraphAPI.GraphState or float or None) – The graph state or frame timea for which to obtain an Op that is to be used in creating the geometry producer, or None to use the current graph state.
useMaxSamples (bool) – Flag that controls whether the scene is cooked with multiple time samples.
portIndex (int) – The index of the port on the node for which to obtain an Op that is to be used in creating the geometry producer.
applyRenderSelectedMask (bool) – Flag that controls whether the state of the global Render Only Selected Objects toggle should be respected.

Returns:

A renderable geometry producer that represents the /root location that is generated by the nodes that end in the given node or the view node, or None if a renderable geometry producer could not be created.

Raises:

TypeError – If the given node or graphState object is not of the expected type.

See:

GetGeometryProducer()

class FnGeolibProducers.GeometryProducer

Bases: pybind11_object

Geometry producer

__init__(producerType: str, **kwargs) → None: Constructs a GeometryProducer of the given type. Keyword arguments must be given to pass to the initializer for the desired producer type.

getAttribute(name: str) → PyFnAttribute.Attribute: Gets the sampled values for the named attribute of this GeometryProducer as an FnAttribute, or None if the requested name is not included in the results of getAttributeNames(). Supports querying of nested names using dot dyntax to separate levels of the path hierarchy.

getAttributeNames() → list: Gets the names of locally defined attributes on this GeometryProducer.

getCacheID() → str: Gets a cache ID based on what created this producer. This cache value should be constant for producers generating the same output.

getChildByName(name: str) → PyFnGeolibProducers.GeometryProducer: Find a child of this GeometryProducer by name, or None if there is no child of the given name. This function does not support nested child lookups.

getClient() → Geolib3::internal::FnGeolib::GeolibRuntime::Client: Gets the client backing this producer, or None.

getDelimitedGlobalAttribute(name: str) → PyFnAttribute.Attribute: Gets the sampled values for the named global attribute of this GeometryProducer as an FnAttribute, or None if the global attribute cannot be found. Supports querying of nested names using dot syntax to separate levels of the path hierarchy.

getDelimitedLocalAttribute(name: str) → PyFnAttribute.Attribute: Gets the sampled values for the named attribute of this GeometryProducer as a FnAttribute, or None if the requested name is not included in the results of getAttributeNames(). Supports querying of nested names using dot syntax to separate levels of the path hierarchy.

getFirstChild() → PyFnGeolibProducers.GeometryProducer: Gets the first child of this GeometryProducer, or None if there are no children.

getFlattenedGlobalXform() → tuple: Returns a 16-element tuple containing the global (worldspace) transform for this GeometryProducer’s location.

getFnAttribute(name: str) → PyFnAttribute.Attribute: Gets the sampled values for the named attribute of this GeometryProducer as an FnAttribute, or None if the requested name is not included in the results of getAttributeNames(). Supports querying of nested names using dot dyntax to separate levels of the path hierarchy.

getFullName() → str: Gets the full name of this GeometryProducer from the root.

getGlobalAttribute(name: str) → PyFnAttribute.Attribute: Gets the sampled values for the named global attribute of this GeometryProducer as a FnAttribute, or None if the global attribute cannot be found. Supports querying of nested names using dot syntax to separate levels of the path hierarchy.

getName() → str: Gets the name of this GeometryProducer.

getNextSibling() → PyFnGeolibProducers.GeometryProducer: Gets the next sibling of this GeometryProducer, or None if this is the last child of the parent.

getParent() → PyFnGeolibProducers.GeometryProducer: Gets the parent of this GeometryProducer, or None if this is the root producer.

getPotentialChildren() → PyFnAttribute.StringAttribute: Gets the potential children of this GeometryProducer, as a GroupAttribute indexed by child name.

getProducerByPath(path: str) → PyFnGeolibProducers.GeometryProducer: Find a descendent of this GeometryProducer by path, or None if no producer can be found. This function supports nested lookups via a slash-delimited path.

getRootProducer() → PyFnGeolibProducers.GeometryProducer: Gets the root of this GeometryProducer. This will return the current producer if it is already the root.

getType() → str: Gets the type of this GeometryProducer.

iterChildren() → PyFnGeolibProducers.GeometryProducer_childIter: Returns an iterator for all immediate children of this GeometryProducer.