SDL/include
Eric Wing 313881175d Adds support to control the scaling policy/mode of SDL_RenderSetLogicalSize for both letterbox (current behavior) and a new overscan mode (expand to fill the entire screen, even if some parts draw off the screen).
The expected use case is for games that are designed with multiple aspect ratios already in mind and leave optional margins on the edges of the game which won't hurt if they are cut off.

An example use case is a game is designed for wide-screen/16:9, but then wants to deploy on an iPad which is 4:3. Normally, SDL will letterbox, which will shrink things and result in wasted space. But the designer already thought about 4:3 and designed the edges of the game so they could be cut off without any functional loss. So rather than wasting space with letterboxing, "overscan" mode will zoom the rendering to fill up the entire screen. Parts on the edges will be drawn offscreen, but since the game was already designed with this in mind, it is fine. The end result is the iPad (4:3) experience is much better since it feels like a game designed for that screen aspect ratio.

This patch introduces a new SDL_hint: SDL_HINT_RENDER_LOGICAL_SIZE_MODE.
Valid values are "letterbox" or "0" for letterboxing and "overscan" or "1" for overscan.
The default mode is letterbox to preserve existing behavior.

// Example usage:
SDL_SetHint(SDL_HINT_RENDER_LOGICAL_SIZE_MODE, "overscan");
SDL_RenderSetLogicalSize(renderer, SCREEN_WIDTH, SCREEN_HEIGHT);
2014-12-03 04:41:26 -08:00
..
begin_code.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
close_code.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_assert.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_atomic.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_audio.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_bits.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_blendmode.h Corrected header file guard comments. 2014-11-25 22:37:12 +01:00
SDL_clipboard.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config.h.cmake Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config.h.in Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config_android.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config_iphoneos.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config_macosx.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config_minimal.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config_pandora.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config_psp.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config_windows.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config_winrt.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_config_wiz.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_copying.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_cpuinfo.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_egl.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_endian.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_error.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_events.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_filesystem.h Corrected header file guard comments. 2014-11-25 22:37:12 +01:00
SDL_gamecontroller.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_gesture.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_haptic.h Fixed bug 2766 - Haptic coding bugs and fixes for Linux FF: periodic.phase handled as time instead of angle; + direction clarification 2014-11-29 11:49:58 -08:00
SDL_hints.h Adds support to control the scaling policy/mode of SDL_RenderSetLogicalSize for both letterbox (current behavior) and a new overscan mode (expand to fill the entire screen, even if some parts draw off the screen). 2014-12-03 04:41:26 -08:00
SDL_joystick.h Fixed typo in header file documentation comment. 2014-11-23 11:26:46 +01:00
SDL_keyboard.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_keycode.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_loadso.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_log.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_main.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_messagebox.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_mouse.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_mutex.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_name.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_opengl.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_opengl_glext.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_opengles.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_opengles2.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_opengles2_gl2.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_opengles2_gl2ext.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_opengles2_gl2platform.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_opengles2_khrplatform.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_pixels.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_platform.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_power.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_quit.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_rect.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_render.h Improved the pitch variable description 2014-11-29 11:18:49 -08:00
SDL_revision.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_rwops.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_scancode.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_shape.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_stdinc.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_surface.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_system.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_syswm.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_test.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_test_assert.h Fixed typos in header file documentation comments. 2014-11-23 20:40:48 +01:00
SDL_test_common.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_test_compare.h Fix assert format strings/parameters in testautomation modules; improve output of SDL_CompareSurfaces to aid debugging; update platform_testSetErrorInvalidInput for SDL changes 2014-11-30 20:55:27 -08:00
SDL_test_crc32.h Fixed doxygen tags in header file documentation comments. 2014-11-23 20:46:34 +01:00
SDL_test_font.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_test_fuzzer.h Fixed doxygen tags in header file documentation comments. 2014-11-23 20:46:34 +01:00
SDL_test_harness.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_test_images.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_test_log.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_test_md5.h Fixed doxygen tags in header file documentation comments. 2014-11-23 20:46:34 +01:00
SDL_test_random.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_thread.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_timer.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_touch.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_types.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_version.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00
SDL_video.h Corrected header file documentation comment. 2014-11-22 22:20:40 +01:00