A WeaponReady

A_WeaponReady is a code pointer used in the normal weapon animation for all weapons.

is used in every weapon's idle/weapon bobbing sequence; most weapons (with the exception of the chainsaw) have an idle sequence that simply calls this code pointer every tic. The function performs a number of different actions:


 * If the player's attack button is held down, it begins the firing animation for the current weapon. For this reason, if the player is switching weapons, pressing fire will do nothing until the weapon raise sequence has completed and  is called.


 * If the player is selecting a new weapon, begins the weapon lower sequence to switch to the new weapon. For this reason, if the player tries to switch to a new weapon while firing their current weapon, the change will not begin until the current firing sequence has completed and  is called.


 * If the player's avatar is in state  (Dehacked frame 154) or   (frame 155), transitions to   (frame 149). This ensures that once a player stops firing, other players in a multiplayer game see their avatar stop firing.


 * Performs the weapon "bobbing" effect. As a result, because the chainsaw only calls  once every four tics, its bobbing is visibly less smooth than other weapons.


 * If the chainsaw is equipped, the DSSAWIDL sound effect is played.

Uses
The  code pointer appears in the following states in Doom's state table:

Example
The following is an example of how to set the  code pointer in a Dehacked file:

Pointer 21 (Frame 34) Codep Frame = 81

Or using BEX syntax:

[CODEPTR] Frame 1234 = WeaponReady