HOpSelectPolygon

Functions

HOpSelectPolygon

~HOpSelectPolygon

char const *

GetName

HBaseOperator *

Clone

int

OnLButtonDblClk

int

OnLButtonDown

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.