HOpConstructCuboid

Functions

HOpConstructCuboid

~HOpConstructCuboid

char const *

GetName

int

OnLButtonDown

int

OnNoButtonDownAndMove

int

OnLButtonDownAndMove

int

OnLButtonUp

void

CreateCuboid

void

CreateSquare

HBaseOperator *

Clone

Detailed Description

class HOpConstructCuboid : public HBaseOperator

The HOpConstructCuboid class creates a rectangular cube.

HOpConstructCuboid implements four of the mouse event handlers defined on the base class and uses the event information to create a cuboid. This provides the basic functionality for creating a temporary three-dimensional, six-sided cuboid or rectangular box. The cuboid that is generated includes two square faces with the same length and width while the depth is variable. The operation consists of the following steps:

  1. Left Button Down: The first point of square base.

  2. Left Button Down and Drag: Rubberband the base to the desired dimensions.

  3. Left Button Up: The base of the cuboid dimension is finalized.

  4. No Button Down and Drag: Rubberband the cuboid to the desired height.

  5. Left Button Down: The height of the cuboid finalized and the operation ends.

More Detailed Description: see event methods.

Subclassed by HOpCreateCuboid

Public Functions

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

Constructs an HOpConstructCuboid 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 ~HOpConstructCuboid()
virtual char const *GetName()
Returns

A pointer to a character string denoting the name of the operator, which is ‘HOpConstructCuboid’.

virtual int OnLButtonDown(HEventInfo &hevent)

OnLButtonDown records the first mouse position and initiates the cuboid-drawing mechanism. It tests for the case that the mechanism has already been started such as OnLButtonDown has been called once already. In this case, OnLButtonDown finalizes the cuboid’s depth, removes the geometry from the scene, updates the display and ends the operation.

Parameters

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

Returns

An HOperatorReturn indicating the status of the event.

virtual int OnNoButtonDownAndMove(HEventInfo &hevent)

OnNoButtonDownAndMove uses a rubberband to set the desired depth of the cuboid.

Parameters

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

Returns

An HOperatorReturn indicating the status of the event.

virtual int OnLButtonDownAndMove(HEventInfo &hevent)

OnLButtonDownAndMove accepts the initiating point from OnLButtonDown and rubberbands a square for the desired size of the cuboid’s base.

Parameters

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

Returns

An HOperatorReturn indicating the status of the event.

virtual int OnLButtonUp(HEventInfo &hevent)

OnLButtonUp finalizes the size of the cuboid’s square base.

Parameters

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

Returns

An HOperatorReturn indicating the status of the event.

virtual void CreateCuboid(HPoint const &last)

CreateCuboid constructs the point list from the first, edge and last point and then maps these screen coordinates generated by the event handlers into world coordinates, so that the points can be directed into a call to HC_Insert_Shell. This function is called internally by OnLButtonDown and OnNoButtonDownAndMove.

Parameters

&last – A pointer to an HPoint object.

virtual void CreateSquare(HPoint const &first, HPoint const &last)

CreateSquare creates a square that is orthogonal to camera target plane. This function is called internally by OnLButtonDownAndMove and OnLButtonUp.

Parameters
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 HOpConstructCuboid object.