DtInputPort Class Reference

Instances of DtInputPort are are data ports owned by data consumers. They receive data from a DtPortConnection, and make that data available to the user of the input port. Users of the port should call newData() to check if new data has arrived on this port, and then call dataReceived() to signal that they have received and processed the data currently on the port.

This is an abstract base class. Derived types must provide the implementation for activating and deactivating connetions and accepting data from connections.

DtSingleConnectionInputPort and DtMultiConnectionInputPort implement this functionallity for different mechanisms of accepting data.

Note

Any types which derived from DtInputPort in VR-Forces versions 3.8 and earlier should be changed to derive from DtSingleConnectionInputPort to work with VR-Forces 3.9 and later.

Inheritance diagram for DtInputPort:

Public Member Functions
	DtInputPort (const DtString &portName)
virtual	~DtInputPort ()
virtual const DtString &	name () const
virtual bool	acceptType (const DtString &type) const =0
virtual void	receiveData (DtPortData *data, const DtPortConnection *connection)=0
virtual bool	attemptToActivateConnection (DtPortConnection *conn, int connectionPriority)=0
virtual bool	canActivate (const DtPortConnection *conn, int connectionPriority) const =0
virtual void	deactivateConnection (DtPortConnection *conn)=0
virtual bool	activeConnection () const =0
virtual bool	connectionActive (const DtPortConnection *connection) const =0
virtual int	connectionPriority () const =0
virtual void	addConnection (DtPortConnection *conn)
virtual void	removeConnection (DtPortConnection *conn)
virtual const DtList *	connectionList () const
virtual bool	newData () const
virtual void	dataReceived ()
virtual bool	enabled () const
virtual void	setEnabled (bool flag)

Protected Attributes
DtString	myName
bool	myNewDataFlag
bool	myEnabled
DtList	myConnectionList

Private Member Functions
	DtInputPort ()
	DtInputPort (const DtInputPort &)
DtInputPort &	operator= (const DtInputPort &)

Constructor & Destructor Documentation

DtInputPort::DtInputPort

(

const DtString &

portName

)

Constructor.

virtual DtInputPort::~DtInputPort ( )

virtual

Destructor.

DtInputPort::DtInputPort ( )

private

Not implemented.

DtInputPort::DtInputPort ( const DtInputPort &  )

private

Not implemented.

Member Function Documentation

DtInputPort& DtInputPort::operator= ( const DtInputPort &  )

private

Not implemented.

virtual const DtString& DtInputPort::name ( ) const

virtual

Returns the name string of this port.

virtual bool DtInputPort::acceptType ( const DtString &  type ) const

pure virtual

Returns true if this port should accept the recipt of the specified DtPortData type. Override this function to return true for the types your port will accept.

Implemented in DtLaserDetectorInputPort, DtSensorContactListMultiInputPort, DtSensorContactListInputPort, DtStringInputPort, DtVectorInputPort, DtAmmunitionInputPort, DtCollisionInputPort, DtEntityListInputPort, DtObjectTypesListInputPort, DtOrientationInputPort, DtDualAxisAnalogInputPort, DtAnalogInputPort, DtBooleanInputPort, DtIntegerInputPort, DtObjectTypesListMultiInputPort, and DtEntityListMultiInputPort.

virtual void DtInputPort::receiveData ( DtPortData *  data, const DtPortConnection *  connection  )

pure virtual

clones the specified DtPortData into myData, and sets the newDataFlag to true.

Implemented in DtMultiConnectionInputPort, and DtSingleConnectionInputPort.

virtual bool DtInputPort::attemptToActivateConnection ( DtPortConnection *  conn, int  connectionPriority  )

pure virtual

Attempt to make this connection the active connection providing data to this port with the specified priority. Returns true if the activation was successful.

Implemented in DtMultiConnectionInputPort, and DtSingleConnectionInputPort.

virtual bool DtInputPort::canActivate ( const DtPortConnection *  conn, int  connectionPriority  ) const

pure virtual

Checks if this connection can be the active connection.

Implemented in DtMultiConnectionInputPort, and DtSingleConnectionInputPort.

virtual void DtInputPort::deactivateConnection ( DtPortConnection *  conn )

pure virtual

Deactivate conn if it is currently active.

Implemented in DtMultiConnectionInputPort, and DtSingleConnectionInputPort.

virtual bool DtInputPort::activeConnection ( ) const

pure virtual

Returns true if there is an active connection into this port.

Implemented in DtMultiConnectionInputPort, and DtSingleConnectionInputPort.

virtual bool DtInputPort::connectionActive ( const DtPortConnection *  connection ) const

pure virtual

Returns true if the specified connection is currently active.

Implemented in DtMultiConnectionInputPort, and DtSingleConnectionInputPort.

virtual int DtInputPort::connectionPriority ( ) const

pure virtual

Returns the current connection priority.

Implemented in DtMultiConnectionInputPort, and DtSingleConnectionInputPort.

virtual void DtInputPort::addConnection ( DtPortConnection *  conn )

virtual

Add an incomming connection to this port.

virtual void DtInputPort::removeConnection ( DtPortConnection *  conn )

virtual

Remove an incomming connection to this port.

virtual const DtList* DtInputPort::connectionList ( ) const

virtual

Returns the list of input connections to this port.

virtual bool DtInputPort::newData ( ) const

virtual

Returns true if there is new data on this port that has not been received.

virtual void DtInputPort::dataReceived ( )

virtual

Clears the newData flag on this port.

virtual bool DtInputPort::enabled ( ) const

virtual

Enables/disables the port.

virtual void DtInputPort::setEnabled ( bool  flag )

virtual

Enables/disables the port.

Member Data Documentation

DtString DtInputPort::myName

protected

bool DtInputPort::myNewDataFlag

protected

bool DtInputPort::myEnabled

protected

DtList DtInputPort::myConnectionList

protected

---

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

• /data/exports/nrhent7-1/nightly/docs/vrForces.vrf5-1-branch/include/vrfobjcore/inputPort.h