Go to file
Sam Lantinga dcd17f5473 Renderer logical size is now implemented as a render target
This fixes rounding errors with coordinate scaling and gives more flexibility in the presentation, as well as making it easy to maintain device independent resolution as windows move between different pixel density displays.

By default when a renderer is created, it will match the window size so window coordinates and render coordinates are 1-1.

Mouse and touch events are no longer filtered to change their coordinates, instead you can call SDL_ConvertEventToRenderCoordinates() to explicitly map event coordinates into the rendering viewport.

SDL_RenderWindowToLogical() and SDL_RenderLogicalToWindow() have been renamed SDL_RenderCoordinatesFromWindow() and SDL_RenderCoordinatesToWindow() and take floating point coordinates in both directions.

The viewport, clipping state, and scale for render targets are now persistent and will remain set whenever they are active.
2023-02-03 12:57:37 -08:00
.github ci: don't upload test directory for ps2 workflow separately 2023-02-01 20:04:47 +01:00
VisualC cmake: capitalize SDL3::Headers target 2023-01-31 01:59:21 +01:00
VisualC-GDK Moved testautomation data out of SDL_test library 2023-01-26 10:25:44 -08:00
VisualC-WinRT Moved testautomation data out of SDL_test library 2023-01-26 10:25:44 -08:00
Xcode cmake: capitalize SDL3::Headers target 2023-01-31 01:59:21 +01:00
android-project Android: display_mode scale: cast to do a float division 2023-01-27 08:17:20 -08:00
build-scripts Renderer logical size is now implemented as a render target 2023-02-03 12:57:37 -08:00
cmake cmake: fix installed SDL3::SDL3_test + test on ci 2023-01-31 05:29:38 +01:00
docs Renderer logical size is now implemented as a render target 2023-02-03 12:57:37 -08:00
include Renderer logical size is now implemented as a render target 2023-02-03 12:57:37 -08:00
mingw/pkg-support/cmake build: don't add SDL3 subfolder to include path for external projects 2022-11-27 14:33:13 -08:00
src Renderer logical size is now implemented as a render target 2023-02-03 12:57:37 -08:00
test Renderer logical size is now implemented as a render target 2023-02-03 12:57:37 -08:00
wayland-protocols wayland: Add high-resolution event timestamp support 2022-12-04 16:56:26 -08:00
.clang-format Commented out syntax that causes Visual Studio 2019 to complain on every edit 2022-12-02 00:43:01 -08:00
.editorconfig Fixed formatting for Haiku cc files 2023-01-25 03:03:41 -08:00
.gitignore Removed QtCreator entries from .gitignore 2023-01-04 11:18:18 -08:00
.wikiheaders-options wikiheaders: Fixed SDL2 wiki link. 2023-01-26 14:50:52 -05:00
Android.mk Create a static SDL_test library on Android 2023-01-25 13:06:42 -08:00
BUGS.txt Cleaned up a few more Bugzilla mentions. 2021-02-12 14:46:49 -05:00
CMakeLists.txt cmake: fix installed SDL3::SDL3_test + test on ci 2023-01-31 05:29:38 +01:00
CREDITS.txt Use Apple's nomenclature for macOS and iOS 2022-11-25 16:00:06 -08:00
INSTALL.txt Use Apple's nomenclature for macOS and iOS 2022-11-25 16:00:06 -08:00
LICENSE.txt Updated copyright for 2023 2023-01-09 09:41:41 -08:00
README-SDL.txt More HTTPS changes in the documentation. 2017-02-16 16:52:03 -05:00
README.md First pass at changing SDL 2.0 to SDL 3.0 2022-11-21 20:28:58 -08:00
TODO.txt Fixed up legacy MoinMoin URLs at wiki.libsdl.org 2021-04-01 12:20:33 -04:00
WhatsNew.txt Add SDL_ConvertAudioSamples() helper function 2023-01-24 08:26:09 -08:00

README.md

Simple DirectMedia Layer (SDL) Version 3.0

https://www.libsdl.org/

Simple DirectMedia Layer is a cross-platform development library designed to provide low level access to audio, keyboard, mouse, joystick, and graphics hardware via OpenGL and Direct3D. It is used by video playback software, emulators, and popular games including Valve's award winning catalog and many Humble Bundle games.

More extensive documentation is available in the docs directory, starting with README.md

Enjoy!

Sam Lantinga (slouken@libsdl.org)