A common base class for representing ellipses and rectangles. More...

Inheritance diagram for vrvControlToolkit::DtEllipseRectangleBase:

Public Member Functions
virtual DtVdcVector2D	position () const
	position accessor
virtual void	setPosition (const DtVdcVector2D &position)
	position mutator
virtual DtVdcVector2D	size () const
	size accessor
virtual void	setSize (const DtVdcVector2D &size)
	size mutator
virtual double	rotation () const
	rotation accessor
virtual void	setRotation (double rotation)
	rotation mutator
virtual const DtVdcColor &	color () const
	color accessor
virtual void	setColor (const DtVdcColor &color)
	color mutator
virtual bool	fill () const
	fill accessor
virtual void	setFill (bool fill)
	fill mutator
virtual unsigned	pattern () const
	pattern accessor
virtual void	setPattern (unsigned pattern)
	pattern mutator
virtual bool	flashing () const
	flashing accessor
virtual void	setFlashing (bool flashing)
	flashing mutator
virtual double	scale () const
	scale accessor
virtual void	setScale (double scale)
	scale mutator
virtual void	setRemoteGraphicSet (const std::string &setName)
virtual void	update ()
	update the internal pdu
Protected Member Functions
	DtEllipseRectangleBase (DtExerciseConn *exConn, unsigned id, const DtString &objName, const DtVdcVector2D &position, const DtVdcVector2D &size, double rotation=0.0, double scale=1.0, DtVdcColor color=DtVdcColor::DtVdcWhite, bool fill=false, unsigned pattern=0xffffffff, bool flashing=false)
	Construct the basis of an Ellipse or Rectangle Draw Control Object.
virtual	~DtEllipseRectangleBase ()
Protected Attributes
DtVdcVector2D	myPosition
DtVdcVector2D	mySize
DtVdcColor	myColor
unsigned	myPattern
bool	myFill
double	myRotation
bool	myFlashing
double	myScale
Dt2DGraphicalObjectStateRecord *	myStateRecord
Private Member Functions
	DtEllipseRectangleBase ()
	Default constructor.

Detailed Description

A common base class for representing ellipses and rectangles.

DtEllipseRectangleBase in inherited by both DtEllipseObject and DtRectangleObject. Ellipses and rectangles are represented in the exact same way on the network, except for a type field which indicates which should be drawn. This base class provides mutators that allow the user to specify the position, shape, rotation, and color of the ellipse or rectangle on the Stealth screen; specify whether the object should be filled (and specify a fill pattern if it is); and optionally, make the object flash. This class shuold not be instantiated on its own (and its constructors are protected to prevent that).

Constructor & Destructor Documentation

vrvControlToolkit::DtEllipseRectangleBase::DtEllipseRectangleBase	(	DtExerciseConn *	exConn,
		unsigned	id,
		const DtString &	objName,
		const DtVdcVector2D &	position,
		const DtVdcVector2D &	size,
		double	rotation = `0.0`,
		double	scale = `1.0`,
		DtVdcColor	color = `DtVdcColor::DtVdcWhite`,
		bool	fill = `false`,
		unsigned	pattern = `0xffffffff`,
		bool	flashing = `false`
	)		`[protected]`

Construct the basis of an Ellipse or Rectangle Draw Control Object.

Parameters:

id	Passed to DtDrawControlObject base (see)
position	Position on the screen - values go from [0.,0.] (left, bottom) to [1.,1.] (right, top) For rectangles, this is the bottom left corner of the rectangle, and for ellipses, this is the center of the ellipse
size	Size of object along the X and Y axes (before rotation) = values go from [0.,0.] to [1.,1.] (the entire screen). For rectangles, this specifies the dimensions, and for ellipses, this specifies the radii.
rotation	A counter-clockwise rotation to apply to the object - values go from 0 to 2 PI
color	The color of the object outline (and fill, if filled)
fill	A boolean parameter indicating whether or not the object should be filled
pattern	A pattern used when filling the object - values go from 0x00000000 (no fill) to 0xFFFFFF (solid)
flashing	A boolean parameter indicating whether or not the object should be flashing

virtual vrvControlToolkit::DtEllipseRectangleBase::~DtEllipseRectangleBase ( ) [protected, virtual]

vrvControlToolkit::DtEllipseRectangleBase::DtEllipseRectangleBase ( ) [private]

Default constructor.

Private and not implemented - you must supply an id and basic geometric parameters to construct the ellipse or rectangle

Member Function Documentation

virtual DtVdcVector2D vrvControlToolkit::DtEllipseRectangleBase::position ( ) const [virtual]

position accessor

Get the object's center position

Returns:: [0.,0.] (left, bottom) to [1.,1.] (right, top)

Implements vrvControlToolkit::Dt2DPositionedObject.

virtual void vrvControlToolkit::DtEllipseRectangleBase::setPosition ( const DtVdcVector2D & position ) [virtual]

position mutator

Set the object's center position

Parameters:

position [0.,0.] (left, bottom) to [1.,1.] (right, top)

Implements vrvControlToolkit::Dt2DPositionedObject.

virtual DtVdcVector2D vrvControlToolkit::DtEllipseRectangleBase::size ( ) const [virtual]

size accessor

Get the object's size

Returns:: [0.,0.] to [1.,1.] (the entire screen)

virtual void vrvControlToolkit::DtEllipseRectangleBase::setSize ( const DtVdcVector2D & size ) [virtual]

size mutator

Set the object's size

Parameters:

size	[0.,0.] to [1.,1.] (the entire screen)

virtual double vrvControlToolkit::DtEllipseRectangleBase::rotation ( ) const [virtual]

rotation accessor

Get the counter-clockwise rotation of the object about its center

Returns:: 0. to 2 PI radians

virtual void vrvControlToolkit::DtEllipseRectangleBase::setRotation ( double rotation ) [virtual]

rotation mutator

Set the counter-clockwise rotation of the object about center

Parameters:

rotation 0. to 2 PI radians

virtual const DtVdcColor& vrvControlToolkit::DtEllipseRectangleBase::color ( ) const [virtual]

color accessor

Get the color assigned to this object

Returns:: Instance of DtVdcColor

Reimplemented from vrvControlToolkit::DtDrawControlObject.

virtual void vrvControlToolkit::DtEllipseRectangleBase::setColor ( const DtVdcColor & color ) [virtual]

color mutator

Set the color to use when drawing (and filling) this object

Parameters:

color The DtVdcColor to use

Reimplemented from vrvControlToolkit::DtDrawControlObject.

virtual bool vrvControlToolkit::DtEllipseRectangleBase::fill ( ) const [virtual]

fill accessor

Get the boolean that indicates whether or not the object should be filled when drawn.

Returns:: Boolean fill value

virtual void vrvControlToolkit::DtEllipseRectangleBase::setFill ( bool fill ) [virtual]

fill mutator

Set the boolean that indicates whether or not the object should be filled when drawn.

Parameters:

fill	true or false

virtual unsigned vrvControlToolkit::DtEllipseRectangleBase::pattern ( ) const [virtual]

pattern accessor

Get the fill pattern to use if the object will be filled

Returns:: The fill pattern, 0x00000000 to 0xFFFFFFFF

virtual void vrvControlToolkit::DtEllipseRectangleBase::setPattern ( unsigned pattern ) [virtual]

pattern mutator

Set the fill pattern to use if the object will be filled

Parameters:

pattern The fill pattern, 0x00000000 to 0xFFFFFFFF. The object is filled by a series of vertical lines that conform to the pattern, where each on bit results in a vertical line of the object's color

virtual bool vrvControlToolkit::DtEllipseRectangleBase::flashing ( ) const [virtual]

flashing accessor

Get the boolean that indicates whether or not the object should flash

Returns:: true or false

Reimplemented from vrvControlToolkit::DtDrawControlObject.

virtual void vrvControlToolkit::DtEllipseRectangleBase::setFlashing ( bool flashing ) [virtual]

flashing mutator

Set the boolean that indicates whether or not the object should flash

Parameters:

flashing true or false

Reimplemented from vrvControlToolkit::DtDrawControlObject.

virtual double vrvControlToolkit::DtEllipseRectangleBase::scale ( ) const [virtual]

scale accessor

Get the scale factor applied to the object's size

Returns:: 0+

virtual void vrvControlToolkit::DtEllipseRectangleBase::setScale ( double scale ) [virtual]

scale mutator

Set the scale factor applied to the object's size

Parameters:

scale 0+

virtual void vrvControlToolkit::DtEllipseRectangleBase::setRemoteGraphicSet ( const std::string & setName ) [virtual]

Reimplemented from vrvControlToolkit::DtDrawControlObject.

virtual void vrvControlToolkit::DtEllipseRectangleBase::update ( ) [virtual]

update the internal pdu

Make sure the internal pdu reflects the actual state of the draw control object's members. This is necessary because some members can be modified directly (which make the interface easier to use). DtStealthRemoteDrawer::update() calls this, so the user doesn't need to; but if the user is accessing the pdu directly (via the pdu() accessor) this should be called before using the pdu.

Implements vrvControlToolkit::DtDrawControlObject.