Diagnostic codes of a solution

The table below lists the codes that output calculation results or results of executing the GCM API component function. These values are results of such calls as GCM_Evaluate, GCM_EvaluationResult, GCM_SolveReposition.

Table 1 - Enumeration type values GCM_result

Resulting codes of executing the API solver functions
GCM_RESULT_None	No result. For the call GCM_EvaluationResult it means that the constraint has not been calculated yet.
GCM_RESULT_Ok	Executed successfully. The result of successful execution of an operation or successful calculation of constraints.
GCM_RESULT_ItsNotDrivingDimension	Not driving dimension. Failed attempt of the GCM_ChangeDrivingDimension call for a constraint which is not a driving dimension.
GCM_RESULT_Unregistered	Invalid descriptor of an object or constraint. Case: Calling API with a descriptor that does not belong to the constraint system.
GCM_RESULT_Aborted	Calculations aborted by the user request.
GCM_RESULT_InternalError GCM_RESULT_Error	Program error (not mathematic). For situations related to incorrect completion of an operation or incorrect data.
Results of the constraint system calculation
GCM_RESULT_Satisfied	The constraint or constraint system has been satisfied.
GCM_RESULT_Overconstrained	The constraint redefines the model. The error occurs in the event of conflicting constraints (Inconsistent constraint system) within an over-defined constraint system (Overdefined constraint system).
GCM_RESULT_Unsolvable	Unresolvable constraints. The error occurs in various situations when no solution can be found. Generally, it is caused by a set of constraints that cannot be satisfied simultaneously (Inconsistent constraint system), or when a dimension is outside the range of acceptable values.
GCM_RESULT_Not_Satisfied	The constraint is not satisfied. The error code is returned when constraints cannot be solved. Probable causes of the failure: - A dimension is outside the range of values making a solution possible; - Positions of fixed or frozen objects are outside the range of values making a solution possible; - In rare cases, it is caused by poor initial approximation. Satisfying the constraints requires considerable changes in parametric coordinates; - Strong mutual influences. For example, for such conditions if an angle is changed by one degree, then the object would be offset to a considerable distance; - In rare cases, numeric instability due to wide scattering of the order of coordinates being calculated. For example, a geometric model includes both microscopic objects (1e-3) and large objects (1e+6); - In the general case, this can be caused by other situations when the solution does not exist or cannot be calculated.
GCM_RESULT_MatedFixation	A geometric constraint is added between fixed or frozen objects.
GCM_RESULT_InvalidArguments	Constraint arguments are not defined. Incorrectly defined constraint when its arguments are empty (argument descriptor = GCM_NULL).
GCM_RESULT_IncompatibleArguments	Incompatible arguments for this constraint type. Incorrectly defined constraint when its arguments are incompatible or this combination of arguments is not supported. For example, an attempt to set the coincidence of a plane and a cylinder.
GCM_RESULT_InappropriateArgument	The argument type cannot be used for this constraint. An incorrectly defined constraint when one of its arguments cannot be used for this constraint type. For example, an attempt to make points and spheres parallel makes no sense.
GCM_RESULT_Duplicated	Duplicate constraint. The code indicates that the constraint system contains two identical constraints. In general, this situation does not make it impossible to calculate constraints.
Diagnostic situations for the GCM_DEPENDED constraint
GCM_RESULT_DraggingFailed
GCM_RESULT_InappropriateAlignment
GCM_RESULT_InconsistentAngleType
GCM_RESULT_InconsistentAlignment
mtResCode_UnsupportedTangencyChoice
mtResCode_IsNoPossibleForCircTanChoice
GCM_RESULT_InconsistentPlanarAngle
Diagnostic codes for mechanical transmissions
GCM_RESULT_DependentConstraintUnsolved
GCM_RESULT_CyclicDependence
GCM_RESULT_MultiDependedGeom
GCM_RESULT_OverconstrainingDependedGeoms
mtResCode_InvalidDependenceForFixGeom
Diagnostic codes for mechanical transmissions
mtResCode_CoaxialMtGearTransmissionIsNotAvalable
mtResCode _NoSeparatedSolutionForCamGear
mtResCode_CyclicDependenceForTwoOrMoreCamGears
mtResCode_InconsistentFollowerAxis