Sonic Advance 2 (the SAT-R decompilation, SAT-R/sa2)

In Sonic Advance 2 the ground acceleration rises with the ring count. At the start of each frame Player_HandleBoostThreshold picks a bracket from the rings and Player_ApplyBoostPhysics sets the acceleration from playerBoostPhysicsTable: 8 subpixels (1/256 px/frame) a frame with 10 rings or fewer, 12 with 11 to 49, 14 with 50 to 99, 16 with 100 to 149, and 18 with 150 or more. The deceleration, taken when the d-pad is held against the motion, is 64 in every bracket, and the speed-up item doubles both. With neither Left nor Right held, or while unk2A counts down (a 30-frame timer set when the player slips off a steep slope, in the atlas's reading), Player_HandleGroundMovement takes a fixed 8 a frame off the speed toward 0. Sonic 1's rates are $C (12) to accelerate, the same $C for the friction, and $80 (128) against the motion. sa2/ground-rates

About: Sonic Advance 2 Running

{
 "accel": [
  8,
  12,
  14,
  16,
  18
 ],
 "decel": 64,
 "friction": 8
}

The left-moving branches mirror the right (L9009-L9019, L9075-L9084). The table's speeds are in the same 1/256 px units as Sonic 1's subpixels (Q(n) is n × 256). d5 in Sonic 1's friction holds the acceleration (s1disasm/ground-friction). The ring count is gRingCount; the atlas hasn't read how multiplayer modes count rings.

Cited by: Running, Sonic Advance 2

Outside boost mode Player_ApplyBoostPhysics sets topSpeed, the speed holding forward builds to in Player_HandleGroundMovement, to 6 px/frame (Q(6.0)), Sonic 1's son_maxspeed ($600). A faster speed, from a slope, is cut only at maxSpeed, by sub_8023260, which the ground state (Player_Idle) calls after adding the slope term: 9 px/frame, or 15 while MOVESTATE_SPIN_ATTACK is set, as a spin dash sets it. sa2/top-speed

About: Sonic Advance 2 Running

{
 "top": 1536,
 "cap": 2304,
 "capSpinAttack": 3840
}

Q(n) is n × 256 (include/global.h), so 6, 9, and 15 px/frame are 1536, 2304, and 3840. The slope term is GET_ROTATED_ACCEL, the sine of the angle × 3 / 32.

Cited by: Running, Sonic Advance 2

Boost mode starts from a run held at the top speed. Holding forward on the ground at 6 px/frame or faster, Player_HandleGroundMovement leaves the speed as it is and adds the frame's acceleration to boostSpeed, in the branch where Sonic 2's Sonic_MoveRight keeps a speed above the top and Sonic 1's cuts it back to the top. At the start of each frame Player_HandleBoostState turns boost mode on once boostSpeed reaches the ring bracket's entry in playerBoostThresholdTable: Q(8) (2048) with 10 rings or fewer, 2040 with 11 to 49, 1680 with 50 to 99, 1440 with 100 to 149, and 1080 with 150 or more. In the air or below the top speed it sets boostSpeed back to 0. With each bracket's acceleration that is 256, 170, 120, 90, and 60 frames of holding forward at the top speed, and half as many with the speed-up item (computed). sa2/boost-trigger

About: Sonic Advance 2 Running

{
 "threshold": [
  2048,
  2040,
  1680,
  1440,
  1080
 ],
 "frames": [
  256,
  170,
  120,
  90,
  60
 ]
}

The reset writes isBoostActive, which is false on that branch, in the matching build (NON_MATCHING is the ports' build and writes 0). The frame counts are 2048 / 8, 2040 / 12, 1680 / 14, 1440 / 16, and 1080 / 18, all whole. They count frames at the top speed: the frame the run reaches it adds nothing, and boost mode starts at the beginning of the frame after the last addition. A run slowed below the top speed by an uphill slope loses the count.

Cited by: Sonic Advance 2

In boost mode Player_ApplyBoostPhysics raises topSpeed, the speed holding forward builds to, from 6 to 12 px/frame, twice Sonic 1's single top speed (son_maxspeed, $600; computed), and maxSpeed, the ground cap, to 15; the acceleration still follows the ring count. Player_HandleBoostState looks for the end of boost mode only on the ground, where a ground speed below 4.5 px/frame ends it. Among the other ends are a hit (Player_InitHurt), the start of Tails's or Cream's flight, a multiplayer finish, the special stage transition, and InitializePlayer. sa2/boost-mode

About: Sonic Advance 2 Running

{
 "top": 3072,
 "cap": 3840,
 "end": 1152
}

The list of ends isn't complete: player_callbacks.c also clears isBoosting in Player_SonicAmy_InitStopNSlam (L286) and Player_Knuckles_InitGlide (L1811), and player_super_sonic.c in SuperSonicInitPlayer (L97); the atlas hasn't read those paths' conditions. Boost mode also starts boost particles and a sound (CreateBoostModeParticles, SE_221, L9137-L9141), and some objects and Sonic's and Amy's skid attack test isBoosting; the atlas hasn't read those. A ground speed between 4.5 and 12 px/frame keeps boost mode, so a boosted run can slow on a slope or a brake without losing it until it drops below 4.5.

Cited by: Running, Sonic Advance 2

Player_InitJump, which doesn't test the character, adds PLAYER_JUMP_HEIGHT, 4.875 px/frame (2.625 in water), to the speed along the ground's normal (rotation - 64). Sonic 1's Sonic_Jump adds son_jumpspeed, $680 (6.5 px/frame), along the normal the same way, so Sonic Advance 2's take-off is three quarters of it (computed). sa2/jump-speed

About: Sonic Advance 2 Jump

Value: 1248 1/256 px/frame

4.875 × 256 = 1248, and 1248 / 1664 = 0.75 exactly. rotation is a byte angle, 64 to a quarter turn, as Sonic 1's $40 is. Player_InitJump adds to the speed the player already has, and on a standing object in a boss stage it also takes off the camera's motion (L6993-L6997).

Cited by: Jump, Sonic Advance 2

Each frame of a jump, button held or not, Player_Jumping adds PLAYER_GRAVITY, 42/256 px/frame² (12/256 in water), to the vertical speed through PLAYERFN_UPDATE_AIR_FALL_SPEED, except on a frame where Sonic's forward thrust or a mid-air move starts (Player_Sonic_TryForwardThrust, Player_TryMidAirAction): Player_Jumping returns before the gravity then. That is three quarters of the gravity Sonic 1's airborne-rolling mode, Sonic_MdJump2, adds through ObjectFall, $38 (56/256) a frame (computed). sa2/gravity

About: Sonic Advance 2 Gravity

Value: 42 1/256 px/frame²

42 / 56 = 0.75 exactly. The decompilation has a second macro, PLAYERFN_UPDATE_AIR_FALL_SPEED_B, that halves the gravity while the player rises; Player_DefaultTrick and two other states use it, the jump doesn't.

Cited by: Gravity, Sonic Advance 2

In a jump (MOVESTATE_100, which Player_InitJump sets), on any frame the jump button isn't held, Player_Jumping cuts a rise faster than 3 px/frame to exactly −3 (PLAYER_MAX_NOT_HELD_JUMP_FORCE; −1.5 in water). Outside the Collect Rings multiplayer mode it first tries Sonic's forward thrust and the mid-air moves (Player_Sonic_TryForwardThrust, Player_TryMidAirAction), and a frame on which one starts skips the cap. Sonic 1's Sonic_JumpHeight cuts to 4 px/frame (-$400), so this cap too is three quarters of Sonic 1's (computed). sa2/release-cap

About: Sonic Advance 2 Variable jump height

Value: -768 1/256 px/frame

−768 / −1024 = 0.75 exactly. As in Sonic 1 (s1disasm/release-order), the cap comes before the frame's gravity (L7041). The comment on the cap is the decompilers'.

Cited by: Sonic Advance 2, Variable jump height

While the spin dash charges, each jump press adds Q(2.0) (512) to qSpindashAccel and then raises it to at least Q(8.0) (2048) with MAX, so one press is a full charge, the starting press included: Player_TryInitSpindash runs Player_InitSpindash and then Player_Spindash in the same frame. Each frame Down stays held first takes 1/32 off the charge. Releasing Down sets the ground speed from sSpinDashSpeeds at the charge's whole part, capped at 8: 6 px/frame plus 3/8 a step, up to 9, so a release on the frame after a press always gives 9 px/frame (computed). In Sonic 2 the starting press sets spindash_counter to 0, and each later press adds $200 up to a cap of $800, so a full charge takes five presses in all (computed); its release speeds run from 8 to 12 px/frame. sa2/spindash

About: Sonic Advance 2 Spin dash

[
 1536,
 1632,
 1728,
 1824,
 1920,
 2016,
 2112,
 2208,
 2304
]

MAX is ((a) > (b)) ? (a) : (b) (include/global.h), a floor where Sonic 2 has a ceiling; the decompilers call the charge pitch because it also sets the rev sound's pitch. I(pitch << 3) is pitch × 8 / 256, a 32nd. From 2048, one held frame without a press leaves 1984, whose whole part is 7 (8.625 px/frame). Player_Spindash is matching code, so the floor is the game's, not a decompilation slip.

Cited by: Sonic Advance 2