IlvPolySelectInteractor Class Reference

Manager interactor class. More...

#include <ilviews/manager/polyint.h>

Inheritance diagram for IlvPolySelectInteractor:

List of all members.

Public Member Functions
	IlvPolySelectInteractor (IlvManager *manager, IlvView *view)
	Constructor.
void	abort ()
	Aborts the interaction.
virtual IlBoolean	acceptPoint (IlvPolyPoints *polypt, IlUInt index)
	Indicates whether a given point in the polypoint can move.
virtual IlBoolean	acceptRotate (IlvPolyPoints *polypt)
	Indicates whether the polypoint may rotate.
virtual IlvPolySelection *	createPolySelection (IlvPolyPoints *polypt)
	Returns a new IlvPolySelection.
virtual void	doChangePoint (IlvPolyPoints *polypt, IlUInt index, IlvPoint &value)
	Finalizes the interaction by moving a given point.
virtual void	doRotate (IlvPolyPoints *polypt, IlFloat angle)
	Finalizes the interaction by rotating the polypoint.
void	drawGhost ()
	Visual feedback during the interaction.
IlvPolySelection *	getPolySelection () const
	Returns the IlvPolySelection.
void	handleEvent (IlvEvent &event)
	Handles events for the manager view.
void	handleExpose (IlvRegion *rect=0)
	Called when the manager view receives an expose event.
void	init ()
	Initialization, when the interactor is attached to a view.
virtual IlvPolyPoints *	selectPolyPoints (IlvPoint &point)
	Returns a polypoint containing a given point.

---

Detailed Description

Manager interactor class.

Library: ilvmgr

Note: this class is kept for compatibility purposes only. New developments should use the IlvEditPointsInteractor instead.

The IlvPolySelectInteractor class handles the editing of IlvPolyPoints objects such as splines and polylines in a view controlled by a manager. Once you click the IlvPolyPoints object, each point can be moved independently.

See also:

IlvPolySelectInteractor, IlvMakePolyPointsInteractor, IlvPolyPoints, IlvPolySelection.

---

Constructor & Destructor Documentation

IlvPolySelectInteractor::IlvPolySelectInteractor	(	IlvManager *	manager,
		IlvView *	view
	)

Constructor.

Calls the constructor of the parent class.

Parameters:

	manager	The manager.
	view	The manager view.

---

Member Function Documentation

void IlvPolySelectInteractor::abort

(

)

[virtual]

Aborts the interaction.

Called by the manager when the user changes the current interactor. It resets the interactor to a state in which it appears to have never been launched. A common implementation is to erase the ghost image. Call this member function to inhibit the interactor action in particular circumstances.

Reimplemented from IlvManagerViewInteractor.

virtual IlBoolean IlvPolySelectInteractor::acceptPoint	(	IlvPolyPoints *	polypt,
		IlUInt	index
	)			[virtual]

Indicates whether a given point in the polypoint can move.

Returns:

IlTrue if changing the value of the point is allowed.

Parameters:

	polypt	The polypoint.
	index	Specifies the point index in the polypoint.

virtual IlBoolean IlvPolySelectInteractor::acceptRotate

(

IlvPolyPoints *

polypt

)

[virtual]

Indicates whether the polypoint may rotate.

Returns:

IlTrue if the user is allowed to rotate the polypoint.

Parameters:

polypt

The polypoint.

virtual IlvPolySelection* IlvPolySelectInteractor::createPolySelection

(

IlvPolyPoints *

polypt

)

[virtual]

Returns a new IlvPolySelection.

Creates an instance of IlvPolySelection that defines the given IlvPolyPoints object.

Returns:

The pointer to the IlvPolySelection object.

Parameters:

polypt

The polypoint.

virtual void IlvPolySelectInteractor::doChangePoint	(	IlvPolyPoints *	polypt,
		IlUInt	index,
		IlvPoint &	value
	)			[virtual]

Finalizes the interaction by moving a given point.

Is called when the user releases the mouse button after dragging a given point of the polypoint.

Parameters:

	polypt	The polypoint.
	index	Specifies the point index in the polypoint.
	value	The new coordinates of the point.

virtual void IlvPolySelectInteractor::doRotate	(	IlvPolyPoints *	polypt,
		IlFloat	angle
	)			[virtual]

Finalizes the interaction by rotating the polypoint.

Applies a rotation to the specified polypoint object.

Parameters:

	polypt	The polypoint.
	angle	Specifies the rotation angle in degrees.

void IlvPolySelectInteractor::drawGhost

(

)

[virtual]

Visual feedback during the interaction.

Called to draw a preview image of the resulting user action (the ghost image of the interactor). This function is generally invoked by IlvManagerViewInteractor::handleEvent as a response to user events.

Reimplemented from IlvManagerViewInteractor.

IlvPolySelection* IlvPolySelectInteractor::getPolySelection

(

)

const

Returns the IlvPolySelection.

Returns:

The IlvPolySelection that defines the selected IlvPolyPoints object.

void IlvPolySelectInteractor::handleEvent

(

IlvEvent &

event

)

[virtual]

Handles events for the manager view.

Called by the manager for which the interactor was created with every event it receives in the interactor view.

Implements IlvManagerViewInteractor.

void IlvPolySelectInteractor::handleExpose

(

IlvRegion *

clip = 0

)

[virtual]

Called when the manager view receives an expose event.

Called by the manager when an exposure request occurs in the interactor view to redraw shapes handled by the interactor, such as a ghost image. The basic implementation calls the member function IlvManagerViewInteractor::drawGhost after the clipping region has been set to the exposed area.

Parameters:

clip

Specifies the exposed area.

Reimplemented from IlvManagerViewInteractor.

void IlvPolySelectInteractor::init

(

)

[virtual]

Initialization, when the interactor is attached to a view.

Resets the interactor to its initial state.
Called by the manager whenever the interactor is associated with a view. An association of this kind is established by the member function IlvManager::setInteractor.

Reimplemented from IlvManagerViewInteractor.

virtual IlvPolyPoints* IlvPolySelectInteractor::selectPolyPoints

(

IlvPoint &

point

)

[virtual]

Returns a polypoint containing a given point.

Returns:

A subtype of IlvPolyPoints that contains the point point.

Parameters:

point

The point.