SDL/docs/README-n3ds.md

# Nintendo 3DS

SDL port for the Nintendo 3DS [Homebrew toolchain](https://devkitpro.org/) contributed by:

-   [Pierre Wendling](https://github.com/FtZPetruska)

Credits to:

-   The awesome people who ported SDL to other homebrew platforms.
-   The Devkitpro team for making all the tools necessary to achieve this.

## Building

To build for the Nintendo 3DS, make sure you have devkitARM and cmake installed and run:

```bash
cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE="$DEVKITPRO/cmake/3DS.cmake" -DCMAKE_BUILD_TYPE=Release
cmake --build build
cmake --install build
```

## Notes

-   Currently only software rendering is supported.
-   SDL3_main should be used to ensure ROMFS is enabled.
-   By default, the extra L2 cache and higher clock speeds of the New 2/3DS lineup are enabled. If you wish to turn it off, use `osSetSpeedupEnable(false)` in your main function.
-   `SDL_GetBasePath` returns the romfs root instead of the executable's directory.
N3DS port (squashed) A dedicated renderer using Citro3D would likely allow for better much better graphical performances. 2021-03-30 02:32:39 -06:00			`# Nintendo 3DS`

			`SDL port for the Nintendo 3DS [Homebrew toolchain](https://devkitpro.org/) contributed by:`

			`- [Pierre Wendling](https://github.com/FtZPetruska)`

			`Credits to:`

			`- The awesome people who ported SDL to other homebrew platforms.`
			`- The Devkitpro team for making all the tools necessary to achieve this.`

			`## Building`

			`To build for the Nintendo 3DS, make sure you have devkitARM and cmake installed and run:`

			```bash
			`cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE="$DEVKITPRO/cmake/3DS.cmake" -DCMAKE_BUILD_TYPE=Release`
			`cmake --build build`
			`cmake --install build`
			```

			`## Notes`

			`- Currently only software rendering is supported.`
Rename SDLmain to SDL_main and SDLtest to SDL_test for consistency with other SDL libraries 2022-11-28 10:54:09 -07:00			`- SDL3_main should be used to ensure ROMFS is enabled.`
N3DS: Update README. 2022-09-18 12:01:36 -06:00			- By default, the extra L2 cache and higher clock speeds of the New 2/3DS lineup are enabled. If you wish to turn it off, use `osSetSpeedupEnable(false)` in your main function.
N3DS: Document the SDL_GetBasePath behaviour. 2022-11-14 15:34:22 -07:00			- `SDL_GetBasePath` returns the romfs root instead of the executable's directory.