mirror of
https://github.com/zeldaret/oot.git
synced 2024-11-25 01:34:18 +00:00
Document Player_Action_TurnInPlace
(#2268)
* document turn in place * format * modify comments * sWaterSpeedFactor
This commit is contained in:
parent
746adfc727
commit
f79c9db649
2 changed files with 45 additions and 25 deletions
|
@ -897,7 +897,7 @@ typedef struct Player {
|
|||
/* 0x0874 */ f32 unk_874;
|
||||
/* 0x0878 */ f32 unk_878;
|
||||
/* 0x087C */ s16 unk_87C;
|
||||
/* 0x087E */ s16 unk_87E;
|
||||
/* 0x087E */ s16 turnRate; // Amount angle is changed every frame when turning in place
|
||||
/* 0x0880 */ f32 unk_880;
|
||||
/* 0x0884 */ f32 yDistToLedge; // y distance to ground above an interact wall. LEDGE_DIST_MAX if no ground is found
|
||||
/* 0x0888 */ f32 distToInteractWall; // xyz distance to the interact wall
|
||||
|
|
|
@ -273,7 +273,7 @@ void Player_Action_808414F8(Player* this, PlayState* play);
|
|||
void Player_Action_8084170C(Player* this, PlayState* play);
|
||||
void Player_Action_808417FC(Player* this, PlayState* play);
|
||||
void Player_Action_8084193C(Player* this, PlayState* play);
|
||||
void Player_Action_80841BA8(Player* this, PlayState* play);
|
||||
void Player_Action_TurnInPlace(Player* this, PlayState* play);
|
||||
void Player_Action_80842180(Player* this, PlayState* play);
|
||||
void Player_Action_8084227C(Player* this, PlayState* play);
|
||||
void Player_Action_8084279C(Player* this, PlayState* play);
|
||||
|
@ -513,8 +513,8 @@ static s16 sControlStickAngle = 0;
|
|||
static s16 sControlStickWorldYaw = 0;
|
||||
static s32 sUpperBodyIsBusy = false; // see `Player_UpdateUpperBody`
|
||||
static s32 sFloorType = FLOOR_TYPE_0;
|
||||
static f32 D_808535E8 = 1.0f;
|
||||
static f32 D_808535EC = 1.0f;
|
||||
static f32 sWaterSpeedFactor = 1.0f; // Set to 0.5f in water, 1.0f otherwise. Influences different speed values.
|
||||
static f32 sInvWaterSpeedFactor = 1.0f; // Inverse of `sWaterSpeedFactor` (1.0f / sWaterSpeedFactor)
|
||||
static u32 sTouchedWallFlags = 0;
|
||||
static u32 sConveyorSpeed = CONVEYOR_SPEED_DISABLED;
|
||||
static s16 sIsFloorConveyor = false;
|
||||
|
@ -2217,7 +2217,7 @@ void Player_ProcessControlStick(PlayState* play, Player* this) {
|
|||
}
|
||||
|
||||
void func_8083328C(PlayState* play, Player* this, LinkAnimationHeader* linkAnim) {
|
||||
LinkAnimation_PlayOnceSetSpeed(play, &this->skelAnime, linkAnim, D_808535E8);
|
||||
LinkAnimation_PlayOnceSetSpeed(play, &this->skelAnime, linkAnim, sWaterSpeedFactor);
|
||||
}
|
||||
|
||||
int func_808332B8(Player* this) {
|
||||
|
@ -4184,7 +4184,7 @@ static s8 sActionHandlerList5[] = {
|
|||
PLAYER_ACTION_HANDLER_12, PLAYER_ACTION_HANDLER_8, -PLAYER_ACTION_HANDLER_7,
|
||||
};
|
||||
|
||||
static s8 sActionHandlerList6[] = {
|
||||
static s8 sActionHandlerListTurnInPlace[] = {
|
||||
-PLAYER_ACTION_HANDLER_7,
|
||||
};
|
||||
|
||||
|
@ -4975,7 +4975,7 @@ void func_80838940(Player* this, LinkAnimationHeader* anim, f32 arg2, PlayState*
|
|||
Player_AnimPlayOnceAdjusted(play, this, anim);
|
||||
}
|
||||
|
||||
this->actor.velocity.y = arg2 * D_808535E8;
|
||||
this->actor.velocity.y = arg2 * sWaterSpeedFactor;
|
||||
this->hoverBootsTimer = 0;
|
||||
this->actor.bgCheckFlags &= ~BGCHECKFLAG_GROUND;
|
||||
|
||||
|
@ -5507,7 +5507,8 @@ s32 Player_ActionHandler_1(Player* this, PlayState* play) {
|
|||
play->transitionActors.list[GET_TRANSITION_ACTOR_INDEX(doorActor)]
|
||||
.sides[(doorDirection > 0) ? 0 : 1]
|
||||
.bgCamIndex,
|
||||
0, 38.0f * D_808535EC, 26.0f * D_808535EC, 10.0f * D_808535EC);
|
||||
0, 38.0f * sInvWaterSpeedFactor, 26.0f * sInvWaterSpeedFactor,
|
||||
10.0f * sInvWaterSpeedFactor);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
@ -6338,7 +6339,7 @@ void Player_SetupRoll(Player* this, PlayState* play) {
|
|||
Player_SetupAction(play, this, Player_Action_Roll, 0);
|
||||
LinkAnimation_PlayOnceSetSpeed(play, &this->skelAnime,
|
||||
GET_PLAYER_ANIM(PLAYER_ANIMGROUP_landing_roll, this->modelAnimType),
|
||||
FRAMERATE_CONST(1.25f, 1.5f) * D_808535E8);
|
||||
FRAMERATE_CONST(1.25f, 1.5f) * sWaterSpeedFactor);
|
||||
}
|
||||
|
||||
s32 Player_TryRoll(Player* this, PlayState* play) {
|
||||
|
@ -6747,11 +6748,14 @@ void func_8083CD00(Player* this, PlayState* play) {
|
|||
LinkAnimation_PlayOnceSetSpeed(play, &this->skelAnime, &gPlayerAnim_link_anchor_back_brake, 2.0f);
|
||||
}
|
||||
|
||||
void func_8083CD54(PlayState* play, Player* this, s16 yaw) {
|
||||
void Player_SetupTurnInPlace(PlayState* play, Player* this, s16 yaw) {
|
||||
this->yaw = yaw;
|
||||
Player_SetupAction(play, this, Player_Action_80841BA8, 1);
|
||||
this->unk_87E = 1200;
|
||||
this->unk_87E *= D_808535E8;
|
||||
|
||||
Player_SetupAction(play, this, Player_Action_TurnInPlace, 1);
|
||||
|
||||
this->turnRate = 1200;
|
||||
this->turnRate *= sWaterSpeedFactor; // slow turn rate by half when in water
|
||||
|
||||
LinkAnimation_Change(play, &this->skelAnime, GET_PLAYER_ANIM(PLAYER_ANIMGROUP_45_turn, this->modelAnimType), 1.0f,
|
||||
0.0f, 0.0f, ANIMMODE_LOOP, -6.0f);
|
||||
}
|
||||
|
@ -6957,7 +6961,7 @@ void func_8083D53C(PlayState* play, Player* this) {
|
|||
}
|
||||
} else if ((this->stateFlags1 & PLAYER_STATE1_27) && (this->actor.depthInWater < this->ageProperties->unk_24)) {
|
||||
if ((this->skelAnime.movementFlags == 0) && (this->currentBoots != PLAYER_BOOTS_IRON)) {
|
||||
func_8083CD54(play, this, this->actor.shape.rot.y);
|
||||
Player_SetupTurnInPlace(play, this, this->actor.shape.rot.y);
|
||||
}
|
||||
func_8083D0A8(play, this, this->actor.velocity.y);
|
||||
}
|
||||
|
@ -8166,7 +8170,7 @@ void Player_Action_808407CC(Player* this, PlayState* play) {
|
|||
temp3 = ABS(temp2);
|
||||
|
||||
if (temp3 > 800) {
|
||||
func_8083CD54(play, this, yawTarget);
|
||||
Player_SetupTurnInPlace(play, this, yawTarget);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
@ -8252,8 +8256,8 @@ void Player_ChooseNextIdleAnim(PlayState* play, Player* this) {
|
|||
}
|
||||
}
|
||||
|
||||
LinkAnimation_Change(play, &this->skelAnime, anim, (2.0f / 3.0f) * D_808535E8, 0.0f, Animation_GetLastFrame(anim),
|
||||
ANIMMODE_ONCE, -6.0f);
|
||||
LinkAnimation_Change(play, &this->skelAnime, anim, (2.0f / 3.0f) * sWaterSpeedFactor, 0.0f,
|
||||
Animation_GetLastFrame(anim), ANIMMODE_ONCE, -6.0f);
|
||||
}
|
||||
|
||||
void Player_Action_Idle(Player* this, PlayState* play) {
|
||||
|
@ -8307,7 +8311,7 @@ void Player_Action_Idle(Player* this, PlayState* play) {
|
|||
yawDiff = yawTarget - this->actor.shape.rot.y;
|
||||
|
||||
if (ABS(yawDiff) > 800) {
|
||||
func_8083CD54(play, this, yawTarget);
|
||||
Player_SetupTurnInPlace(play, this, yawTarget);
|
||||
return;
|
||||
}
|
||||
|
||||
|
@ -8626,7 +8630,14 @@ void Player_Action_8084193C(Player* this, PlayState* play) {
|
|||
}
|
||||
}
|
||||
|
||||
void Player_Action_80841BA8(Player* this, PlayState* play) {
|
||||
/**
|
||||
* Turn in place until the angle pointed to by the control stick is reached.
|
||||
*
|
||||
* This is the state that the speedrunning community refers to as "ESS" or "ESS Position".
|
||||
* See the bug comment below and https://www.zeldaspeedruns.com/oot/tech/extended-superslide
|
||||
* for more information.
|
||||
*/
|
||||
void Player_Action_TurnInPlace(Player* this, PlayState* play) {
|
||||
f32 speedTarget;
|
||||
s16 yawTarget;
|
||||
|
||||
|
@ -8641,11 +8652,19 @@ void Player_Action_80841BA8(Player* this, PlayState* play) {
|
|||
|
||||
Player_GetMovementSpeedAndYaw(this, &speedTarget, &yawTarget, SPEED_MODE_CURVED, play);
|
||||
|
||||
if (!Player_TryActionHandlerList(play, this, sActionHandlerList6, true)) {
|
||||
//! @bug This action does not handle xzSpeed in any capacity.
|
||||
//! Player's current speed value will be maintained the entire time this action is running.
|
||||
//! This is the core bug that allows many different glitches to manifest.
|
||||
//!
|
||||
//! One possible fix is to kill all speed instantly in `Player_SetupTurnInPlace`.
|
||||
//! Another possible fix is to gradually kill speed by calling `Player_DecelerateToZero`
|
||||
//! here, which plenty of other "standing" actions do.
|
||||
|
||||
if (!Player_TryActionHandlerList(play, this, sActionHandlerListTurnInPlace, true)) {
|
||||
if (speedTarget != 0.0f) {
|
||||
this->actor.shape.rot.y = yawTarget;
|
||||
func_8083C858(this, play);
|
||||
} else if (Math_ScaledStepToS(&this->actor.shape.rot.y, yawTarget, this->unk_87E)) {
|
||||
} else if (Math_ScaledStepToS(&this->actor.shape.rot.y, yawTarget, this->turnRate)) {
|
||||
func_8083C0E8(this, play);
|
||||
}
|
||||
|
||||
|
@ -10188,7 +10207,7 @@ void Player_Action_80845CA4(Player* this, PlayState* play) {
|
|||
this->av2.actionVar2 = 1;
|
||||
}
|
||||
} else if (this->av1.actionVar1 == 0) {
|
||||
f32 sp3C = 5.0f * D_808535E8;
|
||||
f32 sp3C = 5.0f * sWaterSpeedFactor;
|
||||
s32 temp = func_80845BA0(play, this, &sp3C, -1);
|
||||
|
||||
if (temp < 30) {
|
||||
|
@ -11904,12 +11923,13 @@ void Player_UpdateCommon(Player* this, PlayState* play, Input* input) {
|
|||
Player_ProcessControlStick(play, this);
|
||||
|
||||
if (this->stateFlags1 & PLAYER_STATE1_27) {
|
||||
D_808535E8 = 0.5f;
|
||||
sWaterSpeedFactor = 0.5f;
|
||||
} else {
|
||||
D_808535E8 = 1.0f;
|
||||
sWaterSpeedFactor = 1.0f;
|
||||
}
|
||||
|
||||
D_808535EC = 1.0f / D_808535E8;
|
||||
sInvWaterSpeedFactor = 1.0f / sWaterSpeedFactor;
|
||||
|
||||
sUseHeldItem = sHeldItemButtonIsHeldDown = false;
|
||||
sSavedCurrentMask = this->currentMask;
|
||||
|
||||
|
|
Loading…
Reference in a new issue