COMP Instance 2 Page

Parameters - Instance 2 Page

When the instance data is supplied by a TOP, the TOP's RGBA channels are assigned to instance attributes; when data is supplied by a CHOP, the CHOP's channels are assigned to instance attributes; when from a SOP then the SOP's attributes are assigned to instance attributes; and when a DAT is used then a column is assigned to the instances attributes.

Rotate to Vector: Order `instancerottoorder` - - Controls where in the transform equation the Rotate To Vector operation is applied.

• Default `default` - The Rotate to Vector operation will be applied before all other transform operations (except the pivot offset), regardless of their order of operation. E.g ` T * R * S * (RotToVector) * Position `, ` R * S * T * (RotToVector) * Position `.
• Pre-Rot `prerot` - The Rotate To Vector operation will be applied after the main rotation as part of the TRS order. I.e ` T * (RotToVector * R) * S * Position`, ` (RotToVector * R) * S * T * Position`.
• Post-Rot `postrot` - The Rotate To Vector operation will be applied before the main rotation as part of the TRS order. I.e ` T * (R * RotToVector) * S * Position`, ` (R * RotToVector) * S * T * Position`.

Rotate to Vector: Forward Direction `instancerottoforward` - - Determine which axis for the geometry original orientation is considered 'forward'. That is, it'll treat the part of the geometry that is looking down that axis as the front and rotate it so it's aligned with the rotate to vector direction.

• +X `posx` -
• -X `negx` -
• +Y `posy` -
• -Y `negy` -
• +Z `posz` -
• -Z `negz` -

Rotate to OP `instancerottoop` - Select a specific operator to get data from for the Rotate to Vector instance attributes below. If not specified, the the operator specified in the 'Default Instance OP' on the Instance parameter page can be used.

Rotate to Vector X `instancerottox` - Select what data to use to rotate to vector instances, use the drop-down menu on the right to easily select from the available options.

Rotate to Vector Y `instancerottoy` - Select what data to use to rotate to vector instances, use the drop-down menu on the right to easily select from the available options.

Rotate to Vector Z `instancerottoz` - Select what data to use to rotate to vector instances, use the drop-down menu on the right to easily select from the available options.

Rotate Up OP `instancerotupop` - Select a specific operator to get data from for the Rotate Up instance attributes below. If not specified, the the operator specified in the 'Default Instance OP' on the Instance parameter page can be used.

Rotate Up X `instancerotupx` - Select what data to use to rotate up instances, use the drop-down menu on the right to easily select from the available options.

Rotate Up Y `instancerotupy` - Select what data to use to rotate up instances, use the drop-down menu on the right to easily select from the available options

Rotate Up Z `instancerotupz` - Select what data to use to rotate up instances, use the drop-down menu on the right to easily select from the available options

Instance Order `instanceorder` - - Sets how transforms are applied to the instances.

• Instance, then World Transform `instanceworld` - Use the individual instance transforms first, then apply the world transform (i.e. Xform and Pre-Xform parameter pages). `worldXform * instanceXForm * Position`
• World Transform, then Instance `worldinstance` - Use the world transform first, then apply the individual instance transforms. `instanceXForm * worldXForm * Position`

Texture Mode `instancetexmode` - - Set how the texture coordinates are applied to the instances.

• Replace `replace` - Replaces texture coordinates.
• Transform `transform` - Offsets texture coordinates.

Tex Coord OP `instancetexcoordop` - Select a specific operator to get data from for the Texture Coord instance attributes below. If not specified, the the operator specified in the 'Default Instance OP' on the Instance parameter page can be used.

U `instanceu` - Select what data to apply to texture coordinates of the instances, use the drop-down menu on the right to easily select from the available options. This interacts with the first texture layer uv[0] attributes coming from the SOP.

V `instancev` - Select what data to apply to texture coordinates of the instances, use the drop-down menu on the right to easily select from the available options. This interacts with the first texture layer uv[0] attributes coming from the SOP.

W `instancew` - Select what data to apply to texture coordinates of the instances, use the drop-down menu on the right to easily select from the available options. This interacts with the first texture layer uv[0] attributes coming from the SOP.

Color Mode `instancecolormode` - - Controls how the instance color values interact with the SOPs 'Cd' (diffuse color) attribute. If the SOP doesn't have a 'Cd' attribute, then it will behave as if its 'Cd' is (1, 1, 1, 1).

• Replace `replace` -
• Multiply `multiply` -
• Add `add` -
• Subtract `subtract` -

Color OP `instancecolorop` - Select a specific operator to get data from for the Color instance attributes below. If not specified, the the operator specified in the 'Default Instance OP' on the Instance parameter page can be used.

R `instancer` - Select what data to apply to the diffuse color of the instances, use the drop-down menu on the right to easily select from the available options. These parameters will be combined/replaced with the SOPs 'Cd' attribute, as chosen by the Color Mode parameter.

G `instanceg` - Select what data to apply to the diffuse color of the instances, use the drop-down menu on the right to easily select from the available options. These parameters will be combined/replaced with the SOPs 'Cd' attribute, as chosen by the Color Mode parameter.

B `instanceb` - Select what data to apply to the diffuse color of the instances, use the drop-down menu on the right to easily select from the available options. These parameters will be combined/replaced with the SOPs 'Cd' attribute, as chosen by the Color Mode parameter.

A `instancea` - Select what data to apply to the diffuse color of the instances, use the drop-down menu on the right to easily select from the available options. These parameters will be combined/replaced with the SOPs 'Cd' attribute, as chosen by the Color Mode parameter.

Instance Textures `instancetexs` - - Specify the paths one or more TOP containing the textures to use with the instances. Wildcards and pattern matching is supported.

Extend U `instancetexextendu` - -
• Hold `hold` -
• Zero `zero` -
• Repeat `repeat` -
• Mirror `mirror` -
Extend V `instancetexextendv` - -
• Hold `hold` -
• Zero `zero` -
• Repeat `repeat` -
• Mirror `mirror` -
Extend W `instancetexextendw` - -
• Hold `hold` -
• Zero `zero` -
• Repeat `repeat` -
• Mirror `mirror` -
Filter `instancetexfilter` - -
• Nearest `nearest` -
• Linear `linear` -
• Mipmap Linear `mipmaplinear` -
Anisotropic Filter `instancetexanisotropy` - -
• Off `off` -
• 2x `2x` -
• 4x `4x` -
• 8x `8x` -
• 16x `16x` -

Instance Texturing

This feature allows for arbitrary textures to be applied to instances. The textures do not need to be the same resolution, and they don't need to be combined into an grouped format such as a 3D Texture or a 2D Texture array. Multiple TOPs can be specified using the "Instance Textures" parameter, and the texture that is applied per-instance is specified using the channel chosen in the "Texture Index" parameter. This is different from a 3D Texture or 2D Texture Array, which would use the W texture coordinate to select a texture from within a single texture. By default this texture will be used as the "Base Color Map" texture for a PBR MAT, and the Color Map for all other materials such as the Phong MAT. For materials that support more than one map, the map that this this feature replaces can be chosen in the material's parameters. Currently on Windows at most 16384 textures can be used at once, and on macOS at most 128 textures can be used at once. These numbers are reduced by other textures that are used by the render such as other maps, cone light lookup map etc.

Tex Index OP `instancetexindexop` - Select a specific operator to get data from for the Texture Index instance attribute below. If not specified, the the operator specified in the 'Default Instance OP' on the Instance parameter page can be used.

Texture Index `instancetexindex` - Select what data to select which texture to use for the instances, use the drop-down menu on the right to easily select from the available options.