Visible Areas of Views
Functions Introduced:
• ProDrawingViewVisibleareaTypeGet()
• ProDrawingViewFullVisibleAreaSet()
• ProDrawingViewHalfVisibleAreaGet()
• ProDrawingViewHalfVisibleAreaSet()
• ProDrawingViewPartialVisibleAreaSet()
• ProDrawingViewPartialVisibleAreaGet()
• ProDrawingViewBrokenVisibleAreaGet()
• ProDrawingViewBrokenVisibleAreaSet()
• ProDrawingViewBrokenNumberGet()
As you detail your model, certain portions of the model may be more relevant than others or may be clearer if displayed from a different view point.
The function ProDrawingViewVisibleareaTypeGet() retrieves the type of visible area for a specified drawing view in terms of the enumerated type ProDrawingViewVisibleareaType. The visible area can be of the following types:
• PRO_VIEW_FULL_AREA—The complete drawing view is retained as the visible area.
• PRO_VIEW_HALF_AREA—A portion of the model from the view on one side of a cutting plane is removed.
• PRO_VIEW_PARTIAL_AREA—A portion of the model in a view within a closed boundary is displayed.
• PRO_VIEW_BROKEN_AREA—A portion of the model view from between two or more selected points is removed, and the gap between the remaining two portions is closed within a specified distance.
The function ProDrawingViewFullVisibleAreaSet() retains the specified drawing view as the full visible area.
The function ProDrawingViewHalfVisibleAreaGet()
The function ProDrawingViewHalfVisibleAreaSet()
• plane_ref—Specifies the selection reference in terms of the ProSelection object that divides the drawing view. The cutting plane can be a planar surface or a datum, but it must be perpendicular to the screen in the new view.
• keep_side—Specifies the half side of the model that is to be retained.
• line_standardProDrawingLineStandardType
◦ PRO_HVL_NONE—Specifies no line
◦ PRO_HVL_SOLID—Specifies a solid line.
◦ PRO_HVL_SYMMETRY—Specifies a symmetry line.
◦ PRO_HVL_SYMMETRY_ISO—Specifies an ISO-standard symmetry line.
◦ PRO_HVL_SYMMETRY_ASME—Specifies an ASME-standard symmetry line
The function ProDrawingViewPartialVisibleAreaGet() gets the partial visible area of a drawing view.
The function ProDrawingViewPartialVisibleAreaSet() assigns the following arguments to define the partial visible area for a specified drawing view:
• ref_point—ProSelection
• curve_data—ProCurvedata
• show_boundaryProBooleanPRO_B_TRUE
The function ProDrawingViewBrokenVisibleAreaGet() retrieves the broken visible area for a specified drawing view.
The function ProDrawingViewBrokenVisibleAreaSet() assigns the following arguments to define the broken visible area for a specified drawing view:
• dir—Specifies the direction of the broken lines that define the broken area to be removed. The direction is given by the enumerated type ProViewBrokenDir and takes the following values:
◦ PRO_VIEW_BROKEN_DIR_HORIZONTAL—Specifies the horizontal direction.
◦ PRO_VIEW_BROKEN_DIR_VERTICAL—Specifies the vertical direction.
• first_sel—Specifies the selection point in terms of the ProSelection object for the first break line.
• second_sel—Specifies the selection point in terms of the ProSelection object for the second break line.
• line_style—Specifies the line style for the broken lines in terms of the enumerated type ProViewBrokenLineStyle. It can be one of the following types:
◦ PRO_VIEW_BROKEN_LINE_STRAIGHT—Specifies a straight broken line.
◦ PRO_VIEW_BROKEN_LINE_SKETCH—Specifies a random sketch drawn by the user that defines the broken line.
◦ PRO_VIEW_BROKEN_LINE_S_CURVE_OUTLINE—Specifies a S-curve on the view outline.
◦ PRO_VIEW_BROKEN_LINE_S_CURVE_GEOMETRY—Specifies a S-curve on geometry.
◦ PRO_VIEW_BROKEN_LINE_HEART_BEAT_OUTLINE—Specifies a heartbeat type of curve on the view outline.
◦ PRO_VIEW_BROKEN_LINE_HEART_BEAT_GEOMETRY—Specifies a heartbeat type of curve on the geometry.
• curve_data—Specifies the spline curve data in terms of the ProCurvedata object when the line_style is of the type PRO_VIEW_BROKEN_LINE_SKETCH.
The function ProDrawingViewBrokenNumberGet() returns the number of breaks defined for the broken visible area. Two broken lines define one break.
|
Note:
|
A broken visible area can be created only for general and projected view types.
|
For the functions ProDrawingViewPartialVisibleAreaSet(), ProDrawingView2DSectionGet(), ProDrawingViewBrokenVisibleAreaGet(). ProDrawingViewPartialVisibleAreaGet(), ProDrawingViewDetailCurvedataGet(), and ProDrawingViewDetailCurvedataSet(), the output argument curve_data specifies the following::
• X, Y, and Z coordinate directions match the X, Y and Z of the world space.
• The coordinate points (0,0,0) maps to the detail view’s reference point
• The scaling unit is of one inch relative to the top model of the view.
To map the curve data to world space:
• Scale the spline by inch to top model unit.
• Scale the spline by top model unit to world unit, which is the scale of the transform from ProDrawingViewTransformGet() (view_to_drawing = TRUE),
• Translate the curve to place (0,0) at the reference point.
To map a spline in world space for use here, perform the inverse actions:
• Translate the spline by the reference point to place that point at (0,0).
• Scale by world-to-model (inverse of the scale of the view's transformation matrix)
• Scale by top-model-unit-to-inch.