On this page	Inputs Outputs
Since	20.0

Sets the value of an attribute, attribname, on the points in a geometry based on the presence of another attribute, nameattrib. The following steps are performed:

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

2. For the points that have the attribute specified in nameattrib:

   • Look for the subport name on the value variadic input that matches the values of the nameattrib attribute on each point.

   • Set the value of the attribute attribname 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 points in the geometry. In this example, the myname attribute for the 3 points on the geometry have values mypoint_1, mypoint_2, and mypoint_3.

• value variadic input:

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

• attribname = mycustomattribute

  Sets the value of a new attribute mycustomattribute on each point that has the nameattrib attribute. The values of mycustomattribute are set to:

  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 a 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 which 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>