IlvRotationAccessor Class Reference

Behavior to set the rotation angle of a graphic object. More...

#include <ilviews/protos/graphacc.h>

Inheritance diagram for IlvRotationAccessor:

List of all members.

Public Member Functions
	IlvRotationAccessor (const char *name, const char *nodename, const char *angleMin, const char *angleRange, const char *valueMin, const char *valueRange, const char *centerX, const char *centerY, IlBoolean allowInteraction=IlFalse)
	Creates a new rotation accessor.
virtual IlBoolean	changeValue (IlvAccessorHolder *object, const IlvValue &val)
	Called by the method IlvAccessible::changeValue for each IlvAccessor attached to the IlvAccessorHolder.
virtual IlBoolean	handleEvent (IlvAccessorHolder *object, IlvGraphic *g, IlvEvent &, IlvView *, IlvTransformer *t)
	Event handling method, to be derived in subclasses.
virtual void	initialize (const IlvAccessorHolder *object)
	Attachment method to an IlvAccessorHolder.
virtual IlvValue &	queryValue (const IlvAccessorHolder *object, IlvValue &val) const
	Called by the method IlvAccessible::queryValue for each IlvAccessor attached to the IlvAccessorHolder.

---

Detailed Description

Behavior to set the rotation angle of a graphic object.

Library: ilvproto

IlvRotationAccessor lets you set the rotation angle of an object to a given value. Unlike IlvRotateAccessor, it rotates the object only once when the value is changed. The value is stored every time the rotation angle is set, so setting the value again will rotate the object by the angle corresponding to the delta between the old and the new value. The user can rotate the object interactively by dragging it with the mouse. This usage is deprecated since it makes it difficult to modularize the behaviors according to standard design patterns such as the MVC model.

---

Constructor & Destructor Documentation

IlvRotationAccessor::IlvRotationAccessor	(	const char *	name,
		const char *	nodename,
		const char *	angleMin,
		const char *	angleRange,
		const char *	valueMin,
		const char *	valueRange,
		const char *	centerX,
		const char *	centerY,
		IlBoolean	allowInteraction = IlFalse
	)

Creates a new rotation accessor.

This accessor includes an IlvValueAccessor of type float that holds the current rotation factor of the node. It is therefore implicitly typed to IlvFloatValueType. angleMin, angleRange, valueMin, valueRange, centerX, and centerY can contain a constant value, the name of another accessor, or an arithmetic expression that can contain accessor names and/or constants (see IlvUserAccessor::getValue).

Parameters:

	name	Name of the attribute.
	nodename	Indicates the name of the node to be rotated.
	centerX	The x coordinate of the rotation center (you can use the centerX accessor as this parameter).
	centerY	The y coordinate of the rotation center (you can use the centerY accessor as this parameter).
	angleMin	The minimum angle used to compute the rotation.
	angleRange	The angle range used to compute the rotation.
	valueMin	The minimum value used to compute the rotation.
	valueRange	The value range used to compute the rotation.
	allowInteraction	If IlTrue, the user can rotate the node interactively by clicking on it and dragging it with the mouse. Otherwise, no interaction is allowed. Using this flag may produce modularization difficulties in the design of your prototype. It is meant to implement very simple prototypes that do not exceed a few accessors.

---

Member Function Documentation

virtual IlBoolean IlvRotationAccessor::handleEvent	(	IlvAccessorHolder *	object,
		IlvGraphic *	g,
		IlvEvent &	,
		IlvView *	,
		IlvTransformer *	t
	)			[virtual]

Event handling method, to be derived in subclasses.

Called for every event received by one of the nodes specified by the nodeName argument of the constructor. It must be redefined by subclasses to implement the effect of the accessor.

Parameters:

	object	Group to which the accessor is attached.
	g	Graphic object that received the event.
	event	Event received.
	view	View in which the event was received.
	t	Transformer associated with the view, or 0 if the view has no transformer.

Reimplemented from IlvAbstractEventAccessor.

virtual void IlvRotationAccessor::initialize

(

const IlvAccessorHolder *

object

)

[virtual]

Attachment method to an IlvAccessorHolder.

This method is called when the accessor object is attached to a group. You can redefine it in subclasses of IlvUserAccessor to perform any kind of initialization.

Parameters:

object

The object the accessor is attached to.

Reimplemented from IlvAbstractEventAccessor.