include/vrfExtObjects/envObjState.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2001 MaK Technologies, Inc.
** All rights reserved.
*******************************************************************************/
/*******************************************************************************
** $RCSfile: envObjState.h,v $ $Revision: 1.16 $ $State: Exp $
*******************************************************************************/

//
// File:        envObjState.h
//
// Class:       DtSimEnvironmentalObjectStateRecord
//
#ifndef DtSimEnvironmentalObjectStateRecord_H_
#define DtSimEnvironmentalObjectStateRecord_H_

#include <vl/envRec.h>
#include <vlpi/appearance.h>
#include <vlpi/disEnums.h>
#include <vl/objDesList.h>
#include <vrfExtProtocol/objType.h>

#define DtLineWidthFromAppearance(theAppr) ((theAppr >> 28) & 0x0000000F)
#define DtLineWidthToAppearance(theLineWidth) (theLineWidth << 28)
#define DtLineStyleFromAppearance(theAppr) ((theAppr >> 8) & 0x0000000F)
#define DtLineStyleToAppearance(theLineStyle) (theLineStyle << 8)
#define DtFillStyleFromAppearance(theAppr) ((theAppr >> 12) & 0x0000000F)
#define DtFillStyleToAppearance(theFillStyle) (theFillStyle << 12)

// Definition of the FIXED PORTION of the environmental state object.
// This will be followed by a variable length string of bytes to represent
// the object label, and 0 or more global object designators to represent
// any subordinate objects within the object represented.

// If this structure is of a previous type, use that structure instead
struct DtNetEnvironmentalObjectStateRecord_V1
{
   DtNetEnvironmentalRecord myHeader;
   DtNetU32                 myAppearance;
   DtNetU8                  myForceType;
   DtNetU8                  myLabelSize;
   DtNetU16                 myNumberOfSubordinates;
};

struct DtNetEnvironmentalObjectStateRecord_V2
{
   DtNetEnvironmentalRecord myHeader;
   DtNetU32                 myAppearance;
   DtNetU8                  myForceType;
   DtNetU8                  myLabelSize;
   DtNetU16                 myNumberOfSubordinates;
   DtNetU32                 myColor;
   DtNetU8                  myParentSize;
};

struct DtNetEnvironmentalObjectStateRecord_V3
{
   DtNetEnvironmentalRecord      myHeader;
   DtNetU32                      myAppearance;
   DtNetU8                       myForceType;
   DtNetU8                       myLabelSize;
   DtNetU16                      myNumberOfSubordinates;
   DtNetU32                      myColor;
   DtNetU8                       myParentSize;
   DtNetGlobalObjectDesignator   myHostGlobalId;
};

struct DtNetEnvironmentalObjectStateRecord_V4
{
   DtNetEnvironmentalRecord      myHeader;
   DtNetU32                      myAppearance;
   DtNetU8                       myForceType;
   DtNetU8                       myLabelSize;
   DtNetU16                      myNumberOfSubordinates;
   DtNetU32                      myColor;
   DtNetU8                       myParentSize;
   DtNetGlobalObjectDesignator   myHostGlobalId;
   DtNetU8                       myUserDataSize;
};

struct DtNetEnvironmentalObjectStateRecord
{
   DtNetEnvironmentalRecord      myHeader;
   DtNetU32                      myAppearance;
   DtNetU8                       myForceType;
   DtNetU8                       myLabelSize;
   DtNetU16                      myNumberOfSubordinates;
   DtNetU32                      myColor;
   DtNetU8                       myParentSize;
   DtNetGlobalObjectDesignator   myHostGlobalId;
   DtNetU16                       myUserDataSize;
};


const int DtMaxEnvProcessLabelLength = 255;

//
// Class Description: DtEnvironmentalStateRecord implements a form of an
// environmental state record not explicitly defined in the standard, but
// used in MaK applications.  It contains a DtForceType to identify the force
// with which the environmental object is associated (may be DtForceOther) and
// an entity state-like appearance vector (using DtAppearance).
//

#include <vrfExtObjects/vrfExtObjectsDefines.h>
class DT_DLL_vrfExtObjects DtSimEnvironmentalObjectStateRecord : public DtEnvironmentalRecord
{
public:
   // Default Constructor.  To function properly, the state record should be
   // initialized with an entity type.  If you don't know it yet at creation
   // time, you can use this constructor; but call setEntityType() before
   // using the appearance accessors.
   DtSimEnvironmentalObjectStateRecord();

   // Constructor
   DtSimEnvironmentalObjectStateRecord(const DtObjectType& objectType);

   // Copy Constructor
   DtSimEnvironmentalObjectStateRecord(
      const DtSimEnvironmentalObjectStateRecord& orig);

   // Assignment Operator
   const DtSimEnvironmentalObjectStateRecord& operator=(
      const DtSimEnvironmentalObjectStateRecord& orig);

   // Destructor
   virtual ~DtSimEnvironmentalObjectStateRecord();

   // Clone.  Return a copy of this instance.
   virtual DtEnvironmentalRecord* clone() const;

   virtual void setObjectType(const DtObjectType& objectType);

   // Appearance of the object.
   virtual void setAppearance(const DtAppearance& appearance);
   virtual const DtAppearance& appearance() const;

   // Force the object is associated with.
   virtual void setForceType(DtForceType forceType);
   virtual DtForceType forceType() const;

   virtual void setColor(int color);
   virtual int color() const;

   virtual void setVrfObjectName(const DtString& label);
   virtual const DtString& vrfObjectName() const;

   virtual void setParent(const DtString& parent);
   virtual const DtString& parent() const;

   virtual void setUserData(const DtString& userData);
   virtual const DtString& userData() const;

   virtual bool setNumberOfSubordinates(int newNumberOfSubordinates);
   virtual int numberOfSubordinates() const;

   virtual bool setSubordinate(int index,
      const DtGlobalObjectDesignator& subID);

   virtual bool getSubordinate(int index, DtGlobalObjectDesignator& subID)
      const;

   virtual const DtGlobalObjectDesignatorList& subordinates() const;
   virtual DtGlobalObjectDesignatorList& subordinates();

   // This doesn't need to be called explicitly.  If any routine that needs
   // the repository finds that it hasn't been created yet, it calls this
   // method.
   virtual bool createNetworkRepresentation();

   // returns the network representation of the environmental record
   const DtNetEnvironmentalObjectStateRecord* objStateNetRep() const;
   DtNetEnvironmentalObjectStateRecord* objStateNetRep();

   // used by the PDU class to fill in the network representation
   virtual void setFromNet(const DtNetEnvironmentalRecord& buffer);

   virtual int netRepSize() const;

   // If object is attached, this is the id of the parent
   virtual void setHostGlobalId(const DtGlobalObjectDesignator&);
   virtual const DtGlobalObjectDesignator& hostGlobalId() const;

   // Clears out the host global id (sets it to "")
   virtual void clearHostGlobalId();

   // Get/set projected, close and bound2d as in bit pattern above
   virtual void setProjected(bool);
   virtual bool projected() const;

   virtual void setClosedFigure(bool);
   virtual bool closedFigure() const;

   virtual void setBound2D(bool);
   virtual bool bound2D() const;

   virtual void setFillStyle(int);
   virtual int fillStyle() const;

   virtual void setLineStyle(int);
   virtual int lineStyle() const;

   virtual void setLineWidth(int);
   virtual int lineWidth() const;

protected:

   virtual bool resizeNetRep(int newSize);

   // These two functions do the pointer math to get a pointer to
   // the right place in the internal buffer for the start of these
   // data areas.

   virtual void* pointerToLabel() const;
   virtual void* pointerToParent() const;
   virtual void* pointerToSubordinates() const;
   virtual void* pointerToUserData() const;

   // Casts the 'this' pointer for changing elements in a const function.
   DtSimEnvironmentalObjectStateRecord* self() const;

   // Reworks the network buffer based on version
   virtual void reworkStateRepForVersion(int bytesToCopy, int iVersion);

protected:

   DtGlobalObjectDesignatorList mySubordinates;
   DtAppearance myAppearance;
   DtString myLabel;
   DtString myParent;
   int myColor;
   DtForceType myForceType;
   DtGlobalObjectDesignator   myHostGlobalId;
   DtString myUserData;

   int myNetRepSize;
};

#endif // DIS_VERS >= 5