Information Requests

This item describes a number of functions used by the application to get various information on the objects registered in the constraint system, or diagnostic and calculation results. These functions were designed for information requests, and their call does not change the state of the constraint system or its particular data.

Geometry type. You can request the type of the geometric object registered in the constraint system by calling the

geom_type GCE_GeomType(GCE_system gSys, geom_item g)

function, that returns the enumerative type of the g geometric object registered in the gSys system.

Returned values:

  • GCE_POINT is a 2D point;

  • GCE_LINE is a 2D line;

  • GCE_CIRCLE is a 2D circle;

  • GCE_ELLIPSE is a 2D ellipse;

  • GCE_SPLINE is a 2D spline;

  • GCE_PARAMETRIC_CURVE is a general 2D parametric curve;

  • GCE_BOUNDED_CURVE is a curve bounded by end points.

The list of data request functions is given below.

The base curve type is returned by the

geom_type GCE_BaseCurveType(GCE_system gSys, geom_item crv)

Connectivity with constraints is evaluated by the

bool GCE_IsConstrainedGeom(GCE_system gSys, geom_item g )

Constraint satisfaction is evaluated by the

bool GCE_IsSatisfied(GCE_system gSys, constraint_item cItem)

Degenerated geometric objects are returned by the

std::vector<geom_item> GCE_DiagnoseGeometry(GCE_system gcSys)

Compliance of the control point with the given coordinates is assessed by the

double GCE_DimensionParameter(GCE_system gSys, constraint_item dItem)

The current constraint solution state is returned by the

bool GCE_CheckPointSatisfaction(GCE_system gSys, geom_item pnt
                                 , point_type cp
                                 , double px
                                 , double py)

The current constraint solution state is returned by the

GcConState GCE_GetConstraintState(GCE_system, constraint_item gc_item).

The state of the constraint system according to the latest solution results is returned by the

GcConstraintStatus GCE_GetConstraintStatus(GCE_system gSys).