Rhino C++ API
8.10
|
#include <opennurbs_plus_hiddenline.h>
Public Member Functions | |
ON_HiddenLineDrawing () | |
ON_HiddenLineDrawing (const ON_HiddenLineDrawing &) | |
ON_HiddenLineDrawing (double absoluteTolerance) | |
~ON_HiddenLineDrawing () | |
double | AbsoluteTolerance () const |
ON_SimpleArray< ON__UINT_PTR > | ActiveClipIds (const class ON_HLD_Object &obj) const |
bool | AddClippingPlane (ON_PlaneEquation clip, ON__UINT_PTR clip_id=0) |
bool | AddClippingPlanes (const ON_PlaneEquation *clip, const ON__UINT_PTR *clip_id, size_t count) |
bool | AddClippingPlanes (const ON_SimpleArray< ON_PlaneEquation > &clip, const ON_SimpleArray< ON__UINT_PTR > *clip_id=nullptr) |
Step 3. Optionally, Specify clipping planes or other options. More... | |
int | AddObject (const ON_Geometry *geom, const ON_Xform *xform, ON_UUID uuid, ON__UINT_PTR m_id) |
Step IV - Add Objects that are to be drawn. More... | |
int | AddObject (std::shared_ptr< const ON_Geometry > shr_geom_ptr, const ON_Xform *xform, ON_UUID uuid, ON__UINT_PTR m_id) |
ON_3dVector | CameraDirection (ON_3dPoint wp) const |
world camera direction ( increasing toward scene) at a world point More... | |
ON_3dVector | CamLocDir () const |
returns camera location, if perspective, or else camera direction. More... | |
void | DisableSelectiveClipping (class ON_HLD_Object &obj) |
bool | Draw (bool bAllowUseMP, ON_ProgressReporter *progress, ON_Terminator *terminator) |
Step V. Draw objects hidden line drawings. More... | |
void | Dump (ON_TextLog &) const |
void | EmergencyDestroy () |
void | EnableOccludingSection (bool bEnable=true) |
bool | EnableSelectiveClipping (class ON_HLD_Object &obj, const ON_SimpleArray< ON__UINT_PTR > &active_clip_ids) |
bool | Flatten () |
ON_BoundingBox | GetBoundingBox (bool include_hidden) const |
Get tight bounding box of the hidden line drawing. More... | |
const ON_SimpleArray< ON_PlaneEquation > & | GetClippingPlanes () const |
const ON_SimpleArray< ON_PlaneEquation > & | GetClippingPlanes (ON_SimpleArray< ON__UINT_PTR > *clip_id) const |
const ON_SimpleArray< const class ON_HLDPoint * > & | GetHLDPoints () |
bool | HasBeenFlattened () const |
const ON_Xform & | HiddenLine2World () const |
HLD to World coordinate System. More... | |
bool | IncludeHiddenCurves (bool include) |
void | IncludeTangentEdges (bool include) |
bool | IncludeTangentSeams (bool include) |
bool | IsPerspective () const |
bool | IsValid (ON_TextLog *text_log=nullptr) const |
bool | Merge (ON_HiddenLineDrawing &OtherHLD, ON_Terminator *terminator) |
int | NumberDrawn () const |
Return number of objects present when the last Draw() operation was performed. More... | |
bool | OccludingSectionOption () const |
ON_HiddenLineDrawing & | operator= (const ON_HiddenLineDrawing &) |
void | RejoinCompatibleVisible () |
Rejoin consecutive visible curves of a fullcurve. More... | |
bool | SelectiveClippingOption (const class ON_HLD_Object &obj) const |
bool | SetAbsoluteTolerance (double absolute_tolerance) |
void | SetContext (const ON_HiddenLineDrawing &source) |
bool | SetParallelViewport (ON_3dVector CameraDirection, ON_3dVector CameraUp) |
bool | SetViewport (const ON_Viewport &v) |
Step II. Specify viewport. More... | |
const ON_Viewport & | Viewport () const |
const ON_Xform & | World2HiddenLine () const |
World to HLD-coordinate System. More... | |
Public Attributes | |
const ON_SimpleArray< const class ON_HLDCurve * > & | m_curve |
const ON_SimpleArray< const class ON_HLDFullCurve * > & | m_full_curve |
const ON_SimpleArray< const class ON_HLD_Object * > & | m_object |
m_object is the array of objects that that have been added and will be used in the Draw() operation. More... | |
Static Public Attributes | |
static const int | PerspectiveViewClipCount = 5 |
Copyright (c) 1993-2022 Robert McNeel & Associates. All rights reserved. OpenNURBS, Rhinoceros, and Rhino3D are registered trademarks of Robert McNeel & Associates.
THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY. ALL IMPLIED WARRANTIES OF FITNESS FOR ANY PARTICULAR PURPOSE AND OF MERCHANTABILITY ARE HEREBY DISCLAIMED.
For complete openNURBS copyright information see http://www.opennurbs.org.
ON_HiddenLineDrawing::ON_HiddenLineDrawing | ( | double | absoluteTolerance | ) |
Step I. Construct an empty hidden line drawing Absolute tolerance is used to decide if curves overlap or intersect.
A suggested value is to use CRhinoDoc::AbsoluteTolerance
ON_HiddenLineDrawing::ON_HiddenLineDrawing | ( | ) |
ON_HiddenLineDrawing::~ON_HiddenLineDrawing | ( | ) |
ON_HiddenLineDrawing::ON_HiddenLineDrawing | ( | const ON_HiddenLineDrawing & | ) |
double ON_HiddenLineDrawing::AbsoluteTolerance | ( | ) | const |
ON_SimpleArray< ON__UINT_PTR> ON_HiddenLineDrawing::ActiveClipIds | ( | const class ON_HLD_Object & | obj | ) | const |
Returns: Array of active clipping planes for this object. If Selective Clipping option is enabled for this object then the array returned may be a proper subset of GetClippingPlanes.
bool ON_HiddenLineDrawing::AddClippingPlane | ( | ON_PlaneEquation | clip, |
ON__UINT_PTR | clip_id = 0 |
||
) |
bool ON_HiddenLineDrawing::AddClippingPlanes | ( | const ON_PlaneEquation * | clip, |
const ON__UINT_PTR * | clip_id, | ||
size_t | count | ||
) |
bool ON_HiddenLineDrawing::AddClippingPlanes | ( | const ON_SimpleArray< ON_PlaneEquation > & | clip, |
const ON_SimpleArray< ON__UINT_PTR > * | clip_id = nullptr |
||
) |
Step 3. Optionally, Specify clipping planes or other options.
Description: Specify clipping planes that are active for this view. Parameters: clip -[in] clipping plane or planes clip_id -[in] This is an optional parameter the user can use to identify the clipping plane. Returns: true if clipping planes have been set. Remarks: A point x in model space is visible if p(x)<=0 for each clipping plane p.
Only allowed before calling Draw. The clipping planes are append to the ON_HiddenLineDrawing::m_clipping_plane array. For perspective views SetViewport() will add PerspectiveViewClipCount many clipping planes from the viewport, and the the first clipping plane is the near plane of the view frustum.
int ON_HiddenLineDrawing::AddObject | ( | const ON_Geometry * | geom, |
const ON_Xform * | xform, | ||
ON_UUID | uuid, | ||
ON__UINT_PTR | m_id | ||
) |
Step IV - Add Objects that are to be drawn.
Each call to AddObjects with valid geometry will add a corresponding ON_HLD_Object to the m_object array. Results in the ON_HiddenLineDrawing will then refer back to these ON_HLD_Object as source objects.
Parameters: geom - [in] geometry to be drawn. returns -1 if geometry type is not supported by ON_HiddenLineDrawing. xform - [in] If not null this transformation is applied to geom to place it in the world coordinate system. The transform *xform is copied. uuid -[in] This parameter is copied into the ON_HLD_Object. m_id -[in] This parameter is copied into the ON_HLD_Object. Returns: Index into m_object array of the corresponding ON_HLD_Object, or -1 if the geometry type is not supported. Details: The only supported geometry types are ON_Brep, ON_Curve, ON_Mesh, ON_Point and ON_PointCloud. The uuid and m_id are fields for the user to cross-reference the geometry to other information in their application. When using the simple geom pointer it is the users responsibility to ensure the geometry exists for the lifetime of the ON_HiddenLineDrawing. Alternatively, the shr_geom_ptr parameter is a "smart pointer" that will ensure geometry persists until the ON_HiddenLineDrawing is destroyed.
int ON_HiddenLineDrawing::AddObject | ( | std::shared_ptr< const ON_Geometry > | shr_geom_ptr, |
const ON_Xform * | xform, | ||
ON_UUID | uuid, | ||
ON__UINT_PTR | m_id | ||
) |
ON_3dVector ON_HiddenLineDrawing::CameraDirection | ( | ON_3dPoint | wp | ) | const |
world camera direction ( increasing toward scene) at a world point
ON_3dVector ON_HiddenLineDrawing::CamLocDir | ( | ) | const |
returns camera location, if perspective, or else camera direction.
void ON_HiddenLineDrawing::DisableSelectiveClipping | ( | class ON_HLD_Object & | obj | ) |
bool ON_HiddenLineDrawing::Draw | ( | bool | bAllowUseMP, |
ON_ProgressReporter * | progress, | ||
ON_Terminator * | terminator | ||
) |
Step V. Draw objects hidden line drawings.
Description: Makes a hidden line drawing for the the objects in m_obj Parameters: bAllowUseMP -[in] If true multiprocessors may be used to speed up the calculation. progress - [in] If not null this class can be used to see how much progress has been made while the computing. terminator - [in] Optional object to allow caller to terminate computation. Returns: true when drawing completes without error Remarks: If this ON_HiddenLineDrawing already contains a drawing of objects the result includes a composite drawing of old and new objects. However for best performance add all the objects then call Draw only once.
void ON_HiddenLineDrawing::Dump | ( | ON_TextLog & | ) | const |
void ON_HiddenLineDrawing::EmergencyDestroy | ( | ) |
Call EmergencyDestroy() if the memory used by the results of the any Draw operations, in particular any of the contents of m_full_curve and m_curve, has become invalid.
void ON_HiddenLineDrawing::EnableOccludingSection | ( | bool | bEnable = true | ) |
Description: Enable Occluding Sections option. Parameters: bEnable - true enables Occluding Sections option, false disables
bool ON_HiddenLineDrawing::EnableSelectiveClipping | ( | class ON_HLD_Object & | obj, |
const ON_SimpleArray< ON__UINT_PTR > & | active_clip_ids | ||
) |
Description: Enable/Disable the Selective Clipping option for an object Parameters: obj - an object that been added to the drawing active_clip_ids - list ( possibly empty) of active clip_ids for this object. Returns true if the the list is a subset of those added with AddClippingPlane methods
bool ON_HiddenLineDrawing::Flatten | ( | ) |
Flatten() projects all m_full_curve to the x-y plane in HLD-coordinates. Since HLD_Curves are ProxyCurves with references in the m_full_curve array these are also flattened.
ON_BoundingBox ON_HiddenLineDrawing::GetBoundingBox | ( | bool | include_hidden | ) | const |
Get tight bounding box of the hidden line drawing.
const ON_SimpleArray< ON_PlaneEquation >& ON_HiddenLineDrawing::GetClippingPlanes | ( | ) | const |
Description: Get the array of clipping planes used in this hiddenline drawing, includes both user specified planes and frustum clipping planes for perspective views. Parameters: clip_id -[out] Optional parameter to get array of clipping plane ids. Returns: The array of clipping planes. Remarks: Frustum clipping planes, if they are present, are in positions 0 to 5 and have id==0. To get the associated clip
const ON_SimpleArray< ON_PlaneEquation >& ON_HiddenLineDrawing::GetClippingPlanes | ( | ON_SimpleArray< ON__UINT_PTR > * | clip_id | ) | const |
const ON_SimpleArray< const class ON_HLDPoint*>& ON_HiddenLineDrawing::GetHLDPoints | ( | ) |
bool ON_HiddenLineDrawing::HasBeenFlattened | ( | ) | const |
const ON_Xform& ON_HiddenLineDrawing::HiddenLine2World | ( | ) | const |
HLD to World coordinate System.
bool ON_HiddenLineDrawing::IncludeHiddenCurves | ( | bool | include | ) |
Include hidden curves in hidden line drawing Parameters: include -[in] true (default )to include hidden curves Returns: false if hidden curves are not included Note: Hidden curves are included by default. When hidden curves are not included curves can still be marked with visibility of hidden.
When hidden curves are included, all hidden curves are included unless they are duplicates of other hidden or visible curves.
If hidden curves are not needed in the output IncludeHiddenCurves(false) will improve performance.
void ON_HiddenLineDrawing::IncludeTangentEdges | ( | bool | include | ) |
Include tangent edges in hidden line drawing Parameters: include -[in] true to include tangent edges Note: By default tangent edges are included. To exclude tangent edges use IncludeTangentEdges( false )
bool ON_HiddenLineDrawing::IncludeTangentSeams | ( | bool | include | ) |
Include tangent seams in hidden line drawing Parameters: include -[in] true (default )to include tangent seams Returns: false if tangent seams are not included Note: This option is only valid if tangent edges are included. By default seams are not included. To include seams use IncludeTangentSeams( true );
bool ON_HiddenLineDrawing::IsPerspective | ( | ) | const |
bool ON_HiddenLineDrawing::IsValid | ( | ON_TextLog * | text_log = nullptr | ) | const |
bool ON_HiddenLineDrawing::Merge | ( | ON_HiddenLineDrawing & | OtherHLD, |
ON_Terminator * | terminator | ||
) |
Description: If OtherHLD and *this are hidden line drawings of different objects with the same context they can be be merged into a single hidden line drawing. Parameters: OtherHLD - [in] terminator -[in] Optional object to allow caller to terminate computation. Returns: true if *this is the merger of the two input hidden line drawings. Remarks: Hidden line drawings may be merged only if they have the same tolerances, viewports, clipping planes and options. When true is returned Other is left as an empty hidden line drawing.
int ON_HiddenLineDrawing::NumberDrawn | ( | ) | const |
Return number of objects present when the last Draw() operation was performed.
bool ON_HiddenLineDrawing::OccludingSectionOption | ( | ) | const |
Returns true iff the OccludingSectionOption is enabled.
ON_HiddenLineDrawing& ON_HiddenLineDrawing::operator= | ( | const ON_HiddenLineDrawing & | ) |
void ON_HiddenLineDrawing::RejoinCompatibleVisible | ( | ) |
Rejoin consecutive visible curves of a fullcurve.
bool ON_HiddenLineDrawing::SelectiveClippingOption | ( | const class ON_HLD_Object & | obj | ) | const |
Parameters: obj - an object that been added to the drawing Returns : true if the Selective Clipping Option is enabled.
bool ON_HiddenLineDrawing::SetAbsoluteTolerance | ( | double | absolute_tolerance | ) |
void ON_HiddenLineDrawing::SetContext | ( | const ON_HiddenLineDrawing & | source | ) |
Description: Set the HiddenLineDrawing context from another HiddenLine Drawing Parameters: Source - (in) Source of context information Details: copies, tolerance, view, clipping planes, tangent edges and seams options from source. This should be used on an empty drawing only.
bool ON_HiddenLineDrawing::SetParallelViewport | ( | ON_3dVector | CameraDirection, |
ON_3dVector | CameraUp | ||
) |
Description: SetParallelView will set the viewport to a parallel projection.
Parameters: CameraDirection -[in] Camera direction ( pointing toward the scene) in world coordinates. CameraUp -[in] Direction, in world coordinates, that corresponds to increasing y-direction in the hidden line drawing. Returns: true if the viewport has been set. false if the vectors are linearly dependent.
bool ON_HiddenLineDrawing::SetViewport | ( | const ON_Viewport & | v | ) |
Step II. Specify viewport.
Description: Set the viewport for the hidden line drawing. The viewport supplies the projection that determines the visibility of curves, and the HiddenLineDrawing coordinate system in which the resulting ON_HLDCurve's are represented. The HLD-coordinate system is a right handed system for 3-d model space, in which the 3rd coordinate direction is the projection direction. In particular the z-coordinate direction points from the scene toward the camera. Parameters: v -[in] viewport. A copy of the viewport is made inside of ON_HiddenLineDrawing. Returns: true if viewport has been set Details: Only allowed before calling Draw(..).
For perspective views the "target depth" is used to determine the scale of the results. The target_depth, v.TargetDistance(false), defines the target plane that is the plane perpendicular to the camera axis at this distance from the camera location. The HLD-Coordinate system is scaled 1:1 to world coordinates on the target plane. The HLD_coordinate system is translated in the z-direction so that the target plane has z=0 in HLD-coordinates. If you have a viewport and don't want to think about the choice of target_depth you might want to try: double near = v.FrustumNear(); double far = v.FrustumFar(); double target_distance = .5*(near + far); bool rc = v.SetFrustumNearFar( near, far, 0.0, 0.0, target_distance); if( rc) HLD.SetViewport(v);
Another option is to leave the target_depth unset, or more explicitly call v.SetTargetPoint( ON_UNSET_POINT) When the target point is unset, a target_depth will be computed from the geometry and used to define the HLD coordinate system.
Perspective distortion ( on perspective views only) will scale objects in front (back) of the target plane to be larger (smaller) in HLD-coordinates than in world coordinates. The absolute tolerance is applied in HLD-coordinates so its effect depends on the target_depth setting.
If v is a parallel projection viewport the HLD-coordinate system is the camera coordinate system of v.
For perspective views the transformation from world coordinates to HLD-coordinates is a diagonal scaling of the view transformation from world to clip coordinates. Specifically [ W/2 ] World_to_HLD-coordinates = [ H/2 ] x World_to_clip_coordinates [ (f - n)/2 d ] [ 1.0 ]
where W and H are the width and depth of the view frustum at the target_depth and f and n are the distances to the far and near clipping plane in the viewport, d is chosen so that the target plane is represented as the plane z=0 in HLD-coordinates.
const ON_Viewport& ON_HiddenLineDrawing::Viewport | ( | ) | const |
const ON_Xform& ON_HiddenLineDrawing::World2HiddenLine | ( | ) | const |
World to HLD-coordinate System.
The ON_HiddenLineDrawing HLD-coordinate system is a right handed system in which the 3rd coordinate is the projection direction. In particular the z coordinate direction points from the sceene to the camera.
const ON_SimpleArray< const class ON_HLDCurve*>& ON_HiddenLineDrawing::m_curve |
const ON_SimpleArray< const class ON_HLDFullCurve*>& ON_HiddenLineDrawing::m_full_curve |
Step VI. After Draw() the results are available as arrays of ON_HLDFullCurve, ON_HLDCurve and ON_HLDPoint. m_curve, m_full_curve and GetHLDPoints() are the results of the draw operation.
const ON_SimpleArray<const class ON_HLD_Object*>& ON_HiddenLineDrawing::m_object |
m_object is the array of objects that that have been added and will be used in the Draw() operation.
|
static |