Adds points to a points object, such as a particle system. Any properties that target point_component get set to their default value for the new points, but you can use new_collection to initialize them to other values.

Inputs

geometry

A points object.

positions

The array of positions at which to add points.

new_collection

The name of a point collection to which to add the new points. This is optional. If the collection already exists, it is replaced.

If you supply the name that you want to use for the collection, you can use new_collection to set values for properties like point_size for the new points:

1. Get the property values from the output geometry using get_geo_property and the collection name entered here. Plug a Boolean value node into the type port.

2. Plug the data output of get_geo_property into the condition port of an if node.

3. Use another get_geo_property node to get the values of an existing property on the original points object, and plug its data values into the false_case port of the if node.

4. Create a subgraph to calculate the values you want to use for the new points, and plug its output into the true_case port of the if node.

5. Use a set_geo_property_data node to set the resulting values on the points object:

   • Plug the output from add_points into the geometry port of set_geo_property_data.
   • Set property to the name of the existing property.
   • Plug the output of the if node into the data port.

6. Repeat for other properties that you want to initialize.

Output

out_geometry

The new points object with the added points.