DISEntityManager
Overview
DISEntityManager notifies a scene when new DIS ESPDU entities arrive or current entities leave. DISEntityManager may contain any number of DISEntityTypeMapping nodes that provide a best-match X3D model to incoming entity type values. For each new DIS entity, DISEntityManager thus produces a new EspduTransform node that contains a corresponding X3D model.
The DISEntityManager node belongs to the DIS component and requires at least level 2, its default container field is children. It is available from X3D version 3.0 or higher.
Hierarchy
1
2
3
+ X3DNode
+ X3DChildNode
+ DISEntityManager
Fields
SFNode [in, out] metadata NULL [X3DMetadataObject]
Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
Hint
SFString [in, out] address “localhost”
Multicast network address, or else ‘localhost’. Example: 224.2.181.145.
SFInt32 [in, out] applicationID 0 [0,65535]
Each simulation application that can respond to simulation management PDUs needs to have a unique applicationID.
MFNode [in, out] children [ ] [DISEntityTypeMapping]
Mapping field provides a mechanism for automatically creating an X3D model when a new entity arrives over the network. If a new entity matches one of the nodes, an instance of the provided URL is created and added as a child to the EspduTransform specified in the addedEntities field.
Hint
- Multiple DISEntityTypeMapping nodes can be provided in mapping field, best match takes precedence.
Warning
SFInt32 [in, out] port 0 [0,65535]
Multicast network port, for example: 3000.
SFInt32 [in, out] siteID 0 [0,65535]
Simulation/exercise siteID of the participating LAN or organization.
MFNode [out] addedEntities
addedEntities array contains any new entities added during the last frame.
Warning
- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
MFNode [out] removedEntities
removedEntities output array provides EspduTransform references to any entities removed during last frame, either due to a timeout or from an explicit RemoveEntityPDU action.
Warning
- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
Advice
Hints
- DISEntityManager contains DISEntityTypeMapping nodes.
- DisEntityManager ESPDU packets use the IEEE Distributed Interactive Simulation (DIS) protocol.
- Savage Developers Guide on DIS
- X3D for Advanced Modeling (X3D4AM) slideset
Warnings
- ‘children’ field originally named ‘mapping’ in X3Dv3.
- Requires X3D
profile='Full'
or else include<component name='DIS' level='2'/>