DtSdc3DAttachPoint represents the 3 methods for attaching a 3D draw control object in 3-space. More...

Public Types
enum	DtSdc3DAttachmentType { attachmentTypeUndefined = 0, attachmentTypeScene = 1, attachmentTypeEntity = 2, attachmentTypeDrawObject = 3 }
Public Member Functions
	DtSdc3DAttachPoint (const DtVector &location)
	Geocentric coordinates constructor.
	DtSdc3DAttachPoint (const DtGlobalObjectDesignator &entityId)
	HLA/DIS object id constructor.
	DtSdc3DAttachPoint (const DtGlobalObjectDesignator &drawObjectId, double relativePosition)
	HLA/DIS object id constructor.
	DtSdc3DAttachPoint (const DtSdc3DAttachPoint &orig)
	Copy constructor.
DtSdc3DAttachPoint &	operator= (const DtSdc3DAttachPoint &rhs)
	Assignment operator.
virtual	~DtSdc3DAttachPoint ()
	Virtual destructor.
	DtSdc3DAttachPoint ()
	Default constructor.
virtual DtSdc3DAttachmentType	attachmentType () const
	Attachment Type accessor.
virtual DtVector	location () const
	Location accessor.
virtual DtVector &	location ()
virtual void	setLocation (DtVector location)
	Location mutator.
virtual const DtGlobalObjectDesignator &	drawObjectId () const
	Draw Object ID accessor.
virtual void	setDrawObjectId (const DtGlobalObjectDesignator &drawObjectId)
	Draw Object Id mutator.
virtual double	relativePosition () const
	Draw Object relative position accessor; draw object attached only.
virtual void	setRelativePosition (double relativePosition)
	Draw Object relative position mutator.
virtual DtGlobalObjectDesignator	entityId () const
	Entity ID accessor.
virtual void	setEntityId (const DtGlobalObjectDesignator &entityId)
	Entity Id mutator.
virtual bool	isAttached () const
virtual const DtGlobalObjectDesignator &	attachedId () const
Protected Attributes
DtVector	myLocation
DtGlobalObjectDesignator	myAttachedId
double	myRelativePosition
DtSdc3DAttachmentType	myAttachmentType

Detailed Description

DtSdc3DAttachPoint represents the 3 methods for attaching a 3D draw control object in 3-space.

DtSdc3DAttachPoint defines the interface and storage for a class that functions as a discriminated union representing the 3 methods for attaching a 3D draw control object in 3-space. Objects can be placed in the scene by specifying 3D geocentric coordinates; an HLA/DIS entity id (DtGlobalObjectDesignator); or the id of another draw control object.

Member Enumeration Documentation

enum DtSdc3DAttachPoint::DtSdc3DAttachmentType

Enumerator:

attachmentTypeUndefined
attachmentTypeScene
attachmentTypeEntity
attachmentTypeDrawObject

Constructor & Destructor Documentation

DtSdc3DAttachPoint::DtSdc3DAttachPoint ( const DtVector & location )

Geocentric coordinates constructor.

Parameters:

location Geocentric location in the scene at which to place this object

DtSdc3DAttachPoint::DtSdc3DAttachPoint ( const DtGlobalObjectDesignator & entityId )

HLA/DIS object id constructor.

Parameters:

entityId HLA/DIS global object designator of entity to attach to

DtSdc3DAttachPoint::DtSdc3DAttachPoint	(	const DtGlobalObjectDesignator &	drawObjectId,
		double	relativePosition
	)

HLA/DIS object id constructor.

Parameters:

drawObjectId	id of draw object to attach to
relativePosition	If the attachment is to a draw control object that has 2 ends (line or cylinder) then a relative position can be specified that indicates the position between those two end points. 0. to 100. percent (default 0.)

DtSdc3DAttachPoint::DtSdc3DAttachPoint ( const DtSdc3DAttachPoint & orig )

Copy constructor.

virtual DtSdc3DAttachPoint::~DtSdc3DAttachPoint ( ) [virtual]

Virtual destructor.

DtSdc3DAttachPoint::DtSdc3DAttachPoint ( )

Default constructor.

Member Function Documentation

DtSdc3DAttachPoint& DtSdc3DAttachPoint::operator= ( const DtSdc3DAttachPoint & rhs )

Assignment operator.

virtual DtSdc3DAttachmentType DtSdc3DAttachPoint::attachmentType ( ) const [virtual]

Attachment Type accessor.

Get the type of attachment that this attach point represents

Returns:: One of the DtSdc3DAttachmentType enumerations

virtual DtVector DtSdc3DAttachPoint::location ( ) const [virtual]

Location accessor.

Get the geocentric location to attached to

Returns:: Geocentric location of object if attachment type is attachmentTypeScene; [0.0, 0.0, 0.0] otherwise

virtual DtVector& DtSdc3DAttachPoint::location ( ) [virtual]

virtual void DtSdc3DAttachPoint::setLocation ( DtVector location ) [virtual]

Location mutator.

Set the geocentric location to attached to. This also sets the attachment type to attachmentTypeScene as a side effect

Parameters:

location Geocentric location to attach to

virtual const DtGlobalObjectDesignator& DtSdc3DAttachPoint::drawObjectId ( ) const [virtual]

Draw Object ID accessor.

Get the ID of the draw object to attach to

Returns:: Draw Object ID if attachment type is attachmentTypeDrawObject; 0 otherwise

virtual void DtSdc3DAttachPoint::setDrawObjectId ( const DtGlobalObjectDesignator & drawObjectId ) [virtual]

Draw Object Id mutator.

Set the draw object to attached to. This also sets the attachment type to attachmentTypeDrawObject as a side effect

Parameters:

drawObjectId ID of draw object to attach to

virtual double DtSdc3DAttachPoint::relativePosition ( ) const [virtual]

Draw Object relative position accessor; draw object attached only.

Returns:: Relative position as a percentage (0. to 100.)

virtual void DtSdc3DAttachPoint::setRelativePosition ( double relativePosition ) [virtual]

Draw Object relative position mutator.

Parameters:

relativePosition 0. to 100. (percent)

virtual DtGlobalObjectDesignator DtSdc3DAttachPoint::entityId ( ) const [virtual]

Entity ID accessor.

Get the Global Object Designator of the entity to attach to

Returns:: Global Object Designator if attachment type is attachmentTypeDrawEntity; GlobalObjectDesignator::nullId() (in HLA) or GlobalObjectDesignator::nullString() (in DIS) otherwise

virtual void DtSdc3DAttachPoint::setEntityId ( const DtGlobalObjectDesignator & entityId ) [virtual]

Entity Id mutator.

Set the entity to attached to. This also sets the attachment type to attachmentTypeEntity as a side effect

Parameters:

entityId Global Object Designator of entity to attach to

virtual bool DtSdc3DAttachPoint::isAttached ( ) const [virtual]