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 @@
+PS2
+======
+SDL2 port for the Sony Playstation 2 contributed by:
+- Francisco Javier Trujillo Mata
+Credit to
+   - The guys that ported SDL to PSP & Vita because I'm taking them as reference.
+   - David G. F. for helping me with several issues and tests.
+## Building
+To build SDL2 library for the PS2, make sure you have the latest PS2Dev status and run:
+```bash
+cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=$PS2DEV/ps2sdk/ps2dev.cmake
+cmake --build build
+cmake --install build
+```
+## Hints
+The PS2 port has a special Hint for having a dynamic VSYNC. The Hint is `SDL_HINT_PS2_DYNAMIC_VSYNC`.
+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.
+## Notes
+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.
+So to avoid the reset of the IOP CPU, you need to call to the macro `SDL_PS2_SKIP_IOP_RESET();`.
+It could be something similar as:
+```c
+.....
+SDL_PS2_SKIP_IOP_RESET();
+int main(int argc, char *argv[])
+{
+.....
+```
+For a release binary is recommendable to reset the IOP always.
+Remember to do a clean compilation everytime you enable or disable the `SDL_PS2_SKIP_IOP_RESET` otherwise the change won't be reflected.
+## Getting PS2 Dev
+[Installing PS2 Dev](https://github.com/ps2dev/ps2dev)
+## Running on PCSX2 Emulator
+[PCSX2](https://github.com/PCSX2/pcsx2)
+[More PCSX2 information](https://pcsx2.net/)
+## To Do
+- PS2 Screen Keyboard
+- Dialogs
+- Others

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