Flying: Difference between revisions

From Ukikipedia
Jump to navigation Jump to search
(→‎Behavior: clarify)
(→‎update_flying: explain best flying)
 
(3 intermediate revisions by the same user not shown)
Line 56: Line 56:
Notice that there is no code handling air steps for ledge grabbing or hanging on a ceiling, so such transitions are impossible.
Notice that there is no code handling air steps for ledge grabbing or hanging on a ceiling, so such transitions are impossible.
===update_flying===
===update_flying===
Casually, tilt the joystick left to move left, right to move right, up to move down, down to move up.
Casually, tilt the joystick left to move left, right to move right, up to move down, down to move up. '''TODO:''' I heard moving down then up can be faster then just the direct line. Explain big picture movements, what happens in a practical example.


I am too lazy to describe the exact details of <code>update_flying</code>, so here is the code
Beyond this, the pseudocode is provided but probably isn't as useful as the <code>update_flying</code> code itself:
# Joystick inputs affect (pitch,yaw) velocity.
# Yaw velocity affects yaw, roll, and forward velocity.
# Pitch affects forward velocity.
# Forward velocity becomes at least 0
# Forward velocity affects pitch (see below table)
# Pitch velocity affects pitch.
# Pitch is clamped to be inside [-0x2AAA, 0x2AAA]
# x,y,z velocity is more or less directly exactly trigonometrically correspondent to forward velocity, pitch, and yaw.
# xz sliding velocity updated to correspond
<syntaxhighlight lang="c">
<syntaxhighlight lang="c">
void update_flying(struct MarioState *m) {
void update_flying(struct MarioState *m) {
Line 98: Line 107:
}
}
</syntaxhighlight>
</syntaxhighlight>
Key takeaways:
'''Key takeaways''':
* Pitching to move up happens faster with lower forward velocity. Try to be just under 4 or 16 forward velocity.
* Pitch velocity ''additively'' affects forward velocity, but ''sin'' effects pitch. '''The most energy efficient flying is to fly a lot down, and then a little up''', as, for example, sin(-0.5) + sin(0.25) + sin(0.25) ≈ 0.0153823799048 (positive), while the totally additive effect is still 0 (actually -0.3 because of a flat -0.1 per trame)
* Pitching to move up happens faster with higher forward velocity.
** The difference between 4 and 5 speed, and 16 and 17 speed is especially large.
* At the same time, forward velocity is based on pitch. (But it is also based on:)
** There is a base 0.1 forwardVel speed loss
** There is anywhere from 0 to 0.5 further speed loss - more speed is lost the higher the yaw velocity is (ie '''the more Mario turns''').
* Pitch has a minimum and maximum and cannot overflow with standard speeds.
* '''More below the tables'''
{| class="wikitable"
{| class="wikitable"
|+forwardVel's affect in pitch
|+forwardVel's affect on pitch
|'''<=4'''
|'''<=4'''
|5
|5
Line 123: Line 139:
|33
|33
|-
|-
| -400
| -1024
| -270
| -270
| -260
| -260
Line 144: Line 160:
|6
|6
|}
|}
* However, the pitch is capped to within +- 0x2AAA (in decimal: 10922)
* '''TODO:''' I heard moving down then up can be faster then just the direct line. Explain big picture movements, what happens in a practical example.
* In summary:
# Joystick inputs affect (pitch,yaw) velocity.
# Yaw velocity affects yaw, roll, and forward velocity.
# Pitch affects forward velocity.
# Forward velocity affects pitch.
# Pitch velocity affects pitch.
# x,y,z velocity is more or less directly exactly correspondent to forward velocity, pitch, and yaw.
<hr>
<hr>
Here are some tables summarizing the <code>approach_s32</code>, <code>update_flying_pitch</code>, and <code>update_flying_yaw</code> functions.
Here are some tables summarizing the <code>approach_s32</code>, <code>update_flying_pitch</code>, and <code>update_flying_yaw</code> functions.
Line 165: Line 172:
|negative pitch velocity
|negative pitch velocity
|add 64 vel, cap at 32
|add 64 vel, cap at 32
| approach (at most 40 up or 20 down)
| approach (at most 64 up or 32 down)
|approach 0 (by at most 40)
|approach 0 (by at most 64)
|-
|-
|positive pitch velocity
|positive pitch velocity
| approach (at most 20 down or 40 up)
| approach (at most 32 up or 64 down)
|subtract 64 vel, cap at -32
|subtract 64 vel, cap at -32
|approach 0 (by at most 40)
|approach 0 (by at most 64)
|-
|-
|zero pitch velocity
|zero pitch velocity
| approach (at most 20 down or 40 up)
| approach (at most 32 up or 64 down)
| approach (at most 40 up or 20 down)
| approach (at most 64 up or 32 down)
| approach 0 (by at most 40)
| approach 0 (by at most 64)
|}
|}
{| class="wikitable"
{| class="wikitable"
Line 187: Line 194:
|negative yaw velocity
|negative yaw velocity
| add 64 vel, cap at 16
| add 64 vel, cap at 16
|approach (at most 20 up or 10 down)
|approach (at most 32 up or 16 down)
|approach 0 (by at most 40)
|approach 0 (by at most 64)
|-
|-
|positive yaw velocity
|positive yaw velocity
| approach (at most 10 up or 20 down)
| approach (at most 16 up or 32 down)
| subtract 64 vel, cap at -16
| subtract 64 vel, cap at -16
|approach 0 (by at most 40)
|approach 0 (by at most 64)
|-
|-
|zero yaw velocity
|zero yaw velocity
|approach (at most 10 up or 20 down)
|approach (at most 16 up or 32 down)
|approach (at most 20 up or 10 down)
|approach (at most 32 up or 16 down)
|approach 0 (by at most 40)
|approach 0 (by at most 64)
|}
|}
'''Key takeaways''':
# Many joystick positions are equivalent.
# One cannot change velocity by more than 64 (ignoring the effects of speed)
# Holding joystick x=0 or y=0 will approach the corresponding 0 by at most 64.
#* In contrast, holding the opposite direction changes the angle by 32 (yaw) or 64 (pitch), unconditionally
#* In further contrast, holding less of the same direction changes the angle by 32 (yaw) or 64 (pitch)
#* In even furthest contrast, holding more of the same direction changes the angle by 16 (yaw) or 32 (pitch)
#* So it might be faster to say, modify pitch:as such: -56 to -4 to 60 instead of -56 to 8 to 40. Notice the slightly under zero instead of slightly over zero.
After that, update_flying_yaw does:
After that, update_flying_yaw does:
#Add yaw velocity to yaw
#Add yaw velocity to yaw
# Set roll to yaw times negative twenty (-20)
# Set roll to yaw times negative twenty (-20)
'''Note that turning left = positive yaw''' (up = positive pitch).<ref>https://youtu.be/TQt8MCsniQI</ref>
'''Note that turning left = positive yaw''' (up = positive pitch).<ref>https://youtu.be/TQt8MCsniQI</ref><syntaxhighlight lang="c">
As can be seen, many joystick positions will be equivalent, and the pitch velocity or yaw velocity change by at most 40.
*
<syntaxhighlight lang="c">
/**
/**
  * Return the value 'current' after it tries to approach target, going up at
  * Return the value 'current' after it tries to approach target, going up at

Latest revision as of 16:37, 2 August 2024

Flying
Properties
Hex 0x10880899
Action Flags air, diving, attacking, swimming/flying
Action Group Airborne
ID 0x099
Transitions
Into Airborner cancels: Water Plunge, Squished, Vertical Wind (theoretically), (Technically, because of the flying triple jump code): Double Jump Land, Lava Boost (theoretically), non cancel: Ground Pound, Freefall, Dive Slide, Backwards Air Kb, Lava Boost (again) (theoretically)
Out of Shot From Cannon, Flying Triple Jump, when spawning in some levels like Tower of the Wing Cap
Other
Animation 0x5B fly from cannon, 0xCF forwards spinning flip, 0x29 wing cap fly

Flying is an action that can occurs when Mario triple jumps or does a cannon shot while wearing the wing cap.

Entering flying

  • Cannon shot: when y vel < 0 (and Mario does not cancel) (Action argument: 0)
  • Flying Triple Jump: when y vel < 4 (and Mario does not cancel, dive, or ground pound) (Action argument: 1)

Behavior

As with all airborne actions, a variety of "cancels" are checked prior to actually performing any airborne action. See Jump#Airborne cancels.

Then:[1]

  1. If Z is pressed
    1. If Mario's camera mode is CAMERA_MODE_BEHIND_MARIO, set_camera_mode to m->area->camera->defMode
    2. Ground Pound
  2. If Mario is not wearing the wing cap
    1. If Mario's camera mode is CAMERA_MODE_BEHIND_MARIO, set_camera_mode to m->area->camera->defMode
    2. Freefall
  3. If Mario's camera mode is not CAMERA_MODE_BEHIND_MARIO, set_camera_mode to CAMERA_MODE_BEHIND_MARIO
  4. If the action state is 0
    1. If the action argument is 0 (was shot from cannon), set Mario's animation to MARIO_ANIM_FLY_FROM_CANNON, else set Mario's animation to MARIO_ANIM_FORWARD_SPINNING_FLIP
    2. If the animation finished,
      1. If the action argument is 2 (spawned in), load_level_init_text and set action argument to 1
      2. Set Mario's animation to MARIO_ANIM_WING_CAP_FLY
      3. Set action state to 1
  5. Call update_flying
  6. switch Movement_steps#Perform_Air_Step: (Note: if there are no floor/wall/ceiling/oob interactions this just adds vel[0,1,2] to pos[0,1,2].)
    • air step none:
      1. Update graphics (camera) angle to be behind Mario
      2. Set action timer to 0
    • air step land:
      1. Set action to Dive Slide
      2. Set animation to MARIO_ANIM_DIVE
      3. Set animation frame to 7
      4. Set facing angle (x) to 0
      5. Set camera mode to m->area->camera->defMode
    • air step hit wall:
      1. todo
      2. if wall is not null, stuff, Backwards Air Kb
      3. else, stuff (but no knockback, this is probably out of bounds)
    • air step hit lava wall:
      1. stop holding, stop riding, Lava Boost
  7. finally, play the flying sound (adjust sound for speed)

Notice that there is no code handling air steps for ledge grabbing or hanging on a ceiling, so such transitions are impossible.

update_flying

Casually, tilt the joystick left to move left, right to move right, up to move down, down to move up. TODO: I heard moving down then up can be faster then just the direct line. Explain big picture movements, what happens in a practical example.

Beyond this, the pseudocode is provided but probably isn't as useful as the update_flying code itself:

  1. Joystick inputs affect (pitch,yaw) velocity.
  2. Yaw velocity affects yaw, roll, and forward velocity.
  3. Pitch affects forward velocity.
  4. Forward velocity becomes at least 0
  5. Forward velocity affects pitch (see below table)
  6. Pitch velocity affects pitch.
  7. Pitch is clamped to be inside [-0x2AAA, 0x2AAA]
  8. x,y,z velocity is more or less directly exactly trigonometrically correspondent to forward velocity, pitch, and yaw.
  9. xz sliding velocity updated to correspond
void update_flying(struct MarioState *m) {
    UNUSED u8 filler[4];

    update_flying_pitch(m);
    update_flying_yaw(m);

    m->forwardVel -= 2.0f * ((f32) m->faceAngle[0] / 0x4000) + 0.1f;
    m->forwardVel -= 0.5f * (1.0f - coss(m->angleVel[1]));

    if (m->forwardVel < 0.0f) {
        m->forwardVel = 0.0f;
    }

    if (m->forwardVel > 16.0f) {
        m->faceAngle[0] += (m->forwardVel - 32.0f) * 6.0f;
    } else if (m->forwardVel > 4.0f) {
        m->faceAngle[0] += (m->forwardVel - 32.0f) * 10.0f;
    } else {
        m->faceAngle[0] -= 0x400;
    }

    m->faceAngle[0] += m->angleVel[0];

    if (m->faceAngle[0] > 0x2AAA) {
        m->faceAngle[0] = 0x2AAA;
    }
    if (m->faceAngle[0] < -0x2AAA) {
        m->faceAngle[0] = -0x2AAA;
    }

    m->vel[0] = m->forwardVel * coss(m->faceAngle[0]) * sins(m->faceAngle[1]);
    m->vel[1] = m->forwardVel * sins(m->faceAngle[0]);
    m->vel[2] = m->forwardVel * coss(m->faceAngle[0]) * coss(m->faceAngle[1]);

    m->slideVelX = m->vel[0];
    m->slideVelZ = m->vel[2];
}

Key takeaways:

  • Pitch velocity additively affects forward velocity, but sin effects pitch. The most energy efficient flying is to fly a lot down, and then a little up, as, for example, sin(-0.5) + sin(0.25) + sin(0.25) ≈ 0.0153823799048 (positive), while the totally additive effect is still 0 (actually -0.3 because of a flat -0.1 per trame)
  • Pitching to move up happens faster with higher forward velocity.
    • The difference between 4 and 5 speed, and 16 and 17 speed is especially large.
  • At the same time, forward velocity is based on pitch. (But it is also based on:)
    • There is a base 0.1 forwardVel speed loss
    • There is anywhere from 0 to 0.5 further speed loss - more speed is lost the higher the yaw velocity is (ie the more Mario turns).
  • Pitch has a minimum and maximum and cannot overflow with standard speeds.
  • More below the tables
forwardVel's affect on pitch
<=4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 ... 31 32 33
-1024 -270 -260 -250 -240 -230 -220 -210 -200 -190 -180 -170 -160 -90 -84 -76 ... -6 0 6

Here are some tables summarizing the approach_s32, update_flying_pitch, and update_flying_yaw functions.

update_flying_pitch (target vel = -(stickX * (forwardVel / 5)))
joystick is down (move up) joystick is up (move down) joystick is neutral
negative pitch velocity add 64 vel, cap at 32 approach (at most 64 up or 32 down) approach 0 (by at most 64)
positive pitch velocity approach (at most 32 up or 64 down) subtract 64 vel, cap at -32 approach 0 (by at most 64)
zero pitch velocity approach (at most 32 up or 64 down) approach (at most 64 up or 32 down) approach 0 (by at most 64)
update_flying_yaw (target vel = -(stickY * (forwardVel / 4)))
joystick is left joystick is right joystick is neutral
negative yaw velocity add 64 vel, cap at 16 approach (at most 32 up or 16 down) approach 0 (by at most 64)
positive yaw velocity approach (at most 16 up or 32 down) subtract 64 vel, cap at -16 approach 0 (by at most 64)
zero yaw velocity approach (at most 16 up or 32 down) approach (at most 32 up or 16 down) approach 0 (by at most 64)

Key takeaways:

  1. Many joystick positions are equivalent.
  2. One cannot change velocity by more than 64 (ignoring the effects of speed)
  3. Holding joystick x=0 or y=0 will approach the corresponding 0 by at most 64.
    • In contrast, holding the opposite direction changes the angle by 32 (yaw) or 64 (pitch), unconditionally
    • In further contrast, holding less of the same direction changes the angle by 32 (yaw) or 64 (pitch)
    • In even furthest contrast, holding more of the same direction changes the angle by 16 (yaw) or 32 (pitch)
    • So it might be faster to say, modify pitch:as such: -56 to -4 to 60 instead of -56 to 8 to 40. Notice the slightly under zero instead of slightly over zero.

After that, update_flying_yaw does:

  1. Add yaw velocity to yaw
  2. Set roll to yaw times negative twenty (-20)

Note that turning left = positive yaw (up = positive pitch).[2]

/**
 * Return the value 'current' after it tries to approach target, going up at
 * most 'inc' and going down at most 'dec'.
 */
s32 approach_s32(s32 current, s32 target, s32 inc, s32 dec) {
    //! If target is close to the max or min s32, then it's possible to overflow
    // past it without stopping.

    if (current < target) {
        current += inc;
        if (current > target) {
            current = target;
        }
    } else {
        current -= dec;
        if (current < target) {
            current = target;
        }
    }
    return current;
}

void update_flying_yaw(struct MarioState *m) {
    s16 targetYawVel = -(s16)(m->controller->stickX * (m->forwardVel / 4.0f));

    if (targetYawVel > 0) {
        if (m->angleVel[1] < 0) {
            m->angleVel[1] += 0x40;
            if (m->angleVel[1] > 0x10) {
                m->angleVel[1] = 0x10;
            }
        } else {
            m->angleVel[1] = approach_s32(m->angleVel[1], targetYawVel, 0x10, 0x20);
        }
    } else if (targetYawVel < 0) {
        if (m->angleVel[1] > 0) {
            m->angleVel[1] -= 0x40;
            if (m->angleVel[1] < -0x10) {
                m->angleVel[1] = -0x10;
            }
        } else {
            m->angleVel[1] = approach_s32(m->angleVel[1], targetYawVel, 0x20, 0x10);
        }
    } else {
        m->angleVel[1] = approach_s32(m->angleVel[1], 0, 0x40, 0x40);
    }

    m->faceAngle[1] += m->angleVel[1];
    m->faceAngle[2] = 20 * -m->angleVel[1];
}

void update_flying_pitch(struct MarioState *m) {
    s16 targetPitchVel = -(s16)(m->controller->stickY * (m->forwardVel / 5.0f));

    if (targetPitchVel > 0) {
        if (m->angleVel[0] < 0) {
            m->angleVel[0] += 0x40;
            if (m->angleVel[0] > 0x20) {
                m->angleVel[0] = 0x20;
            }
        } else {
            m->angleVel[0] = approach_s32(m->angleVel[0], targetPitchVel, 0x20, 0x40);
        }
    } else if (targetPitchVel < 0) {
        if (m->angleVel[0] > 0) {
            m->angleVel[0] -= 0x40;
            if (m->angleVel[0] < -0x20) {
                m->angleVel[0] = -0x20;
            }
        } else {
            m->angleVel[0] = approach_s32(m->angleVel[0], targetPitchVel, 0x40, 0x20);
        }
    } else {
        m->angleVel[0] = approach_s32(m->angleVel[0], 0, 0x40, 0x40);
    }
}

References

  1. ↑ https://github.com/n64decomp/sm64/blob/66018e9f3caaa67399218971d61366cb3f7ba7d7/src/game/mario_actions_airborne.c#L1726
  2. ↑ https://youtu.be/TQt8MCsniQI
v • d • e
Actions
Stationary Actions
Moving Actions
Walking • Hold Walking • Turning Around • Finish Turning Around • Braking • Riding Shell Ground • Heavy Hold Walking • Crawling • Burning Ground • Decelerating • Hold Decelerating • Begin Sliding • Hold Begin Sliding • Butt Slide • Stomach Slide • Hold Butt Slide • Hold Stomach Slide • Dive Slide • Move Punching • Crouch Slide • Slide Kick Slide • Hard Backward Ground Kb • Hard Forward Ground Kb • Backward Ground Kb • Forward Ground Kb • Soft Backward Ground Kb • Soft Forward Ground Kb • Ground Bonk • Death Exit Land • Jump Land • Freefall Land • Double Jump Land • Side Flip Land • Hold Jump Land • Hold Freefall Land • Quicksand Jump Land • Hold Quicksand Jump Land • Triple Jump Land • Long Jump Land • Backflip Land
Airborne Actions
Underwater Actions
Cutscene Actions
Disappeared • Intro Cutscene • Star Dance Exit • Star Dance Water • Fall After Star Grab • Reading Automatic Dialog • Reading Npc Dialog • Star Dance No Exit • Reading Sign • Jumbo Star Cutscene • Waiting For Dialog • Debug Free Move • Standing Death • Quicksand Death • Electrocution • Suffocation • Death On Stomach • Death On Back • Eaten By Bubba • End Peach Cutscene • Credits Cutscene • End Waving Cutscene • Pulling Door • Pushing Door • Warp Door Spawn • Emerge From Pipe • Spawn Spin Airborne • Spawn Spin Landing • Exit Airborne • Exit Land Save Dialog • Death Exit • Unused Death Exit • Falling Death Exit • Special Exit Airborne • Special Death Exit • Falling Exit Airborne • Unlocking Key Door • Unlocking Star Door • Entering Star Door • Spawn No Spin Airborne • Spawn No Spin Landing • Bbh Enter Jump • Bbh Enter Spin • Teleport Fade Out • Teleport Fade In • Shocked • Squished • Head Stuck In Ground • Butt Stuck In Ground • Feet Stuck In Ground • Putting On Cap
Automatic Actions
Object Related Actions
Retrieved from "https://ukikipedia.net/mediawiki/index.php?title=Flying&oldid=19368"