HOpConstructCuboid

class HOpConstructCuboid

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.

Inherits from: HBaseOperator

Methods

HOpConstructCuboid::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::~HOpConstructCuboid()

virtual

virtual char const *HOpConstructCuboid::GetName()

virtual

Returns

A pointer to a character string denoting the name of the operator, which is ‘HOpConstructCuboid‘.
virtual int HOpConstructCuboid::OnLButtonDown(HEventInfo &hevent)

virtual

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 HOpConstructCuboid::OnNoButtonDownAndMove(HEventInfo &hevent)

virtual

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 HOpConstructCuboid::OnLButtonDownAndMove(HEventInfo &hevent)

virtual

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 HOpConstructCuboid::OnLButtonUp(HEventInfo &hevent)

virtual

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 HOpConstructCuboid::CreateCuboid(HPoint const &last)

virtual

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 HOpConstructCuboid::CreateSquare(HPoint const &first, HPoint const &last)

virtual

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

Parameters

&first: An HPoint object.

&last: An HPoint object.

HBaseOperator *HOpConstructCuboid::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 HOpConstructCuboid object.

Variables

HPoint HOpConstructCuboid::m_ptEdge

protected

The edge of the cube.

HPoint HOpConstructCuboid::m_ptPointList[8]

protected

The array of points for cuboid shell.

int HOpConstructCuboid::m_FaceList[30]

protected

int

The facelist for the shell.