On this page	Inputs Outputs
Since	20.0

Sets the value 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:

   • Find the subport name on the value variadic input that matches the nameattrib attribute.

   • Set the value of the attribname attribute to the subport values.

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

• value variadic input:

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

• attribname = mycustomattribute

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

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

Each subport on the value variadic input sets the attribute value of a single point.

The geo ports of this node are in-place ports, which means that the geometry is updated without creating a copy.

Inputs ¶

*geo: Geometry Required

The geometry on which to set the attribute.

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 set the value for. If there is no attribname attribute on the geometry, a new attribute is created.

value: VariadicArg<Dict>, VariadicArg<Float>, VariadicArg<Int>, VariadicArg<Matrix3>, VariadicArg<Matrix4>, VariadicArg<String>, VariadicArg<Vector2>, VariadicArg<Vector3>, VariadicArg<Vector4>

A variadic input of attribute values to set.

Outputs ¶

*geo: Geometry

The updated geo input with the attribute values modified.

See also

geo::SetDetailAttribValue<T> geo::SetPointAttribValue<T> geo::SetPointAttribValues<T> geo::SetPrimAttribValue<T> geo::SetPrimAttribValues<T> geo::SetPrimAttribValuesByName<T> geo::SetVertexAttribValue<T> geo::SetVertexAttribValues<T> geo::SetVertexAttribValuesByName<T>