Measurement
Functions Introduced:
The function
ProSurfaceAreaEval() evaluates the surface areas of a specified surface. It is not valid for datum planes.
Function
ProContourAreaEval() outputs the inside surface area of a specified outer contour. Note it takes into account internal voids.
The function
ProSurfaceExtremesEval() finds the coordinates of the face edges at the extremes in the specified direction. The accuracy of the result is limited to the accuracy of edge tessellation.
Function
ProSurfacePrincipalCrvtEval() outputs the curvatures and directions of the specified surface at a given UV point. The
u and
v values are obtained by specifying the projection type as
PRO_SRFTESS_NO_PROJECTION for the function
ProSurfacetessellationinputUvprojectionSet().
The function
ProEdgeLengthEval() evaluates the length of a solid edge, and
ProCurveLengthEval() does the same for a datum curve.
Function
ProEdgeLengthT1T2Eval() finds the length of a specified edge between two parameters. Use function
ProCurveLengthT1T2Eval() to do the same for a curve.
ProEdgeParamByLengthEval() finds the parameter value of the point located a given length from the specified start parameter. Use function
ProCurveParamByLengthEval() to do the same for a curve.
The function
ProGeomitemDistanceEval() measures the distance between two geometry items. The geometry items are expressed as
ProSelection objects, so you can specify any two objects in an assembly. Each object can be an axis, plane surface, or datum point.
The function
ProGeomitemAngleEval() measures the angle between two geometry items expressed as
ProSelection objects. Both objects must be straight, solid edges.
The function
ProSurfaceDiameterEval() measures the diameter of a surface, expressed as a
ProSelection object. The surface type must be one of the following:
• Cylinder—The cylinder radius
• Torus—The distance from the axis to the generating arc
• Cone—The distance of the point specified from the axis
• Surface of revolution—The distance of the point specified from the axis
The
u and
v values are obtained by specifying the projection type as
PRO_SRFTESS_NO_PROJECTION for the function
ProSurfacetessellationinputUvprojectionSet().
|
Note:
|
In the case of a sphere made by revolving an arc, the Creo Parametric command > gives the real spherical diameter, whereas ProGeomitemDiameterEval() gives the distance of the specified point from the axis of revolution. |
The functions
ProContourBoundbox2dCompute() and
ProContourBoundbox3dCompute() output a bounding box for the inside surface of the specified outer contour.
|
Note:
|
• The outline returned by the function ProContourBoundbox3dCompute() represents the outline box used by Creo Parametric embedded algorithms, and hence it can be slightly bigger than the outline computed directly from the surface parameters.
|
The function
ProSelectionWithOptionsDistanceEval() evaluates the distance between two items. You can evaluate distance between surfaces, edges, entities, vertices, curves, datums, and so on. The initial selection of the item is used to guess the type of geometry. In case of error types
PRO_TK_BAD_INPUTS or
PRO_TK_BAD_CONTEXT, the output argument
p_result is set to
-1.0 and all parameters are set to
0.0.
The input arguments option1 and option2 are analogous to Options in the Measure dialog box in Creo Parametric user interface. You can specify PRO_B_TRUE if you want to turn on the following options for the selected items:
• If the selected item is a cylindrical surface, measures the distance from the central axis of the cylindrical surface. Specify PRO_B_FALSE to measure from the surface instead of the axis.
• If the selected item is an arc, measures the distance from the center of a circle or an arc-shaped curve or edge. Specify PRO_B_FALSE to measure from the edge instead of the center.
• If the selected item is a planar surface or a plane, extends the selected surface or plane to infinity in both directions only for the purpose of measuring distance. You can now measure the distance normal to the reference entity.
• If the selected item is linear, extends the selected straight edge or curve to infinity in both directions only for the purpose of measuring distance. You can now measure the distance normal to the reference entity.
The output arguments return the following values:
• p_result—Distance between the two items
• pnt_1 and pnt_2—Critical point for the first and second selected items. Critical point is the actual point used for measurement.
• param_1 and param_2—UV parameter of the critical point for the first and second selected items