NodeIcon SavePoints

Saves named points on a triangle to a file in the TXT or JSON format.

Tip

By default SavePoints node does nothing unless you click Compute Current Frame or Compute Frame Range button.


Inputs

Named points on triangle

NamedPointsOnTriangle An array of named points on a triangle to be saved

Geometry

Geometry (optional) An input geometry for using 3D-Points format. Not required if you plan to save points in a different format.

Parameters

File Name:

file name to save.

Any occurrence of # will be replaced with the current frame number during saving.

For example, if the current frame is 1, the Points####.json string will be replaced with Points0001.json

Create Intermediate Directories:

if set, nonexistent directories in the file path will be created.

Format:
Named Point On Triangle

save points in native Named Points On Triangle format.

Point On Triangle

save points in Point On Triangle format.

3D-Points

save points as 3D points.

File Formats

Named points can be exported in the following JSON formats:

Point On Triangle

The points are represented in the following JSON format:

[ [0, 0.3, 0.5], [1, 0.0, 1.0] ]

This line stores two points. Each point is represented with 3 numbers:

  • index of the triangle containing the point

  • the first barycentric coordinate of the point inside the triangle

  • the second barycentric coordinate of the point inside the triangle

Tip

If a model contains polygons with more than 3 vertices Wrap implicitly stores a triangulated version of the model. Wrap uses naive fan triangulation with the fan origin at the first vertex of the polygon.

Tip

Barycentric coordinates is a way to encode point position inside a triangle with two numbers U and V. If a triangle has 3 vertices with 3D coordinates A, B and C, barycentric coordinates U and V defines a point in 3D which position is calculated like:

P = A * U + B * V + C * (1 - U - V)

Named Point On Triangle

The points are represented in the following JSON format:

{ "Point01" : [0, 0.3, 0.5], "Point02" : [1, 0.0, 1.0] }

3D-Point

This JSON format stores point coordinates in 3D space.

[ [ 0.1, 0.5, 1.2 ], [ 0.0, 1.7, 0.9 ] ]

This line stores two points. Each point is represented with 3 numbers:

  • X coordinate of the point

  • Y coordinate of the point

  • Z coordinate of the point