Datum Features
This section describes the Creo Object TOOLKIT Java 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.DatumPlaneFeatdata object.
Methods Introduced:
The properties of the pfcDatumPlaneFeat.DatumPlaneFeat object are described as follows:
•  Flip—Specifies whether the datum plane was flipped during creation. Use the method pfcDatumPlaneFeat.DatumPlaneFeat.GetFlip to determine if the datum plane was flipped during creation.
•  Constraints—Specifies a collection of constraints given by the pfcDatumPlaneFeat.DatumPlaneConstraint object. The method pfcDatumPlaneFeat.DatumPlaneFeat.GetConstraints obtains the collection of constraints defined for the datum plane.
Use the method pfcDatumPlaneFeat.DatumPlaneConstraint.GetConstraintType to obtain the type of constraint. The type of constraint is given by the pfcDatumPlaneFeat.DatumPlaneConstraintType enumerated type. The available types are as follows:
•  DTMPLN_THRU—Specifies the Through constraint. The pfcDatumPlaneFeat.DatumPlaneThroughConstraint object specifies this constraint. Use the method pfcDatumPlaneFeat.DatumPlaneThroughConstraint.
GetThroughRef
to get the reference selection handle for the Through constraint.
•  DTMPLN_NORM—Specifies the Normal constraint. The pfcDatumPlaneFeat.DatumPlaneNormalConstraint object specifies this constraint. Use the method
pfcDatumPlaneFeat.DatumPlaneNormalConstraint.GetNormalRef to get the reference selection handle for the Normal constraint.
•  DTMPLN_PRL—Specifies the Parallel constraint.
The pfcDatumPlaneFeat.DatumPlaneParallelConstraint object specifies this constraint. Use the method pfcDatumPlaneFeat.DatumPlaneParallelConstraint
.GetParallelRef
to get the reference selection handle for the Parallel constraint.
•  DTMPLN_TANG—Specifies the Tangent constraint. The pfcDatumPlaneFeat.DatumPlaneTangentConstraint object specifies this constraint. Use the method pfcDatumPlaneFeat.DatumPlaneTangentConstraint
.GetTangentRef
to get the reference selection handle for the Tangent constraint.
•  DTMPLN_OFFS—Specifies the Offset constraint. The pfcDatumPlaneFeat.DatumPlaneOffsetConstraint object specifies this constraint. Use the method
pfcDatumPlaneFeat.DatumPlaneOffsetConstraint
.GetOffsetRef
to get the reference selection handle for the Offset constraint. Use the method pfcDatumPlaneFeat.DatumPlaneOffsetConstraint.GetOffsetValue to get the offset value.
An Offset constraint where the offset reference is a coordinate system is given by the pfcDatumPlaneFeat.DatumPlaneOffsetCoordSysConstraint object. Use the method
pfcDatumPlaneFeat.DatumPlaneOffsetCoordSysConstraint
.GetCsysAxis
to get the reference coordinate axis.
•  DTMPLN_ANG—Specifies the Angle constraint. The pfcDatumPlaneFeat.
DatumPlaneAngleConstraint
object specifies this constraint. Use the method
pfcDatumPlaneFeat.DatumPlaneAngleConstraint
.GetAngleRef
to get the reference selection handle for the Angle constraint. Use the method pfcDatumPlaneFeat.DatumPlaneAngleConstraint
.GetAngleValue
to get the angle value.
•  DTMPLN_SEC—Specifies the Section constraint. The pfcDatumPlaneFeat.
DatumPlaneSectionConstraint
object specifies this constraint. Use the method
pfcDatumPlaneFeat.DatumPlaneSectionConstraint.
GetSectionRef
to get the reference selection for the Section constraint. Use the method pfcDatumPlaneFeat.DatumPlaneSectionConstraint
.GetSectionIndex
to get the section index.
Datum Axis Features
The properties of the Datum Axis feature are defined in the pfcDatumAxisFeat.DatumAxisFeat data object.
Methods Introduced:
The properties of the pfcDatumAxisFeat.DatumAxisFeat object are described as follows:
•  Constraints—Specifies a collection of constraints given by the pfcDatumAxisFeat.DatumAxisConstraint object. The method pfcDatumAxisFeat.DatumAxisFeat.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 pfcDatumAxisFeat.DatumAxisConstraintType enumerated type. The constraint type determines the type of datum axis. The constraint types are:
  DTMAXIS_NORMAL—Specifies the Normal datum constraint.
  DTMAXIS_THRU—Specifies the Through datum constraint.
  DTMAXIS_TANGENT—Specifies the Tangent datum constraint.
  DTMAXIS_CENTER—Specifies the Center datum constraint.
Use the method pfcDatumAxisFeat.DatumAxisConstraint.GetConstraintType to get the constraint type.
  ConstraintRef—Specifies the reference selection for the constraint. Use the method pfcDatumAxisFeat.DatumAxisConstraint.GetConstraintRef to get the reference selection handle.
•  DimConstraints—Specifies a collection of dimension constraints given by the pfcDatumAxisFeat.DatumAxisDimensionConstraint object. The method pfcDatumAxisFeat.DatumAxisFeat.GetDimConstraints obtains the collection of dimension constraints applied to the Datum Axis feature.
This pfcDatumAxisFeat.DatumAxisDimensionConstraint object contains the following attributes:
  DimOffset—Specifies the offset value for the dimension constraint. Use the method pfcDatumAxisFeat.DatumAxisDimensionConstraint.
GetDimOffset
to get the offset value.
  DimRef—Specifies the reference selection for the dimension constraint. Use the method pfcDatumAxisFeat.DatumAxisDimensionConstraint.GetDimRef to get the reference selection handle.
General Datum Point Features
The properties of the General Datum Point feature are defined in the pfcDatumPointFeat.DatumPointFeat data object.
Methods Introduced:
The properties of the pfcDatumPointFeat.DatumPointFeat object are described as follows:
•  FeatName—Specifies the name of the General Datum Point feature. Use the method pfcDatumPointFeat.DatumPointFeat.GetFeatName to get the name.
•  GeneralDatumPoints—Specifies a collection of general datum points given by the pfcDatumPointFeat.GeneralDatumPoint object. Use the method pfcDatumPointFeat.DatumPointFeat.GetPoints to obtain the collection of general datum points. The pfcDatumPointFeat.GeneralDatumPoint object consists of the following attributes:
  Name—Specifies the name of the general datum point. Use the method pfcDatumPointFeat.GeneralDatumPoint.GetName to get the name.
  PlaceConstraints—Specifies a collection of placement constraints given by the pfcDatumPointFeat.DatumPointPlacementConstraint object. Use the method pfcDatumPointFeat.GeneralDatumPoint.
GetPlaceConstraints
to obtain the collection of placement constraints.
  DimConstraints—Specifies a collection of dimension constraints given by the pfcDatumPointFeat.DatumPointDimensionConstraint object. Use the method pfcDatumPointFeat.GeneralDatumPoint.GetDimConstraints to obtain the collection of dimension constraints.
The constraints for a datum point are given by the pfcDatumPointFeat.DatumPoint
Constraint
object. This object contains the following attributes:
•  ConstraintRef—Specifies the reference selection for the datum point constraint. Use the method pfcDatumPointFeat.DatumPointConstraint.GetConstraintRef to get the reference selection handle.
•  ConstraintType—Specifies the type of datum point constraint. in terms of the pfcDatumPointFeat.DatumPointConstraintType enumerated type. Use the method pfcDatumPointFeat.DatumPointConstraint.GetConstraintType to get the constraint type.
•  Value—Specifies the constraint reference value with respect to the datum point. Use the method pfcDatumPointFeat.DatumPointConstraint.GetValue to get the value of the constraint reference with respect to the datum point.
The pfcDatumPointFeat.DatumPointPlacementConstraint and pfcDatumPointFeat.DatumPointDimensionConstraint objects inherit from the pfcDatumPointFeat.DatumPointConstraint object. Use the methods of the pfcDatumPointFeat.DatumPointConstraint object for the inherited objects.
Datum Coordinate System Features
The properties of the Datum Coordinate System feature are defined in the pfcCoordSysFeat.CoordSysFeat object.
Methods Introduced:
The properties of the pfcCoordSysFeat.CoordSysFeat object are described as follows:
•  OriginConstraints—Specifies a collection of origin constraints given by the pfcCoordSysFeat.DatumCsysOriginConstraint object. Use the method pfcCoordSysFeat.CoordSysFeat.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 pfcCoordSysFeat.DatumCsysOriginConstraint.GetOriginRef to get the selection reference handle.
•  DimensionConstraints—Specifies a collection of dimension constraints given by the pfcDatumCsysDimensionConstraint object. Use the method CoordSysFeat.pfcCoordSysFeat.CoordSysFeat.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 pfcCoordSysFeat.DatumCsysDimensionConstraint.GetDimRef to get the reference selection handle.
  DimValue—Specifies the value of the reference. Use the method pfcCoordSysFeat.DatumCsysDimensionConstraint.GetDimValue to get the value.
  DimConstraintType—Specifies the type of dimension constraint in terms of the pfcCoordSysFeat.DatumCsysDimConstraintType enumerated type. Use the method pfcCoordSysFeat.DatumCsysDimensionConstraint.
GetDimConstraintType
to get the constraint type. The constraint types are:
  DTMCSYS_DIM_OFFSET—Specifies the offset type constraint.
  DTMCSYS_DIM_ALIGN—Specifies the align type constraint.
•  OrientationConstraints—Specifies a collection of orientation constraints given by the pfcCoordSysFeat.DatumCsysOrientMoveConstraint object. Use the method pfcCoordSysFeat.CoordSysFeat.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 pfcCoordSysFeat.DatumCsysOrientMoveConstraintType enumerated type. Use the method pfcCoordSysFeat.DatumCsysOrientMoveConstraint.
GetOrientMoveConstraintType
to get the orientation type.
  OrientMoveValue—Specifies the reference value for the constraint. Use the method pfcCoordSysFeat.DatumCsysOrientMoveConstraint.
GetOrientMoveValue
to get the reference value.
•  IsNormalToScreen—Specifies if the coordinate system is normal to screen. Use the method pfcCoordSysFeat.CoordSysFeat.GetIsNormalToScreen to determine if the coordinate system is normal to screen.
•  OffsetType—Specifies the offset type of the coordinate system in terms of the pfcCoordSysFeat.DatumCsysOffsetType enumerated type. Use the method pfcCoordSysFeat.CoordSysFeat.GetOffsetType to get the offset type. The offset types are:
  DTMCSYS_OFFSET_CARTESIAN—Specifies a cartesian coordinate system that has been defined by setting the values for the DTMCSYS_MOVE_TRAN_X, DTMCSYS_MOVE_TRAN_Y, and DTMCSYS_MOVE_TRAN_Z or DTMCSYS_MOVE_ROT_X, DTMCSYS_MOVE_ROT_Y, and DTMCSYS_MOVE_ROT_Z orientation constants.
  DTMCSYS_OFFSET_CYLINDRICAL—Specifies a cylindrical coordinate system that has been defined by setting the values for the DTMCSYS_MOVE_RAD, DTMCSYS_MOVE_THETA, and DTMCSYS_MOVE_TRAN_ZI orientation constants.
  DTMCSYS_OFFSET_SPHERICAL—Specifies a spherical coordinate system that has been defined by setting the values for the DTMCSYS_MOVE_RAD, DTMCSYS_MOVE_THETA, and DTMCSYS_MOVE_TRAN_PHI orientation constants.
•  OnSurfaceType—Specifies the on surface type for the coordinate system in terms of the pfcCoordSysFeat.DatumCsysOffsetType enumerated type. Use the method pfcCoordSysFeat.CoordSysFeat.GetOnSurfaceType to get the on surface type property of the coordinate system. The on surface types are:
  DTMCSYS_ONSURF_LINEAR—Specifies a coordinate system placed on the selected surface by using two linear dimensions.
  DTMCSYS_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.
  DTMCSYS_ONSURF_DIAMETER—This type is similar to the DTMCSYS_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 pfcCoordSysFeat.DatumCsysOrientByMethod enumerated type. Use the method pfcCoordSysFeat.CoordSysFeat.GetOrientByMethod to get the orientation method. The available orientation types are:
  DTMCSYS_ORIENT_BY_SEL_REFS—Specifies the orientation by selected references.
  DTMCSYS_ORIENT_BY_SEL_CSYS_AXES—Specifies the orientation by corordinate system axes.