#pragma camelcase off

= SDL 2.0 Roadmap =

This is a list of features which are in progress for the SDL 2.0 release.  The features are organized by subsystem and assigned to developers.  Features will move around as the design evolves.

<<TableOfContents(2)>>

== Video ==

=== Complete ===
 * <<Color2(col=green, text="Sam: Add support for multiple windows")>>
 * <<Color2(col=green, text="Sam: Create 3D accelerated texture based rendering API")>>
 * <<Color2(col=green, text="Sam: Create API for enabling/disabling the screensaver")>>
 * <<Color2(col=green, text="Sam: Add support for selecting video mode refresh rate")>>
 * <<Color2(col=green, text="Sam: Create API for clipboard support (check out !PyGame)")>>
 * <<Color2(col=green, text="Sam: Add support for multiple displays")>>
 * <<Color2(col=green, text="Sam: Add concept of viewport to fullscreen windows")>>
 * <<Color2(col=green, text="Sam: Add support for synchronizing 2D updates with vblank, using SDL_HINT_RENDER_VSYNC")>>
 * <<Color2(col=green, text="Mason Wheeler and Gabriel Jacobo: Add support for render targets")>>


=== Required ===
 * Ryan: Implement landscape mode for iPhone port
 * Sam: Add support for OpenGL context profiles
 * Sam: Create flags for specifying foreign window event behavior
 * <<Color2(col=green, text="Andreas: Support shaped windows")>>
   * <<Color2(col=green, text="Windows")>>
   * Mac OS X
   * <<Color2(col=green, text="Linux")>>

=== Wishlist ===
 * <<Color2(col=gray, text="Create desktop video mode change notification")>>
 * <<Color2(col=gray, text="Support always-on-top window styles")>>
 * <<Color2(col=gray, text="Support multiple icon sizes (e.g. for Windows Vista)")>>
 * <<Color2(col=gray, text="Implement NET_WM_PING and NET_WM_PID/WM_CLIENT_MACHINE (http://standards.freedesktop.org/wm-spec/wm-spec-1.3.html#KILLINGWINDOWS)")>>
 * <<Color2(col=gray, text="Support desktop windows")>>
   {{{#!highlight cpp
        setAttribute(Qt::WA_X11NetWmWindowTypeDesktop);
        setWindowFlags(Qt::SplashScreen);

        Qt::WindowFlags flags = 0;
            flags |= Qt::FramelessWindowHint;
            flags |= Qt::Tool;
            flags |= Qt::WindowStaysOnBottomHint;
}}}

== Audio ==

=== Complete ===
 * <<Color2(col=green, text="Ryan: Add support for float and 32-bit int audio formats")>>
 * <<Color2(col=green, text="Ryan: Add support for 7.1 speaker output")>>

=== Required ===
 * <<Color2(col=green, text="Ryan: Create audio recording API")>>
   * Windows
   * Mac OS X
   * Linux
 * <<Color2(col=green, text="Ryan: Add support for multiple audio devices")>>
   * Windows
   * Mac OS X
   * Linux
 * Ryan: Add support for audio device live connect and disconnect
 * Ryan: Add support for non-power-of-two audio rate conversion

=== Wishlist ===
 * <<Color2(col=gray, text="PCM volume control")>>

== Event ==

=== Complete ===
 * <<Color2(col=green, text="Sam: Add a way to dynamically register for custom event types")>>
 * <<Color2(col=green, text="Add a timeout parameter for [[SDL_WaitEvent]]() (http://lists.libsdl.org/pipermail/sdl-libsdl.org/2008-May/thread.html#65067)")>>

=== Required ===
 * Sam: Add modifier state to key and button events
 * Sam: Resolve question of how to represent iOS events which need to be handled before dispatch returns

=== Wishlist ===
 * <<Color2(col=gray, text="Add a timestamp to events")>>

== Mouse Input ==

=== Complete ===
 * <<Color2(col=green, text="Sam: Mousewheel has a separate event")>>
 * <<Color2(col=green, text="Sam: Support showing / hiding the cursor")>>
 * <<Color2(col=green, text="Sam: Add support color cursors")>>

=== Required ===
 * Sam: Reimplement mouse grab support
 * Verify cursor location is correct when ungrabbed
 * Verify proper behavior with Vista DPI scaling

=== Wishlist ===
 * <<Color2(col=gray, text="Ryan: Add support for multiple mice")>>
   * Q: What is the mapping of individual mice to pointers?  Is there a "master pointer" that multiple mice share and then events for the individual mice?  Is there a dual mode, where you have a single pointer that all mice affect, and you can switch to multiple pointers, each affected by a single mouse?
 * <<Color2(col=gray, text="Pressure/tilt support for tablet like devices")>>
 * <<Color2(col=gray, text="Add support animated cursors")>>

== Keyboard Input ==

=== Complete ===
 * <<Color2(col=green, text="Sam: Create new text input event separate from key events")>>

=== Required ===
  * Q: When you're enabling or disabling text events via keystroke, how do you ignore the text generated by the key that is toggling text input?
    A: Key events are guaranteed to happen first
 * Sam/Jiang/Daniel: Create IME API and support system IME interfaces
   * <<Color2(col=green, text="Windows")>>
   * <<Color2(col=green, text="Mac OS X")>>
   * Linux
 * Sam: Add name to keysym and name to scancode lookup functions

== Joystick Input ==

=== Complete ===
 * <<Color2(col=green, text="Edgar: Create Force Feedback API")>>

=== Required ===
 * Ryan: Add support for joystick device live connect and disconnect

== Multi-touch Input ==

=== Complete ===
 * <<Color2(col=green, text="Jim: Create multi-touch input API")>>

== Multi-threading ==

=== Complete ===
 * <<Color2(col=green, text="Sam: Create API for getting the number of CPUs")>>
 * <<Color2(col=green, text="Bob: Create API for atomic operations on data")>>
 * <<Color2(col=green, text="Sam: Remove unsafe SDL_!KillThread() API")>>
 * <<Color2(col=green, text="Sam: Create API for thread priority")>>

== Timers ==

=== Complete ===
 * <<Color2(col=green, text="Sam: Add higher precision timers for profiling")>>

== General ==

=== Complete ===
 * <<Color2(col=green, text="Ryan: Create API for assertions")>>
 * <<Color2(col=green, text="Sam: Public license for SDL_compat.c, tests, and SDL_main*")>>
 * <<Color2(col=green, text="Sam: Figure out the best way to support simultaneous SDL 1.2 and SDL 2.0 installations")>>
 * <<Color2(col=green, text="Sheena: Finish 2.0 API documentation")>>

=== Required ===
 * Sam: Write introductions for SDL 2.0 API documentation

=== Wishlist ===
 * <<Color2(col=gray, text="Create an API for live video capture")>>
 * <<Color2(col=gray, text="Create an API for accelerometer data")>>
 * <<Color2(col=gray, text="Create extended set of (negative) error codes and have the API functions document and return them")>>

----
Ryan has more information on the SDL 2.0 changes that you can find here: <<BR>>
http://icculus.org/cgi-bin/finger/finger.pl?user=icculus&date=2007-10-07&section=sdl13