The Legend of Zelda: The Wind Waker (the zeldaret decompilation, zeldaret/tww)

In the decompilation's C++ for the boat (d_a_ship, which doesn't yet match the game's bytes as a whole; the USA GZLE01 build), procSteerMove, while the boat isn't airborne (daSFLG_FLY_e off), takes the gap between the wind vector's yaw (cM_atan2s of its x and z) and the boat's facing shape_angle.y, as a 16-bit angle from 0 to 0x8000, and turns it into a wind factor: 1 − gap/0x10000 below 0x4000 (90°), 0.75 − (gap − 0x4000) × 5.493164e-05 up to 0x6000 (135°), then 0.3 − (gap − 0x6000) × 0.00032967035, floored at 0. So the factor is 1 with the wind along the boat's facing, 0.875 at 45°, 0.75 at 90°, 0.3 at 135°, and 0 from 140° to 180° (computed). The target speed is the wind power divided by 0.5, capped at 1, times the factor times 55. The branches then run in this order, one per update. First, on the body animation's frame 7, if speedF is below twice the target (at most 80) it is raised to that and mTargetSpeed is set to the target (10000 if the boat is being moved by force), and nothing else changes speedF that update. Otherwise, while mTargetSpeed is below speedF, firstDecrementShipSpeed lowers speedF toward mTargetSpeed (a tenth of the gap, at most 5, at least 1) and sets mTargetSpeed to 10000 once the gap is under 3; this comes before the sail check, so it applies with the sail flag off too. Otherwise, with the sail-on flag off or a target of 0, decrementShipSpeed eases speedF toward 10 × the stick's value × the cosine of its angle (a twentieth of the gap, at most 0.1, at least 0.015). Otherwise decrementShipSpeed eases it down to a lower target, and cLib_addCalc up to a higher one (a tenth of the gap, at most 0.5, at least 0.1). tww/sail-speed

About: The Legend of Zelda: The Wind Waker Sailing

{
 "factor": {
  "0": 1,
  "45": 0.875,
  "90": 0.75,
  "135": 0.3,
  "140": 0,
  "180": 0
 },
 "topSpeed": 55,
 "fullPowerAt": 0.5,
 "sailOffSpeed": 10,
 "kickCap": 80
}

The factor's three pieces meet: 0.75 at 0x4000 and 0.3 at 0x6000 (0.45 / 0x2000 = 5.4931640625e-05), and 0.3 / 0.00032967035 = 910 units past 0x6000, about 140.0 degrees. Below the minimum step, cLib_addCalc adds the minimum and stops at the target (c_lib.cpp lines 33-48). Which way the wind vector points (toward where the wind blows, or from it) is the atlas's reading from the factor: the boat is fastest when the vector lies along its facing. What animation plays at the frame-7 check, and the units of speedF, are unread; the d_a_ship object doesn't match the original as a whole, so a per-function match is unconfirmed.

Cited by: Sailing, The Legend of Zelda: The Wind Waker

In the USA build, dKyw_wind_set, when no actor has set a wind vector override (mpWindVecOverride), takes the wind's strength from the room's file list (dStage_FileList_dt_GlobalWindLevel): level 0 gives 0.3, level 1 gives 0.6, level 2 gives 0.9, any other level 0. A custom wind power above 0 replaces it, an event wind setting of 2 makes it 0, and it is capped at 1. While mInitAnimTimer is nonzero the wind vector and power jump to the new values; otherwise each call moves each vector component a tenth of the way (at most 2, at least 0.001) and the power a tenth of the way (at most 1, at least 0.005). Since the boat, in the decompilers' not-yet-matching C++ for d_a_ship (procSteerMove), divides the power by 0.5 and caps it at 1, a level-0 room tops out at 0.6 of the boat's 55, 33 units an update, and levels 1 and 2 at the full 55 (computed, once the power has settled). tww/wind-strength

About: The Legend of Zelda: The Wind Waker Wind

{
 "levels": {
  "0": 0.3,
  "1": 0.6,
  "2": 0.9
 },
 "other": 0,
 "cap": 1,
 "boatTop": {
  "0": 33,
  "1": 55,
  "2": 55
 }
}

Each room's wind level is stage data the repo doesn't hold, so which seas blow at which level is unread. dKyw_gbwind_use_check treats a level of 2 or less as using the global wind.

Cited by: The Legend of Zelda: The Wind Waker, Wind

In the USA build, the wind-direction picker dOperate_wind_c (which the atlas reads as the Wind's Requiem's, from its TAKT_WIND sounds; "takt" is the baton) sets mDeg on opening from the current wind vector's yaw and then, with the stick pushed to at least 0.9, sets mDeg to one of eight compass values, 0 to 315 in 45-degree steps. A confirms it: windSet passes dKyw_tact_wind_set a pitch of 0 and a yaw of 180° − mDeg (0 gives −0x8000, 90 gives 0x4000, 270 gives −0x4000). dKyw_tact_wind_set stores both angles for the environment and in the save (dComIfGs_setWindX, setWindY) and sets the tact-wind flag; dKyw_wind_set then builds the wind vector as (cos pitch × cos yaw, sin pitch, cos pitch × sin yaw). dKyw_wind_init reloads the saved angles unless both are −1. B cancels the picker. tww/wind-requiem

About: The Legend of Zelda: The Wind Waker Wind

{
 "directions": 8,
 "step": 45,
 "yawFromDeg": "180 - mDeg",
 "persists": "save"
}

An event wind (mEvtWindSet nonzero and not 0xFF) takes precedence over the tact wind in dKyw_wind_set (line 1007). Which stick direction gives which mDeg depends on dOw_stickControl, not cited. dKyw_get_windsdir (lines 1360-1391) sorts the current wind vector into eight 0x2000-wide sectors. How the baton song opens the picker is in the player code, not fetched.

Cited by: The Legend of Zelda: The Wind Waker, Wind

In the decompilation's C++ for the boat (d_a_ship, not yet matching as a whole; the USA build), procSteerMove moves the unnamed angle m0366, which the atlas reads as the tiller, toward mStickMVal × 0x2000 × −sin(mStickMAng) with cLib_addCalcAngleS(…, 4, l_HIO.tiller_speed, 0x100), tiller_speed being 700, and, unless the boat is airborne, passes it to setMoveAngle. Unless the boat is being moved by force (checkForceMove), setMoveAngle sets a rate of 4 − |speedF| / 55 × 3, held between 0.1 and 3.6, blends it toward 3.6 by the unnamed counter m0388 over 15 (3.6 once m0388 reaches 15), and turns the facing by −rate × (m0366 >> 6). With m0388 at 0 and a tiller of 0x2000, that is about 461 units (2.5°) an update at rest and 128 units (0.7°) at speed 55 (computed): the boat turns slower the faster it sails. tww/turn-rate

About: The Legend of Zelda: The Wind Waker Sailing

{
 "rateAtRest": 3.6,
 "rateAt55": 1,
 "rateMin": 0.1,
 "maxTiller": 8192,
 "tillerSpeed": 700,
 "turnAtRest": 461,
 "turnAt55": 128
}

The range of mStickMVal (taken here as 0 to 1, so the tiller target is at most 0x2000) and the semantics of cLib_addCalcAngleS's arguments are unread, as is what m0388 counts.

Cited by: Sailing, The Legend of Zelda: The Wind Waker

In the decompilation's C++ for the boat (d_a_ship, not yet matching as a whole; the USA build), procSteerMove allows a hop when no event runs, Link isn't barred from control (checkNoControll), the body animation is FN_MAST_ON2 at frame 7 or later, the boat isn't airborne, its forward speed mFwdVel is over 16.5, it isn't being moved by force, and the sailing target speed is at least 11. Then the R trigger's lock (mDoCPd_R_LOCK_TRIGGER) sets the airborne and jump flags and an upward speed equal to the target speed, held between 15 and 40, and sets mJumpRate to (speed.y − 11) × 0.014545455. tww/hop

About: The Legend of Zelda: The Wind Waker Sailing

{
 "minForward": 16.5,
 "minTarget": 11,
 "upMin": 15,
 "upMax": 40
}

The hop sits inside the not-airborne branch whose target speed sail-speed describes, so a hop needs enough wind at a narrow enough angle. FN_MAST_ON2 reads as the mast-raised animation by its name; what mJumpRate drives is unread.

Cited by: The Legend of Zelda: The Wind Waker

In the USA build, the time of day is a float from 0 to 360, 15 to an hour (dKy_getdaytime_hour divides by 15); dKy_daynight_check calls 6:00 to 17:59 day. The environment's setup sets the advance mTimeAdv to 0.02, which dKy_custom_timeset can change. Each setDaytime call adds it only when no event-night stop is set, the save's get-item flag (2, 0) is set, no event runs, and (USA and PAL only) Link isn't on stage "sea" room 14 with stage layer 2 or 3. In rooms that pass time (getTimePass) the clock wraps from 360 to 0 and the day of the week goes up by one; in other rooms it advances only by day before 165 (11:00) and by night from 270 (18:00) to 345 (23:00). At 0.02 a day is 18,000 setDaytime calls (computed). tww/clock

About: The Legend of Zelda: The Wind Waker Time of day

{
 "unitsPerDay": 360,
 "unitsPerHour": 15,
 "perUpdate": 0.02,
 "updatesPerDay": 18000,
 "dayFrom": "6:00",
 "dayUntil": "18:00"
}

How often setDaytime runs, and so a day's real length, is unread; at one call a frame and 30 frames a second, 18,000 calls would be 10 minutes, but neither rate is in the cited code. The stage's TimeH can set the hour on load (lines 472-475). What get-item flag (2, 0) stands for is unread.

Cited by: The Legend of Zelda: The Wind Waker, Time of day