Sly 1:Executable: Difference between revisions

← Older edit

Sly 1:Executable (view source)

Revision as of 20:30, 25 September 2023

958 bytes added , 7 months ago

Added infobox

VisualWikitext

TheOnlyZac

Bureaucrats, Administrators

2,203

edits

Revision as of 16:37, 2 August 2022 (view source) TheOnlyZac (talk \| contribs) (→‎Initialization: Replaced Todo tag with Investigate) Tag: Visual edit ← Older edit		Latest revision as of 20:30, 25 September 2023 (view source) TheOnlyZac (talk \| contribs) (Added infobox) Tag: Visual edit: Switched
(7 intermediate revisions by 2 users not shown)
Line 1: {{Infobox file ~~{{DISPLAYTITLE:SCUS_971.98}}~~ \|name=SCUS_971.98 '''SCUS_971.98''' is the [[executable]] for {{Sly 1}}. It is an ELF binary compiled for the PS2’s [[Wikipedia:Emotion Engine\|Emotion Engine]] processor. The compiler is GCC v2.9-ee-991111b.<ref>Based on strings found in the May 2002 demo build</ref>▼ \|type=MIPS r5900 ELF }} ▲'''SCUS_971.98''' is the [[executable]] for {{Sly 1}}. It is an ELF binary compiled for the PS2’s [[Wikipedia:Emotion Engine\|Emotion Engine]] processor. The compiler is ~~GCC~~<tt>ee-gcc v2.9-ee-991111b</tt>.<ref>Based on strings found in the May 2002 demo build</ref> == Libraries == {{Hatnote\|This section contains educated guesses based on available information and context clues, and may be inaccurate or incomplete.}} === ~~Shared~~IOP ~~libraries~~modules === These ~~libary files~~modules are included on the disc alongside the game executable, and are loaded on the IOP core. * '''sio2man.irx''' – Manager Interface for joypads, multitaps and memory cards<ref name=":0">[https://www.retroreversing.com/irx-ps2 IRX Files for Playstation 2] - Retro Reversing, 29 March 2021</ref> Line 16 ⟶ 20: === Static libraries === These libraries are bundled with the executable and some are only referenced by name in some strings. ==== Standard libraries ==== * '''libkernl''' – PlayStation kernel library These libraries are shipped either by the Cygnus ee-gcc toolchain or provided as a part of gcc directly. * '''libgcc''' – GCC internal runtime library * '''libgcc2''' - GCC internal runtime library (provides C++ ABI routines and other misc. runtime functions) * '''newlib''' – Embedded C standard library implementation * '''libio –''' GNU implementation of C++ IO streams * '''libstdc++ –''' GNU C++ standard library ==== PS2 SDK libraries ==== These libraries are part of the PS2 SDK and written by SCEI. * '''libkernel''' – Interface to the EE Kernel (syscall wrappers/etc.) * '''libmc 2430''' – Memory card library * '''libgraph 2400''' – [[Wikipedia:PlayStation 2 technical specifications#Graphics%20processing%20unit\|Graphics ~~synthesizer~~Synthesizer]] library<ref name=":1">[https://www.retroreversing.com/static-libraries-ps2 Static Libraries (.A) for Playstation 2 Emotion Engine] - Retro Reversing, 9 July 2022</ref> * '''libdma 2400''' – ~~''Unknown''~~Direct Memory Access (DMA) library * '''libcdvd 2420''' – CD/DVD library * '''libpad 2410''' – DualShock gamepad library * '''libipu 2400''' – Image data Processor (IPU) library<ref name=":1" /> == Initialization and main loop == === _start === The entry point for the executable is <code>_start</code>. It sets up the main thread, initializes the main thread's heap, and calls <code>main</code>. The <code>main</code> function takes two arguments, <code>int cphzArgs</code> (the number of arguments) and <code>char apchzArgs</code> (the array of arguments). It performs some initialization and begins the main game loop. The entry point for the executable is <code>_start</code>, which is provided by the PS2 SDK's <code>crt0.s</code>. It sets up the main thread, initializes the main thread's heap, and calls <code>main</code>. === main === The <code>main</code> function takes two parameters, <code>int cphzArgs</code> (the number of arguments) and <code>char apchzArgs</code> (an array of arguments), which it stores as the the global variables <code>g_cphzArgs</code> and <code>g_apchzArgs</code> respectively. It calls <code>__main</code> and <code>Startup</code> to initialize the game engine, then begins the main loop. ==== __main ==== <code>main</code> is a libgcc function that iterates through a generated table of initialization functions which initialize global variables and construct global objects, calling them all. ==== ~~Initialization~~Startup ==== <code>Startup</code> begins by calling <code>SetPhase</code>, setting <code>g_phase</code> to <code>PHASE::Startup</code>. It then iterates over an array of function pointers, called <code>StartupSampler</code>, and calls each one. The startup sampler includes the startup functions for many game subsystems, such as DMA, Thread, Codes, Screen, and Clock, and more. <code>main</code> starts by calling <code>__main</code>, a function that iterates over a function table and calls each function to initialize several game variables. Execution then returns to <code>main</code> which stores the passed parameters in <code>g_cphzArgs</code> and <code>g_apchzArgs</code> respectively. It then calls <code>Startup</code>, a function which initializes even more game variables. ~~{{Investigate\|Investigate and expand on what <code>__main</code> and <code>Startup</code> do}}~~ === Game loop === Line 37 ⟶ 59: * First, check if <code>g_mpeg</code> has an [[MPEG]] queued to be played. If so: <code>FlushFrames(1)</code> – ~~Calls~~Call some graphics functions and swap the graphics synthesizer buffers <code>~~CTransition~~g_transition::Execute(~~&g_transition~~)</code> – ~~Executes~~Execute the MPEG on the global [[Sly 1:Transition\|~~transition~~CTransition]] instance * Check if <code>g_transition</code> has a pending transition (i.e. <code>m_fPending != 0</code>). If so: <code>FlushFrames(1)</code> Call a function that calls <code>CMpeg::Execute</code> on the <code>g_transition</code> instance. * Check '''again''' if <code>g_mpeg</code> has an MPEG queued to be played (this happens if two MPEGs were queued to play back-to-back). If so: <code>FlushFrames(1)</code> <code>~~CTransition~~g_transition::Execute(~~&g_transition~~)</code> * <code>UpdateJoy(&g_joy)</code> – Handles [[Sly 1:Input\|controller input]] * <code>UpdateCodes()</code> – ~~Watches~~Watche for [[Sly 1:Cheat codes\|cheat code]] inputs * Call an unknown function that handles saving the game. * <code>UpdateUi(&g_ui)</code> – ~~Updates~~Update the state of the [[Sly 1:Screen\|GUI]] * <code>UpdateGameState(g_clock.dt)</code> – ~~Updates~~Update the running timers on the [[Sly 1:GS\|game state]] structs * <code>if (g_psw != NULLPTR)</code> – If g_psw is ~~not~~has ~~null~~been initialized.. <code>SetupCm(g_pcm)</code> – ~~Sets~~Set up some [[Sly 1:Camera\|camera]] values to render the next frame <code>OpenFrame()</code> – ~~Prepares~~Prepare to render the next frame <code>MarkClockTick(&g_clock)</code> – ~~Updates~~Update the global [[Sly 1:Clock\|clock]] values Grab a particular function pointer from the <code>g_psw</code> struct and execute it if it is not NULL. The function's purpose is unknown but it takes <code>g_clock.dt</code> as an argument, so it's probably an Update function. <code>RenderSw(g_psw, g_pcm)</code> – ~~Renders~~Render [[Sly 1:SW\|game objects]] from the given camera perspective <code>RenderUi()</code> – ~~Renders~~Render the ~~GUI~~UI [[Sly 1:BLOT\|blots]] on the current frame <code>DrawSw(g_psw, g_pcm)</code> – ~~Draws~~Draw the game objects from the given camera perspective <code>DrawUi()</code> – ~~Draws~~Draw the ~~GUI~~UI elements on the frame ** <code>CloseFrame()</code> – ~~Finishes~~Finish rendering the frame * Increment the global frame counter, <code>g_cframe</code>.