Function PlayerSwitchToObserver

Descent3/Player.cpp:3500–3549

Switches a player object to observer mode

// Switches a player object to observer mode
void PlayerSwitchToObserver(int slot, int observer_mode, int piggy_objnum) {
  object *obj = &Objects[Players[slot].objnum];

  // call the event to the multiplayer DLL's so they can do what they need
  if (Game_mode & GM_MULTI) {
    DLLInfo.me_handle = obj->handle;

    if (observer_mode == OBSERVER_MODE_PIGGYBACK) {
      DLLInfo.it_handle = Objects[piggy_objnum].handle;
    } else {
      DLLInfo.it_handle = OBJECT_HANDLE_NONE;
    }

    CallGameDLL(EVT_CLIENT_GAMEPLAYERENTERSOBSERVER, &DLLInfo);
  }

  // Stop sounds for this player
  PlayerStopSounds(slot);

  if (slot == Player_num) {
    AddHUDMessage(TXT_ENTEROBS);
    SetHUDMode(HUD_OBSERVER);
    Players[slot].movement_scalar = 2.0;
  } else
    AddHUDMessage(TXT_PLYRENTEROBS, Players[slot].callsign);

  CreateRandomSparks(30, &obj->pos, obj->roomnum, HOT_SPARK_INDEX, (ps_rand() % 3) + 2);

  if (Demo_flags != DF_PLAYBACK) {
    PlayerSpewInventory(obj, false);
  }

  obj->type = OBJ_OBSERVER;
  obj->render_type = RT_NONE;

  if (Demo_flags == DF_RECORDING) {
    DemoWritePlayerTypeChange(slot, false, observer_mode, piggy_objnum);
  }

  if (observer_mode == OBSERVER_MODE_ROAM) {
    SetObjectControlType(obj, CT_FLYING);
    Players[slot].piggy_objnum = -1;
    obj->movement_type = MT_PHYSICS;
  } else if (observer_mode == OBSERVER_MODE_PIGGYBACK) {
    SetObjectControlType(obj, CT_NONE);
    Players[slot].piggy_objnum = piggy_objnum;
    Players[slot].piggy_sig = Objects[piggy_objnum].handle & HANDLE_COUNT_MASK;
    mprintf(0, "Object %d is observing object %d!\n", obj - Objects, piggy_objnum);
  }
}

// Stops a player from observing
void PlayerStopObserving(int slot) {