Attribute Reader
Read attribute values from points, shapes, or geometry.
What it does
Attribute Reader pulls a single named attribute off any collection, points, shapes or geometry, and exposes it as its own wireable output. Collections carry a bundle of named values: position, colour, normal, scale, an id, a 0–1 progress value and others.
Type the attribute's name into Attribute Name and its values come out as a plain array, accepted anywhere an array is: a Gradient, a colour input, a scale parameter. Standard names are positions, colors, normals, scales, indices, normalized and ids. @-prefixed short names also work.
When to use it
Driving a parameter from something already living on points or shapes, for example reading
normalizedoff an Iterator into a GradientFeeding per-point colours or scales from a collection into an unrelated node, such as an Instance's colour input
Inspecting what a collection is carrying, without a full attribute list
| Parameter | Type | Default |
|---|---|---|
geometry | OneOf([Collection]) | — |
attribute_name | String | "positions" |
Gotchas
This node only reads. It never writes or creates attributes; to add a new attribute to a collection, use an Expression node.
Attribute Name defaults to positions. Left unchanged, it returns positions rather than the intended attribute.
If the named attribute does not exist on the incoming collection there is nothing to read. Check the spelling first. Standard names are normalised, so Cd, color and colors are treated the same way.
Worked example
Add an Attribute Reader and wire a collection (points, shapes or geometry) into Geometry.
Set Attribute Name to the attribute to read:
normalizedon an Iterator's output, orcolorson painted geometry.Wire the Values output into whatever parameter it should drive, such as a Gradient or a colour input.
See also
Sample · Lookup · Info · Attributes