# Points
```{eval-rst}
.. py:function:: createPoint(Pnt)
    :nocontentsentry:

    Point: Create a point

    |  Alias: pnt
    |  Constraints: Not referenced

    :param Point Pnt: Coordinates: Coordinates of the point. 
    :rtype: Return a GeomPoint
```

```{eval-rst}
.. py:function:: createPoint(Vector, VertexRef)
    :nocontentsentry:

    Point: Create a point

    |  Alias: pnt
    |  Constraints: Referenced

    :param Point Vector: Vector: Vector with origin in reference point. 
    :param Entity VertexRef: Reference point: Reference point to create the new point. Conditions: "" does not exist in the dropdown list. The input must be non-empty.
    :rtype: Return a GeomPoint
```

```{eval-rst}
.. py:function:: createPoint(GeomName, Pnt)
    :nocontentsentry:

    Point: Create a point

    |  Alias: pnt
    |  Constraints: Not referenced

    :param str GeomName: Name. Conditions: "" input must be non-empty.
    :param Point Pnt: Coordinates: Coordinates of the point. 
    :rtype: Return a GeomPoint
```

```{eval-rst}
.. py:function:: createPoint(GeomName, Vector, VertexRef)
    :nocontentsentry:

    Point: Create a point

    |  Alias: pnt
    |  Constraints: Referenced

    :param str GeomName: Name. Conditions: "" input must be non-empty.
    :param Point Vector: Vector: Vector with origin in reference point. 
    :param Entity VertexRef: Reference point: Reference point to create the new point. Conditions: "" does not exist in the dropdown list. The input must be non-empty.
    :rtype: Return a GeomPoint
```

*Example:*
```{code-block} python
# -*- coding: utf-8 -*-
# Example: Creating a geometric point entity

# --- Non-referenced mode ---
# In this mode, the point is created directly from coordinates.

point_geom_entity = createPoint("Point", Point(0, 0, 0))

# --- Referenced mode ---
# In this mode, the new point entity references another existing point entity.
# This is useful when creating hierarchical or dependent geometry relationships.

point_geom_entity = createPoint("Point (2)", Point(1, 0, 0), point_geom_entity)

# Result:
#   - "Point" is created at (0, 0, 0)
#   - "Point (2)" is created at (1, 0, 0) and references the previous one


```
```{eval-rst}
.. py:function:: createPointOnCurve(CurveRef, UParam)
    :nocontentsentry:

    On curve: Create a point on a curve

    |  Alias: pntOnCurve

    :param POCCGeomLine CurveRef: Curve: Curve on which the point will be created. Conditions: The input must be non-empty. "" does not exist in the dropdown list.
    :param Double UParam: UParam: U parameter that determines the position of the point on the geometric entity. 
    :rtype: Return a GeomPoint
```

```{eval-rst}
.. py:function:: createPointOnCurve(GeomName, CurveRef, UParam)
    :nocontentsentry:

    On curve: Create a point on a curve

    |  Alias: pntOnCurve

    :param str GeomName: Name. Conditions: "" input must be non-empty.
    :param POCCGeomLine CurveRef: Curve: Curve on which the point will be created. Conditions: The input must be non-empty. "" does not exist in the dropdown list.
    :param Double UParam: UParam: U parameter that determines the position of the point on the geometric entity. 
    :rtype: Return a GeomPoint
```

*Example:*
```{code-block} python
# -*- coding: utf-8 -*-
# Example: Creating a point along a line (curve parameter)

# First, create a line geometry entity
line_geom_entity = createLine("Curve", Point(0, 0, 0), Point(1, 0, 0))

u_param = 1.0  # Position along the curve where the point will be created

# Create a point located at the specified parameter on the curve
point_geom_entity = createPointOnCurve("Point", line_geom_entity, u_param)

# Result:
#   - A point is created at the end of the line (since u_param = 1.0)
#   - For u_param = 0.5, the point would be located at the midpoint


```
```{eval-rst}
.. py:function:: createPointOnFace(SurfaceRef, UParam, VParam)
    :nocontentsentry:

    On surface: Create a point on a surface

    |  Alias: pntOnFace

    :param POCCQuad SurfaceRef: Face: Face on which the point will be created. Conditions: The input must be non-empty. "" does not exist in the dropdown list.
    :param Double UParam: UParam: U parameter that determines the position of the point on the geometric entity. 
    :param Double VParam: VParam: V parameter that determines the position of the point on the geometric entity. 
    :rtype: Return a GeomPoint
```

```{eval-rst}
.. py:function:: createPointOnFace(GeomName, SurfaceRef, UParam, VParam)
    :nocontentsentry:

    On surface: Create a point on a surface

    |  Alias: pntOnFace

    :param str GeomName: Name. Conditions: "" input must be non-empty.
    :param POCCQuad SurfaceRef: Face: Face on which the point will be created. Conditions: The input must be non-empty. "" does not exist in the dropdown list.
    :param Double UParam: UParam: U parameter that determines the position of the point on the geometric entity. 
    :param Double VParam: VParam: V parameter that determines the position of the point on the geometric entity. 
    :rtype: Return a GeomPoint
```

*Example:*
```{code-block} python
# -*- coding: utf-8 -*-
# Example: Creating a point on a surface using (u, v) parameters

# First, create a quad surface geometry entity
quad_geom_entity = createQuad(
    "Surface",
    Point(0, 0, 0),
    Point(1, 0, 0),
    Point(1, 1, 0),
    Point(0, 1, 0)
)

# Define the surface parameters (0.0 to 1.0 along u and v directions)
u_param = 1.0  # U-direction parameter
v_param = 1.0  # V-direction parameter

# Create a point located on the surface at (u_param, v_param)
point_geom_entity = createPointOnFace("Point", "Surface", u_param, v_param)

# Result:
#   - A point is created at the corner of the quad corresponding to u=1, v=1
#   - Changing u_param or v_param moves the point along the surface


```