On this page	Inputs Outputs
Since	21.0

Returns the values of an attribute, attribname, on the geometry points that contain another attribute, nameattrib. The following steps are performed:

1. The nameattrib attribute is used to find points on the geometry.

2. For each found point:

   • Look for the subport name on the value variadic output that matches the nameattrib attribute.

   • Set the subport values from the attribname attribute.

For example, consider the case where a geometry has 3 points, and each point has an attribute called myname that is set to values mypoint_1, mypoint_2, and mypoint_3:

• nameattrib = myname

  The attribute name to find on the geometry points. In this example, the myname attribute for the 3 points on the geometry is set to mypoint_1, mypoint_2, and mypoint_3:

  Point Number	myname Value
  1	mypoint_1
  2	mypoint_2
  3	mypoint_3

• attribname = mycustomattribute

  For each point that has the myname attribute, get the value of the mycustomattribute attribute:

  Point Number	mycustomattribute Value
  1	<value_1>
  2	<value_2>
  3	<value_3>

• value variadic output:

  For each point that has the myname attribute, its mycustomattribute value is set into the corresponding subport:

  Subport Name	Subport Value
  mypoint_1	<value_1>
  mypoint_2	<value_2>
  mypoint_3	<value_3>

Each subport on the value variadic output is set from the attribute value of a single point.

Inputs ¶

geo: Geometry

The geometry on which to look for the attributes.

nameattrib: String

The name of the string point attribute that is used to find points on the geometry.

If multiple points have the same value for the nameattrib attribute, only the first found point has its attribname value set. Using the example above, if the geometry contains a 4th point that has a myname attribute (nameattrib) set to mypoint_1, this 4th point will not have its mycustomattribute attribute (attribname) set because the 1st point in the geometry also has its myname attribute set to mypoint_1.

attribname: String

The name of the attribute to get the value from.

Outputs ¶

value: VariadicArg<Dict>, VariadicArg<Float>, VariadicArg<Int>, VariadicArg<Matrix3>, VariadicArg<Matrix4>, VariadicArg<String>, VariadicArg<Vector2>, VariadicArg<Vector3>, VariadicArg<Vector4>, VariadicArg<DictArray>, VariadicArg<FloatArray>, VariadicArg<IntArray>, VariadicArg<StringArray>

A variadic output of attribute values.

See also

geo::DetailAttribValue<T> geo::PointAttribValue<T> geo::PrimAttribValue<T> geo::VertexAttribValue<T> geo::PrimAttribValuesByName<T> geo::VertexAttribValuesByName<T>