Brief Index      Full Index      Events Index      I.M. Reference

Compute_Polygon_Plane

Functions

HC_BOOLEAN Compute_Polygon_Plane (int count, const HC_POINT *points, const char *hand, HC_PLANE *out_plane)
HC_BOOLEAN DCompute_Polygon_Plane (int count, const HC_DPOINT *points, const char *hand, HC_DPLANE *out_plane)

Function Documentation

HC_BOOLEAN Compute_Polygon_Plane ( int  count,
const HC_POINT *  points,
const char *  hand,
HC_PLANE *  out_plane 
)
Parameters:
count- Number of xyz triplets in points
points- As in Insert_Polygon() , xyz triplets to specify the 3D vertices of the polygon. Must be coplanar.
hand- The definition order of the polygon --- "left" or "right".
out_plane- Plane equation parameters (a,b,c,d ). Returned to the caller.
Returns:
success

DETAILS

Compute_Polygon_Plane() is similar to Compute_Polygon_Normal() . The first three values are the polygon normal itself; the addition of the fourth value allows you to write the equation of the plane of the polygon in the form ax + by + cz + d = 0. If no plane can be found, false is returned and out_plane is unchanged.

NOTES

If this function fails, it is often for the same reasons that Compute_Polygon_Normal would as well.

RESTRICTIONS

See also:
Compute_Coordinates, Compute_Polygon_Normal, Compute_Transform, Set_Modelling_Matrix, Show_Device_Info, Show_Polygon, Show_Shell.
HC_BOOLEAN DCompute_Polygon_Plane ( int  count,
const HC_DPOINT *  points,
const char *  hand,
HC_DPLANE *  out_plane 
)

Similar to Compute_Polygon_Plane, but operates on double-precision data.

Parameters:
count- Number of xyz triplets in points
points- As in Insert_Polygon() , xyz triplets to specify the 3D vertices of the polygon. Must be coplanar.
hand- The definition order of the polygon --- "left" or "right".
out_plane- Plane equation parameters (a,b,c,d ). Returned to the caller.
Returns:
success

Brief Index      Full Index      Events Index      I.M. Reference