# Points

A point is a zero-dimensional geometric entity.

A free point is a zero-dimensional geometry entity in space that is not associated with a surface. It is displayed as a small "x", and its color is determined by the component collector to which it belongs. These types of points are typically used for weld locations and connectors.

A fixed point is a zero-dimensional geometry entity that is associated with a surface. It is displayed as a small "o", and its color is determined by the surface to which it is associated. The automesher places a node at each fixed point on the surface being meshed. A fixed point that is placed at the junction of three or more non-suppressed edges is called a vertex or vertex point. Such vertices cannot be suppressed (removed).

## Create Points

### Create Free Points

• xyz - Creates free points by specifying (x,y,z) coordinates (Points panel).
• arc center - Creates at the center of the arc that best approximates the input set of nodes, points or lines (Points panel).
• extract parametric - Creates free points at parametric locations on lines and surfaces (Points panel).
• intersect - Creates free points at the intersection of geometric entities: lines/lines, lines/surfaces, lines/solids, lines/planes, vector/lines, vector/surfaces, vector/solids and vector/plane (Points panel).
• suppressed fixed points - Creates free points at suppressed fixed point locations (Point Edit panel).
• circle center - Creates free points at the center of the circle defined by three free or fixed points (Distance panel).
• duplicate - Creates free points by duplicating existing free or fixed points. This is available in many panels when the "duplicate" advanced entity selector is available on a points collector.
• Misc. API commands that do not have an associated panel.

### Create Fixed Points

• by cursor - Creates fixed points at cursor locations on surfaces and surface edges (Point Edit panel, Quick Edit panel).
• on edge - Creates fixed points at uniform locations on a surface edge (Point Edit panel, Quick Edit panel).
• on surface - Creates fixed points at existing node/free point locations on/near a surface (Point Edit panel).
• project - Creates fixed points on surface edges by projecting existing free or fixed points (Point Edit panel, Quick Edit panel).
• defeature pinholes - When defeaturing pinholes, fixed points are created at the center of the each removed pinhole (Defeature panel).
• Misc. API commands that do not have an associated panel.

## Edit Points

### Edit Free Points

• delete - Deletes free points (Delete panel).
• translate - Moves free points along a vector direction (Translate panel).
• rotate - Rotates free points about a vector axis (Rotate panel).
• scale - Scales the dimensions of free points either proportionally or uniformly (Scale panel).
• reflect - Reflects free points about a plane to create a mirror image (Reflect panel).
• project - Projects free points onto a plane, vector, line/surface edge or surface (Project panel).
• position - Translates and rotate free points into new positions (Position panel).
• permute - Switches the coordinates of free points (Permute panel).
• renumber - Renumbers free points (Renumber panel).
• Misc. API commands that do not have an associated panel.

### Edit Fixed Points

• suppress/remove - Suppresses non-vertex fixed points (Point Edit panel, Quick Edit panel).
• replace - Combines multiple fixed points by moving them to one fixed point location (Point Edit panel, Quick Edit panel).
• release - Releases fixed point vertices such that any shared edges attached to the point become free edges (Point Edit panel, Quick Edit panel).
• renumber - Renumbers fixed points (Renumber panel).
• Misc. API commands that do not have an associated panel.

## Query Points

### Query Free Points

• distance - Finds the distance between two free points (Distance panel).
• shortest distance - Finds the shortest distance between entities (Shortest Distance dialog).
• angle - Finds the angle between three free points (Distance panel).
• organize - Moves free points into different component collectors (Organize panel).
• numbers - Displays the IDs of free points (Numbers panel).
• count - Counts the total or displayed free points (Count panel).
• Misc. API commands that do not have an associated panel.

### Query Fixed Points

• distance - Finds the distance between two fixed points (Distance panel).
• shortest distance - Finds the shortest distance between entities (Shortest Distance dialog).
• angle - Finds the angle between three fixed points (Distance panel).
• numbers - Displays the IDs of fixed points (Numbers panel).
• count - Counts the total or displayed fixed points (Count panel).
• Misc. API commands that do not have an associated panel.