KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #ai-agent #claude-code #mcp #typescript #codex #cli #rust #deepseek-harness

SDL-3DS

★ 81 Open GitHub ↗

SDL 1.2 for 3DS

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SDL-3DS
SDL 1.2 for 3DS

Simple DirectMedia Layer

(SDL)

Version 1.2.15 Nintendo 3DS port
---

TOC
============

- Credits
- Installation
- Video
- Events
- Key input
- Joystick
- Mousepointer
- Audio

CREDITS
============

This port of the SDL 1.2 lib to 3ds was made with the help of several coders of the 3ds scene: Xerpi, Rikku2000, Nop90, Wenting,
The autotools scripts where tuned with the help of WinterMute (maintainer of DevkitPro)

INSTALLATION
============

Run make all to build and install:
 - SDL
 - SDL_ttf
 - SDL_mixer
 - SDL_image
 - SDL_net
 - SDL_sound
 - SDL_gfx
 
The installation script for SDL_image and SDL_gfx need to be fixed, so the global makefile uses two prebuilt makefiles.

VIDEO
============

the video device will be rendered centered on the HW screen (default screen is the TOP one)

five bpp modes supported : 32 (RGBA8), 24 (RGB8), 16 (RGB565), 15 (RGB555_A1), 8 (paletted)

With these video sizes can be used the following options:

- SDL_FULLSCREEN option stretchs the video device on the HW screen.
- SDL_TOPSCR: select the top screen for rendering the video device (it's the default option, so you don't really need to set this flag)
- SDL_BOTTOMSCR: select the bottom screen for rendering the video device
- SDL_DUALSCR: draws the upper half of the video device on the top screeen and the lower half on the bottom screen
- SDL_FITWIDTH: resizes the video device to fit the selected screen width (if SDL_DUALSCR is set, its' resized to 400 pixel width)
- SDL_FITHEIGHT: resizes the video device to fit the screen/screens height
- SDL_CONSOLETOP: enables console output on the top screen (only if SDL_TOPSCR or SDL_FULLSCREEN are not set)  
- SDL_CONSOLEBOTTOM: enables console output on the bottom screen (only if SDL_BOTTOMSCR or SDL_FULLSCREEN are not set)

Note: using the SDL_FULLSCREEN flag is the same of using (SDL_TOPSCR | SDL_BOTTOMSCR)

EVENTS
============

SDL events handles the interaction with the 3ds home menu in homebrews released in installable format (CIA). The lib puts the code in the sleep mode when closing the lid and triggers a SDL_QUIT event when closing the app from the 3ds home menu.

Rmember that once the SDL_QUIT event is triggered, the code can't access anymore to the video services or thecode will hung.

KEY INPUT
============

Default key bindings are:

KEY_A -> SDLK_a
	KEY_B -> SDLK_b
	KEY_X -> SDLK_x
	KEY_Y -> SDLK_y
	KEY_L -> SDLK_l
	KEY_R -> SDLK_r
	KEY_ZL -> SDLK_LSHIFT
	KEY_ZR -> SDLK_RSHIFT
	KEY_START -> SDLK_RETURN
	KEY_SELECT -> SDLK_ESCAPE
	KEY_RIGHT -> SDLK_RIGHT
	KEY_LEFT -> SDLK_LEFT
	SDLK_UP -> KEY_UP
	KEY_DOWN -> SDLK_DOWN
 
there is a custom function to bind one or more N3DS keys to a SDL key value:

void SDL_N3DSKeyBind(unsigned int hidkey, SDLKey key)

NOTE: circle pad and C-Stick are not mapped to the direction key by default( circle pad is mapped to the default Joystick) but if someone wants to make this mapping he can use the following code:
	
	SDL_N3DSKeyBind(KEY_CPAD_UP|KEY_CSTICK_UP, SDLK_UP);
	SDL_N3DSKeyBind(KEY_CPAD_DOWN|KEY_CSTICK_DOWN, SDLK_DOWN);
	SDL_N3DSKeyBind(KEY_CPAD_LEFT|KEY_CSTICK_LEFT, SDLK_LEFT);
	SDL_N3DSKeyBind(KEY_CPAD_RIGHT|KEY_CSTICK_RIGHT, SDLK_RIGHT);

It's not possible to bind a N3DS key to two or more SDL Key values.

JOYSTICK
============

Joystick support is enabled

MOUSEPOINTER
============

Mouse pointer is controlled with the touchpad. Touching the bottom screen controls the pointer position and trigger a left button click.

AUDIO
============

Supported audio format are AUDIO_S8 and AUDIO_S16.

Audio uses the DSP, so to use it with a homebrew compiled as a CIA you need to dump the DSp Firm in the 3ds folder. 
Audio thread would have a higher priority than the main thread, but it would give main thread a fixed time to process the audio. If you are experiencing problems with the audio, try using a larger sample buffer or change the delay time in SDL_n3dsaudio.c

MULTITHREAD
============

Multithread is supported. But please bear in mind that due to the design of 3DS' OS, thread won't evenly share CPU time. You would have to use SDL_Delay to give other threads CPU time to run. All threads would be created with a higher priority than the main thread, and they would start running as soon as you create them.

---
http://www.libsdl.org/

SDL-3DS

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README