diff options
author | 3gg <3gg@shellblade.net> | 2024-05-04 16:51:29 -0700 |
---|---|---|
committer | 3gg <3gg@shellblade.net> | 2024-05-04 16:51:29 -0700 |
commit | 8222bfe56d4dabe8d92fc4b25ea1b0163b16f3e1 (patch) | |
tree | 763389e42276035ac134d94eb1dc32293b88d807 /src/contrib/SDL-2.30.2/docs/README-ps2.md |
Initial commit.
Diffstat (limited to 'src/contrib/SDL-2.30.2/docs/README-ps2.md')
-rw-r--r-- | src/contrib/SDL-2.30.2/docs/README-ps2.md | 51 |
1 files changed, 51 insertions, 0 deletions
diff --git a/src/contrib/SDL-2.30.2/docs/README-ps2.md b/src/contrib/SDL-2.30.2/docs/README-ps2.md new file mode 100644 index 0000000..f422da9 --- /dev/null +++ b/src/contrib/SDL-2.30.2/docs/README-ps2.md | |||
@@ -0,0 +1,51 @@ | |||
1 | PS2 | ||
2 | ====== | ||
3 | SDL2 port for the Sony Playstation 2 contributed by: | ||
4 | - Francisco Javier Trujillo Mata | ||
5 | |||
6 | |||
7 | Credit to | ||
8 | - The guys that ported SDL to PSP & Vita because I'm taking them as reference. | ||
9 | - David G. F. for helping me with several issues and tests. | ||
10 | |||
11 | ## Building | ||
12 | To build SDL2 library for the PS2, make sure you have the latest PS2Dev status and run: | ||
13 | ```bash | ||
14 | cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=$PS2DEV/ps2sdk/ps2dev.cmake | ||
15 | cmake --build build | ||
16 | cmake --install build | ||
17 | ``` | ||
18 | |||
19 | ## Hints | ||
20 | The PS2 port has a special Hint for having a dynamic VSYNC. The Hint is `SDL_HINT_PS2_DYNAMIC_VSYNC`. | ||
21 | If you enabled the dynamic vsync having as well `SDL_RENDERER_PRESENTVSYNC` enabled, then if the app is not able to run at 60 FPS, automatically the `vsync` will be disabled having a better performance, instead of droping FPS to 30. | ||
22 | |||
23 | ## Notes | ||
24 | If you trying to debug a SDL app through [ps2client](https://github.com/ps2dev/ps2client) you need to avoid the IOP reset, otherwise you will lose the conection with your computer. | ||
25 | So to avoid the reset of the IOP CPU, you need to call to the macro `SDL_PS2_SKIP_IOP_RESET();`. | ||
26 | It could be something similar as: | ||
27 | ```c | ||
28 | ..... | ||
29 | |||
30 | SDL_PS2_SKIP_IOP_RESET(); | ||
31 | |||
32 | int main(int argc, char *argv[]) | ||
33 | { | ||
34 | ..... | ||
35 | ``` | ||
36 | For a release binary is recommendable to reset the IOP always. | ||
37 | |||
38 | Remember to do a clean compilation everytime you enable or disable the `SDL_PS2_SKIP_IOP_RESET` otherwise the change won't be reflected. | ||
39 | |||
40 | ## Getting PS2 Dev | ||
41 | [Installing PS2 Dev](https://github.com/ps2dev/ps2dev) | ||
42 | |||
43 | ## Running on PCSX2 Emulator | ||
44 | [PCSX2](https://github.com/PCSX2/pcsx2) | ||
45 | |||
46 | [More PCSX2 information](https://pcsx2.net/) | ||
47 | |||
48 | ## To Do | ||
49 | - PS2 Screen Keyboard | ||
50 | - Dialogs | ||
51 | - Others | ||