HOpSelectPolygon

class HOpSelectPolygon

The HOpSelectPolygon class computes a selection list for objects inside a user-defined polygonal area.

HOpSelectPolygon employs all of the drawing functionality of HOpConstructPolyline to define a temporary, overlayed polygonal selection area, and then maps the polygon information to the HOOPS routine HC_Compute_Selection_By_Polygon. The operation consists of the following steps:

  1. Left Button Down: operation initiated, first point of the polygon recorded
  2. No Button Down and Drag: rubberband line segment to desired position of next point
  3. Left Button Down: next point in polygon recorded, etc.
  4. Left Button Double Click: polygon completed, and flushed from scene, selection list computed, objects highlighted, operation ended

More Detailed Description: see event methods Functional Note: This operator does not provide exact results for HOOPS’ Shell and Mesh primitives.

Inherits from: HOpConstructPolyline

Methods

HOpSelectPolygon::HOpSelectPolygon(HBaseView *view, int DoRepeat = 0, int DoCapture = 1)

Constructs an HOpSelectPolygon object.

Parameters

view: A pointer to an HBaseView object

DoRepeat: An integer denoting whether this is a repeatable operator. This parameter has been deprecated.

DoCapture: An integer denoting whether the mouse state should be captured, which means that all mouse events should be received after a mousedown, even if it leaves the window. This parameter has been deprecated.

virtual HOpSelectPolygon::~HOpSelectPolygon()

virtual

virtual char const *HOpSelectPolygon::GetName()

virtual

Returns

A pointer to a character string denoting the name of the operator ‘HOpSelectPolygon‘.
virtual HBaseOperator *HOpSelectPolygon::Clone()

virtual

Creates a new operator which is a copy of the current operator. The user is responsible for deleting the newly created operator.

Returns

A pointer to the newly created HOpConstructPolyline object.
virtual int HOpSelectPolygon::OnLButtonDblClk(HEventInfo &hevent)

virtual

returns a pointer to a copy of the operator

OnLButtonDblClk passes the polyline array from HOpConstructPolyline::OnLButtonDblClk into the HOOPS routine HC_Insert_Polygon and inserts the polygon into the scene. The polyline information is also passed to Compute_Selection_By_Polygon. Currently selected items are highlighted, and items previously highlighted are de-selected.

Parameters

hevent: An HEventInfo object containing information about the current event.

Returns

A value indicating the result of the event handling.
virtual int HOpSelectPolygon::OnLButtonDown(HEventInfo &hevent)

virtual

OnLButtonDown initiates the polygon selection mechanism.

Parameters

hevent: An HEventInfo object containing information about the current event.

Returns

A value indicating the result of the event handling.

Variables

bool HOpSelectPolygon::m_bFirstTimeThrough

private

bool