ShaderQuery

Queries shader parameters from a scene location, creating outputs for each parameter.

user

Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.

scene

The scene to query the shader for.

location

The location within the scene to query the shader at.

Note

If the location does not exist then the query will not be performed and all outputs will be set to their default values.

shader

The name of the shader to query.

Note

If the shader does not exist then the query will not be performed and all outputs will be set to their default values.

inherit

Queries inherited shader assignments if the location has no local assignment of its own.

queries

The shader parameters to be queried - arbitrary numbers of shader parameters may be added as children of this plug via the user interface, or via python. Each child is a NameValuePlug whose name plug is the shader parameter to query, and whose value plug is the default value to use if the shader parameter can not be retrieved.

The full network of the shader given by shader is available to be queried. Parameters on shaders in the network other than the output shader can be specified as shaderName.parameterName.

Note

If either the shader or parameter does not exist then the query will not be performed and all outputs will be set to their default values.

out

The parent plug of the query outputs. The order of outputs corresponds to the order of children of queries.