A model-like object that draws a 2D line.

A 2D line that can be represented in one of two ways: either it has a start position and end position, divided into segments, or it is multiple (> 2) vertices, each pair of which define a segment. Each segment consists of a percentage (first case only), color, style, arrow style, stipple pattern, and thickness. This line class inherits from DtWindowObject() which means it can be included in a parent/child relationship with other window objects, including surfaces, polygons, text, and ellipses. Vertices for this line are relative to a fixed position, this is the position set in the base class. Rotations are also relative to this position. If a position is not set, the default position is (0.0,0.0). If this object is a child of a surface, and that surface has a clip box set, this objects vertices will automatically be clipped in it's update method. If this object is a child of another object, the position set is relative to the parent. createInstance() must be called first for the other methods in this class to work.

Inheritance diagram for makVrv::DtWindowLine:

[legend]

Public Member Functions
	DtWindowLine (DtDe &de, DtUniqueID id)

virtual	~DtWindowLine ()

virtual void	setVertex (unsigned int vertex, double x, double y)

virtual void	removeVertex (unsigned int vertex)

virtual void	setStartVertex (double x, double y)

virtual void	setEndVertex (double x, double y)

virtual void	setVisible (bool isVisible)

virtual void	setWidth (unsigned int width)

virtual void	setColor (float r, float g, float b, float a)

virtual void	setStipplePattern (unsigned int pattern)

virtual void	setStyleSegments (const std::vector< double > &segmentPercentages)

virtual void	setSegmentColor (unsigned int index, float r, float g, float b, float a)

virtual void	setSegmentLightningStyle (unsigned int index, bool enableLightningStyle)

virtual void	setSegmentStartArrow (unsigned int index, bool enableStartArrow)

virtual void	setSegmentEndArrow (unsigned int index, bool enableEndArrow)

virtual void	setSegmentStipplePattern (unsigned int index, unsigned int stipplePattern)

virtual void	setSegmentStipplePattern (unsigned int index, unsigned int stippleScale, unsigned int stipplePattern)

virtual void	setSegmentWidth (unsigned int index, unsigned int width)

virtual void	setSegmentStartColor (unsigned int segmentIndex, float r, float g, float b, float a)

virtual void	setSegmentEndColor (unsigned int segmentIndex, float r, float g, float b, float a)

virtual void	setGroup (int groupId)

virtual void	setChannelOverlay (const std::string &displayName, const std::string &windowName, const std::string &channelName) override

Public Member Functions inherited from makVrv::DtWindowObject
	DtWindowObject (DtDe &de, DtUniqueID id)

virtual	~DtWindowObject ()

virtual bool	visible ()

virtual DtUniqueID	uniqueId ()

DtWindowObject *	getParent ()

virtual ChildList	childList ()

virtual void	addChild (DtUniqueID id)

virtual void	removeChild (DtUniqueID id)

virtual void	getColor (float &r, float &g, float &b, float &a)

virtual void	slot_postTick ()

virtual Transform	windowTransform ()

virtual DtClipBox	clipBox ()

virtual void	setParentId (DtUniqueID parentId)

virtual DtUniqueID	getParentId ()

virtual void	setPosition (double x, double y)

virtual void	getPosition (double &x, double &y)

virtual void	setScale (double scale)

virtual void	setScale (double x, double y)

virtual void	getScale (double &x, double &y)

virtual void	setRotation (double rotation)

virtual void	getRotation (double &rotation)

virtual void	setInheritColor (bool inheritColor)

virtual bool	inheritColor ()

virtual int	group ()

virtual void	setFlashing (bool flashing, double interval)

virtual void	getFlashing (bool &flashing, double &interval)

virtual void	getChannelOverlay (std::string &displayName, std::string &windowName, std::string &channelName)

Protected Member Functions
virtual void	update ()

virtual void	needsUpdate ()

Protected Attributes
DtWindowLineInstance *	myInstance

bool	myConnectedToPostUpdate

Protected Attributes inherited from makVrv::DtWindowObject
DtDe &	myDe

DtUniqueID	myUniqueId

DtUniqueID	myParentId

ChildList	myChildIdList

DtVector2d	myPosition

DtVector2d	myScale

DtVector2d	myWindowScale

double	myRotation

double	myFlashInterval

double	myLastFlashTime

double	myLastSimTime

bool	myVisible

bool	myLastVisibilityFlash

bool	myInheritColor

bool	myFlashing

float	myColorR

float	myColorG

float	myColorB

float	myColorA

Transform	myWindowTransform

DtClipBox	myClipBox

int	myGroup

std::string	myDisplayName

std::string	myWindowName

std::string	myChannelName

Additional Inherited Members
Public Types inherited from makVrv::DtWindowObject
typedef std::list< DtUniqueID >	ChildList

typedef DtVector2< double >	DtVector2d

typedef DtMatrix3< double >	Transform

Constructor & Destructor Documentation

makVrv::DtWindowLine::DtWindowLine	(	DtDe &	de,
		DtUniqueID	id
	)

CTOR.

virtual makVrv::DtWindowLine::~DtWindowLine ( )

virtual

DTOR.

Member Function Documentation

virtual void makVrv::DtWindowLine::setVertex	(	unsigned int	vertex,
		double	x,
		double	y
	)

virtual

Set (or add) the specified vertex at <x,y>

virtual void makVrv::DtWindowLine::removeVertex ( unsigned int vertex )

virtual

Remove the specified vertex.

virtual void makVrv::DtWindowLine::setStartVertex	(	double	x,
		double	y
	)

virtual

Set the start vertex of the line in screen coordinates from 0...1 Here for backward compatibility. Same as setVertex(0, x, y)

virtual void makVrv::DtWindowLine::setEndVertex	(	double	x,
		double	y
	)

virtual

Set the end vertex of the line in screen coordinates from 0...1 Here for backward compatibility. Same as setVertex(1, x, y)

virtual void makVrv::DtWindowLine::setVisible ( bool isVisible )

virtual

Set the line visible or invisible.

Reimplemented from makVrv::DtWindowObject.

virtual void makVrv::DtWindowLine::setWidth ( unsigned int width )

virtual

Set the entire line width.

virtual void makVrv::DtWindowLine::setColor	(	float	r,
		float	g,
		float	b,
		float	a
	)

virtual

Set the color of the line.

Reimplemented from makVrv::DtWindowObject.

virtual void makVrv::DtWindowLine::setStipplePattern ( unsigned int pattern )

virtual

Set a stipple pattern for the line. Note that repeatFactor will not be used for overlay forms of the lines.

virtual void makVrv::DtWindowLine::setStyleSegments ( const std::vector< double > & segmentPercentages )

virtual

Set the percentage lengths of the segments; creates and removes segments as necessary.

virtual void makVrv::DtWindowLine::setSegmentColor	(	unsigned int	index,
		float	r,
		float	g,
		float	b,
		float	a
	)

virtual

Set the color of a segment.

virtual void makVrv::DtWindowLine::setSegmentLightningStyle	(	unsigned int	index,
		bool	enableLightningStyle
	)

virtual

Set a segment's lightning style (whether or not it looks like a lighting bolt)

virtual void makVrv::DtWindowLine::setSegmentStartArrow	(	unsigned int	index,
		bool	enableStartArrow
	)

virtual

Turn on or off a segment's start arrow.

virtual void makVrv::DtWindowLine::setSegmentEndArrow	(	unsigned int	index,
		bool	enableEndArrow
	)

virtual

Turn on or off a segment's end arrow.

virtual void makVrv::DtWindowLine::setSegmentStipplePattern	(	unsigned int	index,
		unsigned int	stipplePattern
	)

virtual

Set the stipple pattern for a segment according to the OpenGL line stipple feature.

virtual void makVrv::DtWindowLine::setSegmentStipplePattern	(	unsigned int	index,
		unsigned int	stippleScale,
		unsigned int	stipplePattern
	)

virtual

Set the stipple pattern for a segment according to the OpenGL line stipple feature.

virtual void makVrv::DtWindowLine::setSegmentWidth	(	unsigned int	index,
		unsigned int	width
	)

virtual

Set the width of a segment in pixels.

virtual void makVrv::DtWindowLine::setSegmentStartColor	(	unsigned int	segmentIndex,
		float	r,
		float	g,
		float	b,
		float	a
	)

virtual

Set the color of the firt vertex in a segment. This can be used for color blending between vertices.

virtual void makVrv::DtWindowLine::setSegmentEndColor	(	unsigned int	segmentIndex,
		float	r,
		float	g,
		float	b,
		float	a
	)

virtual

Set the color of the end vertex in a segment. This can be used for color blending between vertices.

virtual void makVrv::DtWindowLine::setGroup ( int groupId )

virtual

Set this object's group ID for z order. The higher the Z order the "closer" the element will be drawn to the eye point.

Reimplemented from makVrv::DtWindowObject.

virtual void makVrv::DtWindowLine::setChannelOverlay	(	const std::string &	displayName,
		const std::string &	windowName,
		const std::string &	channelName
	)

overridevirtual

By default window objects are placed on the RemoteDisplayWorldOverlay, which is rendered on all channels that have the "showRemoteGraphics" channel keyword. If a user wishes to draw a specific window object on a specific channel, use this method. This does not work for remote displays.

Reimplemented from makVrv::DtWindowObject.

virtual void makVrv::DtWindowLine::update ( )

protectedvirtual

Called on signal_postUpdate; time to update render data.

virtual void makVrv::DtWindowLine::needsUpdate ( )

protectedvirtual

Called by all mutators to set up a postUpdate signal if not already connected.

Reimplemented from makVrv::DtWindowObject.

Member Data Documentation

DtWindowLineInstance* makVrv::DtWindowLine::myInstance

protected

bool makVrv::DtWindowLine::myConnectedToPostUpdate

protected

The documentation for this class was generated from the following file:

/data/exports/nrhent7-1/nightly/docs/vrForces.vrf5-0-branch/include/vrvCore/DtWindowLine.h

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation