mirror of
https://github.com/tangerineturtle1/NX2navi.git
synced 2026-11-15 23:39:57 -04:00
With it on, the game draws from a camera of the menu's instead of its own, in play and in cutscenes. The left stick moves it along its view and sideways, the right stick turns it, ZR and ZL raise and lower it, R makes it faster and L slower, and Link stands meanwhile; or the camera stays where it is and the pad plays the game. It works inside the game's own camera update: a new patch site sends the instruction at which the frame's position, target and up vector are final to a host function, which replaces them for the camera that follows Link and the one the events direct, so the game draws, culls and loads detail for what the free camera sees. The camera of the interface's 3D models and the one the sound follows stay the game's. The set is off unless the menu switches it on. A teleport's arrival starts the free camera again from the game's view. Tested in Hyrule Field with scripted stick input (turn, rise, strafe, with Link's position unchanged), with the pad playing while the camera stays, across a teleport to Kakariko Village, during the Kakariko arrival cutscene, and switched on by a click in the menu. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
68 lines
3.5 KiB
C
68 lines
3.5 KiB
C
// The debug menu's access to the game (debug_tools.c). Everything but dbg_tick is for the menu's thread.
|
|
#pragma once
|
|
#include <stdint.h>
|
|
|
|
#ifndef __cplusplus
|
|
#include "cpu.h"
|
|
void dbg_tick(Cpu *c); // the game's thread, at its pad read (ov_input.c): does what the menu asked for
|
|
// ... and the pad's state before the game gets it: the free camera takes the sticks and four buttons while it flies
|
|
void dbg_pad(uint64_t *buttons, int32_t *lx, int32_t *ly, int32_t *rx, int32_t *ry);
|
|
void dbg_freecam_host(Cpu *c); // the free camera's patch site (recomp/patches-v111.txt, set freecam)
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
int dbg_supported(void); // this game build's structures are known (Ocarina of Time 1.1.1)
|
|
|
|
int dbg_player_pos(float xyz[3]); // Link's position in metres; 0 while there is no player
|
|
float dbg_speed_factor(void); // the game's speed: 1 normal, 0.05 to 8 (frame_rate.c multiplies the game's step)
|
|
void dbg_speed_set(float factor);
|
|
|
|
// The game's on/off flags, sorted by hash. dbg_flags_refresh reads their values and returns their number (0 until a
|
|
// save is loaded). A change is made by the game's own function at the next frame.
|
|
int dbg_flags_refresh(void);
|
|
uint32_t dbg_flag_hash(int i);
|
|
int dbg_flag_value(int i);
|
|
const char *dbg_flag_name(int i); // NULL: no name found for it
|
|
void dbg_flag_set(uint32_t hash, int on);
|
|
int dbg_names(int *found); // 0 not started, 1 being read from the game's files, 2 read (*found of them)
|
|
|
|
// Teleporting and events. The places are the game's areas with their named start positions, and the events its event
|
|
// files that hold a script: both lists come from the player's game files with the flag names (0 until dbg_names
|
|
// answers 2). dbg_warp changes area as the game's own doors do; dbg_event_start starts an event by its name. One at a
|
|
// time: nothing is taken while dbg_busy. dbg_status is the last thing that happened, in words.
|
|
int dbg_places(void);
|
|
const char *dbg_place_area(int i);
|
|
const char *dbg_place_pos(int i); // "": the area's default start
|
|
void dbg_warp(const char *area, const char *pos);
|
|
int dbg_events(void);
|
|
const char *dbg_event_name(int i);
|
|
void dbg_event_start(const char *name);
|
|
int dbg_busy(void);
|
|
void dbg_status(char out[160]);
|
|
|
|
// The free camera: the game draws from a camera of the menu's instead of its own. With sticks on, the pad flies it and
|
|
// Link stands; with sticks off it stays where it is and the pad plays the game. speed in metres a second.
|
|
int dbg_freecam_available(void); // the build has the camera's patch set
|
|
void dbg_freecam_set(int on, int sticks, float speed);
|
|
void dbg_freecam_reset(void); // back to the game's view, free again from there
|
|
int dbg_freecam(int *sticks, float *speed, double pos[3]); // on or off
|
|
|
|
// Memory: values of 1, 2 or 4 bytes in the game's heap.
|
|
int dbg_search_new(uint32_t value, int size); // returns the number of places
|
|
int dbg_search_next(int mode, uint32_t value); // 0 equals value, 1 changed, 2 unchanged, 3 greater, 4 less
|
|
int dbg_search_count(int *over); // *over: the first search found more than are kept
|
|
uint64_t dbg_search_addr(int i);
|
|
int dbg_search_size(void);
|
|
void dbg_search_clear(void);
|
|
int dbg_mem_read(uint64_t addr, int size, uint32_t *v);
|
|
void dbg_mem_write(uint64_t addr, uint64_t value, int size);
|
|
int dbg_freeze(uint64_t addr, uint64_t value, int size, int on); // written every frame while on; 0: the list is full
|
|
int dbg_frozen(uint64_t addr);
|
|
int dbg_frozen_count(void);
|
|
void dbg_unfreeze_all(void);
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|