Dynamic Geometry Attributes: Node attributes

Most DGA work can be performed in the Node Editor. Use the Attribute Editor to fine-tune calculation, normalization, visualization, and sampling settings on individual nodes.

Node Editor: Press 3 to show primary attributes on supported nodes. Press 1 to collapse the node attributes.

dgaTension

Compares geometry states and calculates squash and stretch values.

Note: UV-based tension calculations use UV-space edge vectors to determine directional tension values.

dgaDelta

Calculates changes in vertex position or vertex normal angle between geometry states.

Attribute Description
Input Geometry Specifies the geometry to analyze for delta calculations. The topology must match Original Geometry for an accurate vertex-to-vertex comparison.
Reference Geometry Specifies optional geometry to compare when calculating delta values. If this attribute is not connected, Original Geometry is used as the reference. The topology must match Original Geometry.
Original Geometry Specifies the undeformed base geometry. It provides topology data for the delta calculation and is used as the reference when Reference Geometry is not connected.
Delta Mode Specifies whether dgaDelta measures changes in vertex position or vertex normal angle.
Normalize Output When enabled, clamps delta output to the Normalization Min and Normalization Max range, then normalizes the clamped values. When disabled, delta output is not clamped.
Normalization Min Sets the minimum value used to clamp and normalize delta output when Normalize Output is enabled.
Normalization Max Sets the maximum value used to clamp and normalize delta output when Normalize Output is enabled.
Component Tag Expression Specifies an expression that limits processing to a subset of components. When only a subset is processed, the output is a sparse array containing data for the specified components.
Output Attributes Outputs the calculated per-vertex delta data. In Position mode, the outputs include overall position-change magnitude and X, Y, and Z position changes. In Normal mode, the output is the change in vertex-normal direction, measured in degrees when the output is not normalized.
Output Geometry Passes through the unchanged input geometry for node-graph connections. When connected, the dgaDelta node appears in the output mesh node's deformation history.
Note: Position component deltas (X, Y, and Z) preserve their sign when normalized.

dgaVisualizer

Displays DGA data as vertex colors on the mesh.

Attribute Description
Input Attributes Specifies the DGA data to visualize. Connect this attribute to Output Attributes on a DGA calculation node. Multiple attributes can be connected.
Solo Input Index Specifies which connected input attribute to visualize. For example, when visualizing tension data, index 0 displays squash and index 1 displays stretch.
Use Absolute Value Displays the absolute value of incoming data so that negative values are visualized as positive values.
Normalization Mode Controls how input values are normalized for visualization. Static uses the fixed Normalization Min and Normalization Max range. Dynamic determines the range from the current input data and rescales the values to 0-1.
Normalization Min Sets the minimum expected value used by Static normalization. Values below this value are clamped.
Normalization Max Sets the maximum expected value used by Static normalization. Values above this value are clamped.
Apply Color Ramp When enabled, maps values through Color Ramp. When disabled, displays the values in grayscale.
Output Geometry Outputs a copy of the input geometry with vertex colors applied to the active color set based on the DGA data and visualization settings.
Note: Creating a dgaVisualizer setup through the Dynamic Geometry Attributes Options window enables Display Colors on the mesh automatically. If you create the node separately, such as in the Node Editor, Display Colors is not enabled automatically. Use Static normalization for stable comparisons across frames; Dynamic normalization is useful for inspecting relative differences within the current data.

pointValueArray

Converts sparse per-point numerical values to a dense double array containing one value for each point.

Attribute Description
Input Geometry Specifies the geometry associated with the data and determines the size of the output array.
Input Double Values Specifies the sparse DGA values to convert to a double array.
Default Value Specifies the value used to fill array entries that are missing from sparse input so the output contains one value for each vertex.
Output Double Array Outputs a dense double array containing one value for each vertex. Missing sparse-input values are filled with Default Value.
Note: The dgaToArray node was renamed pointValueArray. Existing scenes that contain dgaToArray are updated automatically when loaded. When you re-save an updated scene, Maya uses the new node type and plug-in names.
Note: The pointValueArray and pointValues nodes are provided by the pointValues plug-in.
Note: pointValues consumes array data from pointValueArray.

pointValues

Samples a per-vertex array across a polygon mesh using UV coordinates and exposes the result as texture-style outputs. The current implementation requires one array value for each point. Use pointValues when another Maya node must consume point values through a texture-compatible connection.

Note: pointValues uses UVs from Original Geometry to generate its sampled output. The selected UV set is populated from UV sets on Original Geometry. If the selected UV set becomes invalid, Maya reports an error and falls back to the mesh default UV set.

UV tiling: pointValues supports UV coordinates that extend outside the [0,1] tile. For viewport evaluation, Maya fits the complete UV range into the square texture at the selected Texture Resolution. UV ranges that extend significantly farther in one dimension can produce distortion or artifacts

Limitation: pointValues does not automatically detect changes to UV coordinates. To update the sampled output, reselect UV Set Name or change the geometry.

Attribute Description
Original Geometry Specifies the polygon mesh whose topology and UVs are used to sample the input array. The current implementation expects one input-array value for each vertex.
UV Set Name Specifies the UV set used to sample per-vertex values. The menu is populated from UV sets on Original Geometry. If the selected UV set is invalid, Maya reports an error and uses the mesh default UV set. Select Use Current UV Set to use the current UV set on Original Geometry. The node updates when the current UV set on Original Geometry changes.
Input Array Specifies the dense array of per-vertex values to sample. The current implementation requires one value for each vertex; DGA workflows typically supply this array from pointValueArray. The technical attribute name is inputValueArray.
Texture Resolution Sets the texture resolution used for viewport shader evaluation. The slider range is 64-2048; values up to the hard maximum of 8192 can be entered directly. Higher values can impact performance.
Offset Adds the specified value to the output after Scale is applied. The default value is 0.
Scale Multiplies each point value before Offset is applied. The default value is 1.
Smoothing Enables smoothing of sampled values to reduce visible faceting on low-resolution meshes with detailed deformation. Enable Smoothing only when needed because it adds evaluation cost.
Smoothing Iterations Sets the number of smoothing iterations. A value of 0 disables smoothing and adds no smoothing evaluation cost. Higher values can reduce faceting but increase evaluation cost, especially on larger meshes.
outColor Outputs the sampled values as color data. The R, G, and B components contain the same sampled value and match outAlpha.
outAlpha Outputs the sampled value as scalar data for compatible inputs.
Note: The node calculates its output as value = pointValue * scale + offset. The output can contain any float value, including negative values. Use a negative Scale value to invert the sampled values. pointValues does not normalize or clamp its output. Apply any required normalization or clamping before the values reach the node.