All Games|libdoomsday: Added notification about psprite state changes

Whenever a psprite changes state, a plugin notification is sent so
the client can react to the change.

doomsday/apps/libdoomsday/include/doomsday/gameapi.h

@@ -106,7 +106,7 @@ enum {
     DD_SHARED_FIXED_TRIGGER_OBSOLETE, ///< obsolete
     DD_GAMETIC,
     DD_NOTIFY_PLAYER_WEAPON_CHANGED, ///< a player's weapon changed (including powerups)
-    DD_UNUSED6, // DD_OPENTOP
+    DD_NOTIFY_PSPRITE_STATE_CHANGED, ///< a player's psprite state has changed
     DD_UNUSED7, // DD_OPENBOTTOM
     DD_UNUSED8, // DD_LOWFLOOR
     DD_CPLAYER_THRUST_MUL_OBSOLETE, ///< obsolete

doomsday/apps/libdoomsday/include/doomsday/plugins.h

@@ -101,6 +101,12 @@ typedef struct {
     char const *weaponId;   ///< Defined in Values (includes power-ups) (UTF-8).
 } ddnotify_player_weapon_changed_t;
 
+/// Parameters for DD_NOTIFY_PSPRITE_STATE_CHANGED
+typedef struct {
+    int player;
+    struct state_s const *state;
+} ddnotify_psprite_state_changed_t;
+
 #ifdef __cplusplus
 
 #include <de/Observers>

doomsday/apps/plugins/common/include/player.h

@@ -256,6 +256,8 @@ angle_t Player_ViewYawAngle(int playerNum);
  */
 void Player_UpdateStatusCVars(player_t const *player);
 
+void Player_NotifyPSpriteChange(player_t *player, int position);
+
 /**
  * Called in the end of G_Ticker. Wraps up the tick for a player.
  *

doomsday/apps/plugins/common/src/player.cpp

@@ -1849,6 +1849,17 @@ void Player_PostTick(player_t *player)
     }
 }
 
+void Player_NotifyPSpriteChange(player_t *player, int position)
+{
+    if(position == ps_weapon)
+    {
+        ddnotify_psprite_state_changed_t args;
+        args.player = player - players;
+        args.state  = player->pSprites[position].state;
+        Plug_Notify(DD_NOTIFY_PSPRITE_STATE_CHANGED, &args);
+    }
+}
+
 /**
  * Updates game status cvars for the specified player.
  */

doomsday/apps/plugins/doom/src/p_pspr.c

@@ -104,6 +104,8 @@ void P_SetPsprite(player_t* player, int position, statenum_t stnum)
         psp->state = state;
         psp->tics = state->tics; // Could be 0.
 
+        Player_NotifyPSpriteChange(player, position);
+
         if(state->misc[0])
         {
             // Coordinate set.

doomsday/apps/plugins/doom64/src/p_pspr.c

@@ -110,6 +110,8 @@ void P_SetPsprite(player_t *player, int position, statenum_t stnum)
         psp->state = state;
         psp->tics = state->tics; // Could be 0.
 
+        Player_NotifyPSpriteChange(player, position);
+
         if(state->misc[0])
         {
             // Coordinate set.

doomsday/apps/plugins/heretic/src/p_pspr.c

@@ -76,6 +76,7 @@ void P_SetPsprite(player_t *player, int position, statenum_t stnum)
         state = &STATES[stnum];
         psp->state = state;
         psp->tics = state->tics; // Could be 0.
+        Player_NotifyPSpriteChange(player, position);
         if(state->misc[0])
         {   // Set coordinates.
             psp->pos[VX] = (float) state->misc[0];

doomsday/apps/plugins/hexen/src/p_pspr.c

@@ -317,6 +317,8 @@ void P_SetPsprite(player_t *plr, int position, statenum_t stnum)
         psp->tics = state->tics; // could be 0
         P_SetPSpriteOffset(psp, plr, state);
 
+        Player_NotifyPSpriteChange(plr, position);
+
         if(state->action)
         {   // Call action routine.
             state->action(plr, psp);
@@ -351,7 +353,9 @@ void P_SetPspriteNF(player_t *plr, int position, statenum_t stnum)
         psp->state = state;
         psp->tics = state->tics; // could be 0
 
+        Player_NotifyPSpriteChange(plr, position);
         P_SetPSpriteOffset(psp, plr, state);
+
         stnum = psp->state->nextState;
     } while(!psp->tics); // An initial state of 0 could cycle through.
 }