HOpSelectPolygon

Detailed Description

class HOpSelectPolygon : public HOpConstructPolyline

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.

Subclassed by HOpSelectPolygonOOC< SelectionSet >

Public Functions

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()
virtual char const *GetName()
Returns:A pointer to a character string denoting the name of the operator ‘HOpSelectPolygon’.
virtual HBaseOperator *Clone()

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 OnLButtonDblClk(HEventInfo &hevent)

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 OnLButtonDown(HEventInfo &hevent)

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.