 |
JaffarPlus
High-performance best-first search optimizer for tool-assisted speedruns
|
|
JaffarPlus
High-performance best-first search optimizer for tool-assisted speedruns
|
The jaffar-player (jaffar-tester) executable: loads a config and a solution sequence and plays it back through a jaffarPlus::Runner. More...
#include "emulator.hpp"#include "game.hpp"#include "playback.hpp"#include "runner.hpp"#include <argparse/argparse.hpp>#include <chrono>#include <emulatorList.hpp>#include <gameList.hpp>#include <jaffarCommon/json.hpp>#include <jaffarCommon/logger.hpp>#include <jaffarCommon/string.hpp>#include <set>Go to the source code of this file.
Functions | |
| static size_t | parseUInt (const std::string &value, const std::string &flag) |
| Parses a non-negative integer from a CLI argument value. | |
| bool | mainCycle (jaffarPlus::Runner &r, const std::string &solutionFile, bool disableRender) |
| Runs one full pass over a solution sequence, optionally interactive, and reports state info. | |
| int | main (int argc, char *argv[]) |
| Entry point for the jaffar-player (jaffar-tester) executable. | |
Variables | |
| bool | isUnattended |
| Prevents the interactive player from stalling for a keystroke. | |
| bool | isExitOnEnd |
| Determines that the reproduction must end on reaching the last step. | |
| bool | isReload |
| Switch to toggle whether to reload the movie on reaching the end of the sequence. | |
| bool | isReproduce |
| Switch to toggle whether to reproduce (auto-advance) the movie. | |
| size_t | frameskip |
| Number of frames to skip between renderings. | |
| std::string | runCommand |
| Command to run initially and then exit. | |
| bool | printFinalState |
| When set, prints a stable, machine-readable summary of the final state on exit (for headless verification of a reproduction: determinism checks and golden-hash comparisons). | |
| std::string | dumpHashesPath |
| When non-empty, writes the per-step game-state hash for every step to this file (one "step\thashHi\thashLo" line per step). | |
| std::string | dumpRamPath |
| When non-empty, writes the full low work-RAM ("LRAM") segment for every step to this file as a flat binary blob (size-of-LRAM bytes per step). | |
| std::string | dumpRewardPath |
| When non-empty (–dumpReward), writes the per-step game reward (one value per line) for the replayed solution to this file. | |
| std::string | dumpTracePath |
| When non-empty (–dumpTrace), writes the game's per-step trace line (Game::getTraceLine, one line per step) for the replayed solution to this file. | |
| std::string | saveStateStepStr |
| When set (–saveStateStep), the step at which to capture a full emulator savestate (paired with –saveStateFile). | |
| std::string | saveStateFilePath |
| When non-empty (–saveStateFile), the path to write the emulator savestate captured at –saveStateStep (e.g. | |
| std::string | screenshotDir |
| Directory to write per-frame screenshots (BMP) into; empty disables screenshotting. | |
| std::set< size_t > | screenshotSteps |
| Steps to capture as screenshots; empty captures all rendered steps when a dir is given. | |
The jaffar-player (jaffar-tester) executable: loads a config and a solution sequence and plays it back through a jaffarPlus::Runner.
Supports interactive stepping/playback in a terminal, headless/unattended replay, per-frame BMP screenshot capture, single-command runs (--runCommand), and a machine-readable final-state summary (--printFinalState) used as an oracle for headless reproduction tests (determinism / golden-hash comparisons). Behavior is driven by the command-line flags parsed in main and the file-scope switches below.
Definition in file player.cpp.
| int main | ( | int | argc, |
| char * | argv[] | ||
| ) |
Entry point for the jaffar-player (jaffar-tester) executable.
Parses the command-line arguments (required configFile and solutionFile, plus the --reproduce, --reload, --exitOnEnd, --unattended, --disableRender, --frameskip, --initialSequence, --runCommand, --screenshotDir, --screenshotSteps and --printFinalState flags), seeding the file-scope playback switches from them. Loads and parses the JSON config, optionally overrides the emulator's "Initial Sequence File Path", forces the runner's frameskip rate to 0, then builds and initializes a jaffarPlus::Runner. If rendering is enabled it initializes video output and rendering. Serializes the runner's initial state, then repeatedly invokes mainCycle; when a cycle requests another pass it sleeps briefly and restores the saved initial state. Finalizes video output and the terminal on exit.
| argc | Argument count. |
| argv | Argument vector. |
Definition at line 503 of file player.cpp.
| bool mainCycle | ( | jaffarPlus::Runner & | r, |
| const std::string & | solutionFile, | ||
| bool | disableRender | ||
| ) |
Runs one full pass over a solution sequence, optionally interactive, and reports state info.
Loads the solution sequence file, builds a jaffarPlus::Playback over the runner, and enters a loop that (unless rendering is disabled) renders the current frame, optionally saves a BMP screenshot for the current step, prints per-step information (step index, input, hashes, allowed inputs, game/emulator names, checkpoint and save-solution status, plus game-specific info), and handles navigation/playback commands. Commands move the current step (n/m +/-1, h/j +/-10, y/u +/-100, k/i +/-1000), quicksave the emulator state to "quicksave.state" (s), toggle playback (p), toggle auto-reload (r), quit (q), or are forwarded to the game's player command parser. In unattended or reproduce mode, key input is non-blocking; runCommand forces a single command then finalizes. On reaching the end it reloads, exits, or stops depending on the reload/exit-on-end flags. When printFinalState is set, prints a stable end-of-sequence summary (final step, state type, first win/fail steps, final state hash, not-allowed-input count, repeated-state count).
| r | The runner to play the solution back on. |
| solutionFile | Path to the solution sequence file to load and reproduce. |
| disableRender | Whether to skip frame rendering (and screenshot capture). |
Definition at line 116 of file player.cpp.
|
static |
Parses a non-negative integer from a CLI argument value.
Reports a clear logic error (instead of a raw std::stoul exception) when the value is malformed or contains trailing characters.
| value | The string value to parse. |
| flag | The name of the CLI flag the value came from, used in the error message. |
Definition at line 81 of file player.cpp.
| std::string dumpHashesPath |
When non-empty, writes the per-step game-state hash for every step to this file (one "step\thashHi\thashLo" line per step).
Used to cross-validate two emulators replaying the same solution: diffing the two dumps pinpoints the exact first frame at which they diverge.
Definition at line 45 of file player.cpp.
| std::string dumpRamPath |
When non-empty, writes the full low work-RAM ("LRAM") segment for every step to this file as a flat binary blob (size-of-LRAM bytes per step).
Diffing two emulators' RAM dumps byte-by-byte identifies the exact RAM addresses (hence game variables) that diverge.
Definition at line 50 of file player.cpp.
| std::string dumpRewardPath |
When non-empty (–dumpReward), writes the per-step game reward (one value per line) for the replayed solution to this file.
Suitable as a driver "Reference Reward Floor" trace.
Definition at line 54 of file player.cpp.
| std::string dumpTracePath |
When non-empty (–dumpTrace), writes the game's per-step trace line (Game::getTraceLine, one line per step) for the replayed solution to this file.
Suitable as a game "Trace File Path" (trace-magnet ref).
Definition at line 58 of file player.cpp.
| size_t frameskip |
Number of frames to skip between renderings.
Definition at line 34 of file player.cpp.
| bool isExitOnEnd |
Determines that the reproduction must end on reaching the last step.
Definition at line 28 of file player.cpp.
| bool isReload |
Switch to toggle whether to reload the movie on reaching the end of the sequence.
Definition at line 30 of file player.cpp.
| bool isReproduce |
Switch to toggle whether to reproduce (auto-advance) the movie.
Definition at line 32 of file player.cpp.
| bool isUnattended |
Prevents the interactive player from stalling for a keystroke.
Definition at line 26 of file player.cpp.
| bool printFinalState |
When set, prints a stable, machine-readable summary of the final state on exit (for headless verification of a reproduction: determinism checks and golden-hash comparisons).
Definition at line 40 of file player.cpp.
| std::string runCommand |
Command to run initially and then exit.
Definition at line 36 of file player.cpp.
| std::string saveStateFilePath |
When non-empty (–saveStateFile), the path to write the emulator savestate captured at –saveStateStep (e.g.
to seed another search cleanly from a chosen frame).
Definition at line 66 of file player.cpp.
| std::string saveStateStepStr |
When set (–saveStateStep), the step at which to capture a full emulator savestate (paired with –saveStateFile).
Parsed as an unsigned step index; empty unless saving is requested.
Definition at line 62 of file player.cpp.
| std::string screenshotDir |
Directory to write per-frame screenshots (BMP) into; empty disables screenshotting.
Definition at line 69 of file player.cpp.
| std::set<size_t> screenshotSteps |
Steps to capture as screenshots; empty captures all rendered steps when a dir is given.
Definition at line 71 of file player.cpp.
1.9.8