Datum Features
This section describes the Creo Object TOOLKIT C++ methods that provide read access to the properties of datum features.
Datum Plane Features
The properties of the Datum Plane feature are defined in the pfcDatumPlaneFeat data object.
Methods Introduced:
  • pfcDatumPlaneFeat::GetFlip
    		•
  • pfcDatumPlaneFeat::GetConstraints
    		•
  • pfcDatumPlaneConstraint::GetConstraintType
    		•
  • pfcDatumPlaneThroughConstraint::GetThroughRef
    		•
  • pfcDatumPlaneNormalConstraint::GetNormalRef
    		•
  • pfcDatumPlaneParallelConstraint::GetParallelRef
    		•
  • pfcDatumPlaneTangentConstraint::GetTangentRef
    		•
  • pfcDatumPlaneOffsetConstraint::GetOffsetRef
    		•
  • pfcDatumPlaneOffsetConstraint::GetOffsetValue
    		•
  • pfcDatumPlaneOffsetCoordSysConstraint::GetCsysAxis
    		•
  • pfcDatumPlaneAngleConstraint::GetAngleRef
    		•
  • pfcDatumPlaneAngleConstraint::GetAngleValue
    		•
  • pfcDatumPlaneSectionConstraint::GetSectionRef
    		•
  • pfcDatumPlaneSectionConstraint::GetSectionIndex
    		•
    The properties of the pfcDatumPlaneFeat object are described as follows:
    •  Flip—Specifies whether the datum plane was flipped during creation. Use the method pfcDatumPlaneFeat::GetFlip to determine if the datum plane was flipped during creation.
    •  Constraints—Specifies a collection of constraints given by the pfcDatumPlaneConstraint object. The method pfcDatumPlaneFeat::GetConstraints obtains the collection of constraints defined for the datum plane.
    Use the method pfcDatumPlaneConstraint::GetConstraintType to obtain the type of constraint. The type of constraint is given by the pfcDatumPlaneConstraintType enumerated type. The available types are as follows:
    •  pfcDTMPLN_THRU—Specifies the Through constraint. The pfcDatumPlaneThroughConstraint object specifies this constraint. Use the method pfcDatumPlaneThroughConstraint::GetThroughRef to get the reference selection handle for the Through constraint.
    •  pfcDTMPLN_NORM—Specifies the Normal constraint. The pfcDatumPlaneNormalConstraint object specifies this constraint. Use the method pfcDatumPlaneNormalConstraint::GetNormalRef to get the reference selection handle for the Normal constraint.
    •  pfcDTMPLN_PRL—Specifies the Parallel constraint. The pfcDatumPlaneParallelConstraint object specifies this constraint. Use the method pfcDatumPlaneParallelConstraint::GetParallelRef to get the reference selection handle for the Parallel constraint.
    •  pfcDTMPLN_TANG—Specifies the Tangent constraint. The pfcDatumPlaneTangentConstraint object specifies this constraint. Use the method pfcDatumPlaneTangentConstraint::GetTangentRef to get the reference selection handle for the Tangent constraint.
    •  pfcDTMPLN_OFFS—Specifies the Offset constraint. The pfcDatumPlaneOffsetConstraint object specifies this constraint. Use the method pfcDatumPlaneOffsetConstraint::GetOffsetRef to get the reference selection handle for the Offset constraint. Use the method pfcDatumPlaneOffsetConstraint::GetOffsetValue to get the offset value.
    An Offset constraint where the offset reference is a coordinate system is given by the pfcDatumPlaneOffsetCoordSysConstraint object. Use the method pfcDatumPlaneOffsetCoordSysConstraint::GetCsysAxis to get the reference coordinate axis.
    •  pfcDTMPLN_ANG—Specifies the Angle constraint. The pfcDatumPlaneAngleConstraint object specifies this constraint. Use the method pfcDatumPlaneAngleConstraint::GetAngleRef to get the reference selection handle for the Angle constraint. Use the method pfcDatumPlaneAngleConstraint::GetAngleValue to get the angle value.
    •  pfcDTMPLN_SEC—Specifies the Section constraint. The pfcDatumPlaneSectionConstraint object specifies this constraint. Use the method pfcDatumPlaneSectionConstraint::GetSectionRef to get the reference selection for the Section constraint. Use the method pfcDatumPlaneSectionConstraint::GetSectionIndex to get the section index.
    Datum Axis Features
    The properties of the Datum Axis feature are defined in the pfcDatumAxisFeat data object.
    Methods Introduced:
  • pfcDatumAxisFeat::GetConstraints
    		•
  • pfcDatumAxisConstraint::GetConstraintType
    		•
  • pfcDatumAxisConstraint::GetConstraintRef
    		•
  • pfcDatumAxisFeat::GetDimConstraints
    		•
  • pfcDatumAxisDimensionConstraint::GetDimOffset
    		•
  • pfcDatumAxisDimensionConstraint::GetDimRef
    		•
    The properties of the pfcDatumAxisFeat object are described as follows:
    •  Constraints—Specifies a collection of constraints given by the pfcDatumAxisConstraint object. The method pfcDatumAxisFeat::GetConstraints obtains the collection of constraints applied to the Datum Axis feature.
    This object contains the following attributes:
    ○  ConstraintType—Specifies the type of constraint in terms of the pfcDatumAxisConstraintType enumerated type. The constraint type determines the type of datum axis. The constraint types are:
    ◆  pfcDTMAXIS_NORMAL—Specifies the Normal datum constraint.
    ◆  pfcDTMAXIS_THRU—Specifies the Through datum constraint.
    ◆  pfcDTMAXIS_TANGENT—Specifies the Tangent datum constraint.
    ◆  pfcDTMAXIS_CENTER—Specifies the Center datum constraint.
    Use the method pfcDatumAxisConstraint::GetConstraintType to get the constraint type.
    ○  ConstraintRef—Specifies the reference selection for the constraint. Use the method pfcDatumAxisConstraint::GetConstraintRef to get the reference selection handle.
    •  DimConstraints—Specifies a collection of dimension constraints given by the pfcDatumAxisDimensionConstraint object. The method pfcDatumAxisFeat::GetDimConstraints obtains the collection of dimension constraints applied to the Datum Axis feature.
    The pfcDatumAxisDimensionConstraint object contains the following attributes:
    ○  DimOffset—Specifies the offset value for the dimension constraint. Use the method pfcDatumAxisDimensionConstraint::GetDimOffset to get the offset value.
    ○  DimRef—Specifies the reference selection for the dimension constraint. Use the method pfcDatumAxisDimensionConstraint::GetDimRef to get the reference selection handle.
    General Datum Point Features
    The properties of the General Datum Point feature are defined in the pfcDatumPointFeat data object.
    Methods Introduced:
  • pfcDatumPointFeat::GetFeatName
    		•
  • pfcDatumPointFeat::GetPoints
    		•
  • pfcGeneralDatumPoint::GetName
    		•
  • pfcGeneralDatumPoint::GetPlaceConstraints
    		•
  • pfcGeneralDatumPoint::GetDimConstraints
    		•
  • pfcDatumPointConstraint::GetConstraintRef
    		•
  • pfcDatumPointConstraint::GetConstraintType
    		•
  • pfcDatumPointConstraint::GetValue
    		•
    The properties of the pfcDatumPointFeat object are described as follows:
    •  FeatName—Specifies the name of the General Datum Point feature. Use the method pfcDatumPointFeat::GetFeatName to get the name.
    •  GeneralDatumPoints—Specifies a collection of general datum points (given by the pfcGeneralDatumPoint object). Use the method pfcDatumPointFeat::DatumPointFeat.GetPoints to obtain the collection of general datum points. The pfcGeneralDatumPoint object consists of the following attributes:
    ○  Name—Specifies the name of the general datum point. Use the method pfcGeneralDatumPoint::GetName to get the name.
    ○  PlaceConstraints—Specifies a collection of placement constraints given by the pfcDatumPointPlacementConstraint object. Use the method pfcGeneralDatumPoint::GetPlaceConstraints to obtain the collection of placement constraints.
    ○  DimConstraints—Specifies a collection of dimension constraints given by the pfcDatumPointDimensionConstraint object. Use the method pfcGeneralDatumPoint::GetDimConstraints to obtain the collection of dimension constraints.
    The constraints for a datum point are given by the pfcDatumPointConstraint object. This object contains the following attributes:
    •  ConstraintRef—Specifies the reference selection for the datum point constraint. Use the method to get the reference selection handle.
    •  ConstraintType—Specifies the type of datum point constraint. in terms of the pfcDatumPointConstraintType enumerated type. Use the method pfcDatumPointConstraint::GetConstraintType to get the constraint type.
    •  Value—Specifies the constraint reference value with respect to the datum point. Use the method pfcDatumPointConstraint::GetValue to get the value of the constraint reference with respect to the datum point.
    The pfcDatumPointPlacementConstraint and pfcDatumPointDimensionConstraint objects inherit from the pfcDatumPointConstraint object. Use the methods of the pfcDatumPointConstraint object for the inherited objects.
    Datum Coordinate System Features
    The properties of the Datum Coordinate System feature are defined in the pfcCoordSysFeat object.
    Methods Introduced:
  • pfcCoordSysFeat::GetOriginConstraints
    		•
  • pfcDatumCsysOriginConstraint::GetOriginRef
    		•
  • pfcCoordSysFeat::GetDimensionConstraints
    		•
  • pfcDatumCsysDimensionConstraint::GetDimRef
    		•
  • pfcDatumCsysDimensionConstraint::GetDimValue
    		•
  • pfcDatumCsysDimensionConstraint::GetDimConstraintType
    		•
  • pfcCoordSysFeat::GetOrientationConstraints
    		•
  • pfcDatumCsysOrientMoveConstraint::GetOrientMoveConstraintType
    		•
  • pfcDatumCsysOrientMoveConstraint::GetOrientMoveValue
    		•
  • pfcCoordSysFeat::GetIsNormalToScreen
    		•
  • pfcCoordSysFeat::GetOffsetType
    		•
  • pfcCoordSysFeat::GetOnSurfaceType
    		•
  • pfcCoordSysFeat::GetOrientByMethod
    		•
    The properties of the pfcCoordSysFeat object are described as follows:
    •  OriginConstraints—Specifies a collection of origin constraints given by the pfcDatumCsysOriginConstraint object. Use the method pfcCoordSysFeat::GetOriginConstraints to obtain the collection of origin constraints for the coordinate system. This object contains the following attribute:
    ○  OriginRef—Specifies the selection reference for the origin. Use the method pfcDatumCsysOriginConstraint::GetOriginRef to get the selection reference handle.
    •  DimensionConstraints—Specifies a collection of dimension constraints (given by the pfcDatumCsysDimensionConstraint object). Use the method pfcCoordSysFeat::GetDimensionConstraints to obtain the collection of dimension constraints for the coordinate system. This object contains the following attributes:
    ○  DimRef—Specifies the reference selection for the dimension constraint. Use the method pfcDatumCsysDimensionConstraint::GetDimRef to get the reference selection handle.
    ○  DimValue—Specifies the value of the reference. Use the method pfcDatumCsysDimensionConstraint::GetDimValue to get the value.
    ○  DimConstraintType—Specifies the type of dimension constraint in terms of the pfcDatumCsysDimConstraintType enumerated type. Use the method pfcDatumCsysDimensionConstraint::
    GetDimConstraintType     to get the constraint type. The constraint types are:
    ◆  pfcDTMCSYS_DIM_OFFSET—Specifies the offset type constraint.
    ◆  pfcDTMCSYS_DIM_ALIGN—Specifies the align type constraint.
    •  OrientationConstraints—Specifies a collection of orientation constraints (given by the CoordSysFeat.DatumCsysOrientMoveConstraint object). Use the method pfcCoordSysFeat::GetOrientationConstraints to obtain the collection of orientation constraints for the coordinate system. This object contains the following attributes:
    ○  OrientMoveConstraintType—Specifies the type of orientation for the constraint. The orientation type is given by the pfcDatumCsysOrientMoveConstraintType enumerated type. Use the method pfcDatumCsysOrientMoveConstraint::
    GetOrientMoveConstraintType     to get the orientation type.
    ○  OrientMoveValue—Specifies the reference value for the constraint. Use the method pfcDatumCsysOrientMoveConstraint::
    GetOrientMoveValue     to get the reference value.
    •  IsNormalToScreen—Specifies if the coordinate system is normal to screen. Use the method pfcCoordSysFeat::GetIsNormalToScreen to determine if the coordinate system is normal to screen.
    •  OffsetType—Specifies the offset type of the coordinate system in terms of the pfcDatumCsysOffsetType enumerated type. Use the method pfcCoordSysFeat::GetOffsetType to get the offset type. The offset types are:
    ○  pfcDTMCSYS_OFFSET_CARTESIAN—Specifies a cartesian coordinate system that has been defined by setting the values for the pfcDTMCSYS_MOVE_TRAN_X, pfcDTMCSYS_MOVE_TRAN_Y, and pfcDTMCSYS_MOVE_TRAN_Z or pfcDTMCSYS_MOVE_ROT_X, pfcDTMCSYS_MOVE_ROT_Y, and pfcDTMCSYS_MOVE_ROT_Z orientation constants.
    ○  pfcDTMCSYS_OFFSET_CYLINDRICAL—Specifies a cylindrical coordinate system that has been defined by setting the values for the pfcDTMCSYS_MOVE_RAD, pfcDTMCSYS_MOVE_THETA, and pfcDTMCSYS_MOVE_TRAN_ZI orientation constants.
    ○  pfcDTMCSYS_OFFSET_SPHERICAL—Specifies a spherical coordinate system that has been defined by setting the values for the pfcDTMCSYS_MOVE_RAD, pfcDTMCSYS_MOVE_THETA, and pfcDTMCSYS_MOVE_TRAN_PHI orientation constants.
    •  OnSurfaceType—Specifies the on surface type for the coordinate system in terms of the pfcDatumCsysOffsetType enumerated type. Use the method pfcCoordSysFeat::GetOnSurfaceType to get the on surface type property of the coordinate system. The on surface types are:
    ○  pfcDTMCSYS_ONSURF_LINEAR—Specifies a coordinate system placed on the selected surface by using two linear dimensions.
    ○  pfcDTMCSYS_ONSURF_RADIAL—Specifies a coordinate system placed on the selected surface by using a linear dimension and an angular dimension. The radius value is used to specify the linear dimension.
    ○  pfcDTMCSYS_ONSURF_DIAMETER—This type is similar to the pfcDTMCSYS_ONSURF_RADIAL type, except that the diameter value is used to specify the linear dimension. It is available only when planar surfaces are used as the reference.
    •  OrientByMethod—Specifies the orientation method in terms of the pfcDatumCsysOrientByMethod enumerated type. Use the method pfcCoordSysFeat::GetOrientByMethod to get the orientation method. The available orientation types are:
    ○  pfcDTMCSYS_ORIENT_BY_SEL_REFS—Specifies the orientation by selected references.
    ○  pfcDTMCSYS_ORIENT_BY_SEL_CSYS_AXES—Specifies the orientation by corordinate system axes.