the Actor class class was the rendezvous point; the classes from above and the classes from below met here. it's a really big class, with all kinds of crap in it, but hardly unsalvagable.

class Actor : public MovementObject

object creation et al

• Actor(const SObjectStartupData* startupData );
• virtual Actor();
• virtual MsgPort& GetMsgPort();
• MsgPort _msgPort;
• virtual void die();

physics / collision detection / position / movement

• movement
• * inline const Vector3 GetPredictedPosition() const;
• * inline const Vector3& currentPos() const;
• * inline void setCurrentPos( const Vector3& pos );
• * inline void setSpeed( const Vector3& speed ); // kts 11-11-95 10:02pm
• * virtual bool CanCollide() const; // used to decide which to put it the rooms render & update lists
• * bool GetSpecialCollisionMessage(void* msgData, int32 maxsize);
• * MovementManager _movementManager;
• * Path* _path;
• collision
• * inline const ColSpace& GetColSpace() const; // optimization for room vs. actor collisions
• PhysicalObject interface/overrides
• * virtual const PhysicalAttributes& GetPhysicalAttributes() const;
• * virtual PhysicalAttributes& GetWritablePhysicalAttributes();
• * void Collision(PhysicalObject& other, const Vector3& normal);
• * virtual MovementManager& GetMovementManager();
• * virtual void MovementStateChanged( const MovementObject::EMovementState newState ); // so we can notify the animation system
• * PhysicalAttributes _physicalAttributes;

input

• inline QInputDigital* GetInputPointer() const;
• inline void SetInputDevice(QInputDigital*);
• virtual const QInputDigital* GetInputDevice() const;
• InputScript* _inputScript; // contained in _input in case of _input mapping to a mailbox
• QInputDigital* _input; // used everywhere in game to get input, must be written to by script
• void _InitInput( const SObjectStartupData* startupData );

scene graph "management"

// actor index

• inline int GetActorIndex() const;
• inline void SetActorIndex( int32 idxActor ); // Only call once (and only on templated objects) and only if you're level
• unsigned _idxActor : 11; // 2048 objects max.

display / rendering

• virtual bool CanRender() const;
• virtual bool isVisible() const;

// mesh

• RenderActor* _renderActor;
• AnimationManager* _animManager;
• unsigned _lastVisibility : 1;
• unsigned _visibility : 1;

// handles

• bool LocalHandleLocation( HandleID id, Vector3& dest ) const;
• bool GlobalHandleLocation( HandleID id, Vector3& dest ) const;

actor

• virtual bool CanUpdate() const; // used to decide which to put it the rooms render & update lists
• virtual void reset();
• // actor "program" / "loop"
• virtual void predictPosition(const Clock& currentTime); // Predict "desired" new position for this frame
• virtual void update();
• void UpdateAnimation();
• void StartFrame(); // this is a catch all, it is guaranteed to run after all actors have run update, but before prepareToRender
• inline const bool hasRunUpdate() const;
• inline const bool hasRunPredictPosition() const;

printing / debugging

• std::ostream& printDetailed( std::ostream& s ) const;
• virtual std::ostream& Print( std::ostream& ) const;
• virtual void Validate() const;

ActivationBoxes

• virtual bool IsActivationBox() const;
• BaseObject* Activated(BaseObjectIteratorWrapper objectIter, struct _Activation* actbox, int32* objList ) const;

music / sound effects

• short PlaySoundEffect( int program );

memory

• virtual Memory& GetMemory() const;
• // room transitions
• virtual void BindAssets(Memory& memory); // bind into current room
• virtual void UnBindAssets(); // unbind, get rid of all transient assets

utility

• Scalar GetDistanceTo( const Actor *pActor ) const;

---

"variables"

• // oad
• inline const _Common* GetCommonBlockPtr() const;
• inline const _Toolset* GetToolsetBlockPtr() const;
• inline const _Mesh* GetMeshBlockPtr() const;
• inline const _ShadowPage* GetShadowPageBlockPtr() const;
• inline int32 GetMeshName() const;
• // each derived class includes: private: inline const Class* getOad() const
• // mailbox / messages / inter-object communication
• Scalar ReadSystemMailbox( int boxnum ) const;
• void WriteSystemMailbox( int boxnum, const Scalar value );
• ActorMailboxes _mailboxes;
• virtual Mailboxes& GetMailboxes();
• virtual const Mailboxes& GetMailboxes() const;

class ActorMailboxes : public MailboxesWithStorage
{
public:
   ActorMailboxes(Actor& actor, long mailboxesBase, long numberOfLocalMailboxes, Mailboxes* parent);
   virtual ~ActorMailboxes();
   virtual Scalar ReadMailbox(long mailbox) const;
   virtual void WriteMailbox(long mailbox, Scalar value);
};

scripting

• void _InitScript( const SObjectStartupData* startupData );
• const void* _pScript;

get rid of this crap

• // tool stuff
• inline bool IsNeedleGunTarget() const;
• void spawnPoof() const; // friend to level class only
• // hitpoints / health / shield-type stuff
• static const Scalar INDESTRUCTIBLE_HP;
• Scalar getHealth() const;
• void deltaHealth( Scalar nHealth );
• int32 getPower() const;
• void _InitShadow();
• void _InitTools();
• Shield* _shield; // pointer to shield if this actor has one // will go away
• Tool* _tool_MAX_TOOLS ;
• int _nTools; // not strictly necessary, but code can determine if it should bother
• Scalar _hitPoints;
• virtual bool IsLight() const;

---

<hal/hal.h> <math/scalar.hp> <mailbox/mailbox.hp> <physics/colspace.hp> <oas/levelcon.h> <baseobject/msgport.hp> <physics/physicalobject.hp> <movement/movementobject.hp> <movement/movementmanager.hp> <movement/movement.hp> <cpplib/minlist.hp> <anim/path.hp> <physics/physical.hp> <physics/colbox.hp> <oas/objectstartupdata.hp> <oas/movebloc.ht> <oas/toolset.ht> <oas/common.ht> <oas/mesh.ht> <oas/shadowp.ht> "rendacto.hp" "animmang.hp"

friend class AnimationManagerActual; friend class MovementManager; friend class PathHandler; friend class MovementHandler; friend class GroundHandler; friend class AirHandler; friend class ClimbHandler; friend class CameraHandler;

class also contains a RenderActor, PhysicalAttributes, NonStatPlatData (a space optimization only)

see also RoomClass, LevelClass, and GameClass