|On this page|
This node defines named one or more named coordinate systems, sometimes shortend to “coordsys”. These are used in materials to transform locations between different spaces. Each coordinate system is a relationship, pointing to any Xformable prim. Coordinate systems are scoped and inherited like primvars.
A coordsys can be used to specify the space of a particular shading point, or as a space to transform a vector to or from. An shader node that has a “Space” parameter can use a coordsys. Examples include MtlX Position and MtlX Transform Point.
Karma and Cameras
When a given space (specified as primitive path or CoordSys) is a camera, any projected images will behave roughly like an orthographic projection along its local Z-Axis. Karma has a special convention, whereby suffixes can further shape the transform based on camera properties. Without a suffix, only scaling and translating the camera, can adjust the size of the projected image.
Roughly orthographic, along Z-Axis.
For a shader to use a coordinate system, the coordinate system must be defined on a parent prim of both the target and consumer, of the coordsys.
Coordinate systems are inherited by child prims, like constant primvars.
Create Target Prim
Create an Xform or Camera primitive, whose transform will be the target space of the coordsys.
Path of the created target prim.
Parent Primitive Type
Prim type of any parent prims created along with the target prim.
The prim target that will be created. Can be an Xform or a Camera.
Ignore Parent Transforms
Enable to cause the created Xform to ignore any ancestor primitive transforms.
Projection style of the camera, perspective or orthographic.
Offset along the local Z-Axis of the created prim. Applied prior to the prim’s main Transform.
Number of Bindings
More than one coordsys can be defined at a time. Set this to the number of coordsys bindings you want to created, or use the plus and minus buttons to add or remove bindings.
The primitive(s) the node should operate on. You can drag primitives from the scene graph tree pane into this textbox to add their paths, or click the Reselect button beside the text box to select the primitives in the viewer, or ⌃ Ctrl-click the Reselect button to choose prims from a pop-up tree window. You can also use primitive patterns for advanced matching, including matching all prims in a collection (using
Name of the coordinate system to create or edit. The
coordSys: namespace is automatically assumed, but additional name spaces can be specified as well.
The operation to apply to the named coordinate system.
Creates a coordinate system on all of the specified primitives, with the given name and target.
Disable a coordsys from being available.
Delete the given coordinate system from the current scene. Will not remove a coordsys from prims
In Bind mode, this is the primitive whose transform is represented by the coordsys. Multiple primitives can be given the same coordsys, but each coordsys can only target one primitive.