SDL/docs/README-psp.md

PSP
======
SDL port for the Sony PSP contributed by:
- Captian Lex
- Francisco Javier Trujillo Mata
- Wouter Wijsman


Credit to
   Marcus R.Brown,Jim Paris,Matthew H for the original SDL 1.2 for PSP
   Geecko for his PSP GU lib "Glib2d"

## Building
To build SDL library for the PSP, make sure you have the latest PSPDev status and run:
```bash
cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=$PSPDEV/psp/share/pspdev.cmake
cmake --build build
cmake --install build
```


## Getting PSP Dev
[Installing PSP Dev](https://github.com/pspdev/pspdev)

## Running on PPSSPP Emulator
[PPSSPP](https://github.com/hrydgard/ppsspp)

[Build Instructions](https://github.com/hrydgard/ppsspp/wiki/Build-instructions)


## Compiling a HelloWorld
[PSP Hello World](https://psp-dev.org/doku.php?id=tutorial:hello_world)

## To Do
- PSP Screen Keyboard
- Dialogs
Converted README documentation to DOS text format 2016-10-07 18:46:58 -06:00			`PSP`
			`======`
First pass at changing SDL 2.0 to SDL 3.0 2022-11-21 21:28:58 -07:00			`SDL port for the Sony PSP contributed by:`
Sync SDL3 wiki -> header 2023-02-28 10:30:22 -07:00			`- Captian Lex`
Updating Readme-psp info 2022-02-02 00:16:45 -07:00			`- Francisco Javier Trujillo Mata`
			`- Wouter Wijsman`

Fixed crash if initialization of EGL failed but was tried again later. The internal function SDL_EGL_LoadLibrary() did not delete and remove a mostly uninitialized data structure if loading the library first failed. A later try to use EGL then skipped initialization and assumed it was previously successful because the data structure now already existed. This led to at least one crash in the internal function SDL_EGL_ChooseConfig() because a NULL pointer was dereferenced to make a call to eglBindAPI(). 2015-06-21 09:33:46 -06:00
			`Credit to`
			`Marcus R.Brown,Jim Paris,Matthew H for the original SDL 1.2 for PSP`
			`Geecko for his PSP GU lib "Glib2d"`

Updating Readme-psp info 2022-02-02 00:16:45 -07:00			`## Building`
First pass at changing SDL 2.0 to SDL 3.0 2022-11-21 21:28:58 -07:00			`To build SDL library for the PSP, make sure you have the latest PSPDev status and run:`
Updating Readme-psp info 2022-02-02 00:16:45 -07:00			```bash
			`cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=$PSPDEV/psp/share/pspdev.cmake`
			`cmake --build build`
			`cmake --install build`
			```


			`## Getting PSP Dev`
			`[Installing PSP Dev](https://github.com/pspdev/pspdev)`
Fixed crash if initialization of EGL failed but was tried again later. The internal function SDL_EGL_LoadLibrary() did not delete and remove a mostly uninitialized data structure if loading the library first failed. A later try to use EGL then skipped initialization and assumed it was previously successful because the data structure now already existed. This led to at least one crash in the internal function SDL_EGL_ChooseConfig() because a NULL pointer was dereferenced to make a call to eglBindAPI(). 2015-06-21 09:33:46 -06:00
Updating Readme-psp info 2022-02-02 00:16:45 -07:00			`## Running on PPSSPP Emulator`
			`[PPSSPP](https://github.com/hrydgard/ppsspp)`
Fixed crash if initialization of EGL failed but was tried again later. The internal function SDL_EGL_LoadLibrary() did not delete and remove a mostly uninitialized data structure if loading the library first failed. A later try to use EGL then skipped initialization and assumed it was previously successful because the data structure now already existed. This led to at least one crash in the internal function SDL_EGL_ChooseConfig() because a NULL pointer was dereferenced to make a call to eglBindAPI(). 2015-06-21 09:33:46 -06:00
Updating Readme-psp info 2022-02-02 00:16:45 -07:00			`[Build Instructions](https://github.com/hrydgard/ppsspp/wiki/Build-instructions)`
PSP: links for setting up, compiling and running on PSP 2021-10-04 14:12:08 -06:00

Updating Readme-psp info 2022-02-02 00:16:45 -07:00			`## Compiling a HelloWorld`
			`[PSP Hello World](https://psp-dev.org/doku.php?id=tutorial:hello_world)`
Fixed crash if initialization of EGL failed but was tried again later. The internal function SDL_EGL_LoadLibrary() did not delete and remove a mostly uninitialized data structure if loading the library first failed. A later try to use EGL then skipped initialization and assumed it was previously successful because the data structure now already existed. This led to at least one crash in the internal function SDL_EGL_ChooseConfig() because a NULL pointer was dereferenced to make a call to eglBindAPI(). 2015-06-21 09:33:46 -06:00
Updating Readme-psp info 2022-02-02 00:16:45 -07:00			`## To Do`
			`- PSP Screen Keyboard`
First pass at changing SDL 2.0 to SDL 3.0 2022-11-21 21:28:58 -07:00			`- Dialogs`