Finger info for

  Here's the rough checklist for new features in SDL 1.3 (which will
  eventually become SDL 2.0). This list is subject to change, so while some
  of this work is already done, none of it should be taken as a promise of
  any sort. Comments, complaints, and requests are still welcome.

  First, some bad news: we'll probably drop a lot of platforms/targets that
  no one is maintaining (but happily add them back in if someone steps up
  to support them). Also, backwards compatibility is not law in 1.3/2.0. In
  many cases we have added a compatibility layer that wraps the 1.3 interfaces
  in the old 1.2 functions, but if we have to break binary or source
  compatibility, we will. We don't think the damage will be extensive, but
  there will probably be some pieces of code in the wild that need to be
  updated (or continue to use SDL 1.2). You have been warned. With that out
  of the way, here's the rough list of cool, shiny, new things...

  Video and events:
  - Multiple windows! You don't need to have a single video surface anymore!
  This is a new API (but SDL_SetVideoMode() still exists in the
  compatibility layer).
  - Multiple displays: SDL exposes details of what physical monitors are
  hooked up to a machine and lets you control them individually.
  - Formal API for positioning SDL windows: it sort of comes with the
  multiple window/display support. No more setting environment variables
  for this!
  - Video device enumeration: you can get an idea of what APIs and hardware
  are available to you.
  - 2D acceleration: SDL can use OpenGL or Direct3D behind the scenes with
  the 2D interfaces, so we can get acceleration on modern systems where
  X11 or DirectDraw just aren't the fast paths anymore. The framebuffer-
  oriented interfaces, like X11, are still there, though, for legacy
  platforms and hardware.
  - Texture support: the 2D interfaces now concern themselves with "textures"
  and not surfaces. The assumption is that, even in 2D graphics, you now
  want to try to push all the effort to the hardware when you can,
  falling back to software where you can't. On the most basic level, this
  just means you can't get at pixel-based framebuffers without locking
  the "texture" and doing so may be much more expensive than in 1.2, but
  in many common scenarios, a well-designed program can be significantly
  more efficient in 1.3. There are some basic texture operations to offload
  common per-pixel operations to hardware so you may not have to lock the
  texture and do it yourself. This is meant to be a very simple API,
  however: those needing more, even in 2D, should consider using OpenGL
  - Multiple input devices: we'll be merging ManyMouse into SDL, which
  will let us handle input from more than one connected mouse on at least
  Linux, Mac OS X, and Windows. If all you care about is the usual generic
  pointer input, that'll still work, too, but if you want to make a game
  where all your friends plug in a USB mouse and compete, that'll now be
  possible. This is also interesting for experimental work that has nothing
  to do with games, or Photoshop-style things that want mice AND pens, etc.
  - Pressure/tilt support: mouse-like input devices like tablets will be
  able to report their pressure/tilt through SDL, for those that want to
  write art programs. TuxPaint, I'm looking at you here.
  - Horizontal mousewheel events: SDL 1.2 only responds to the oldschool
  vertical mousewheel, but many mice you buy now can scroll horizontally,
  too, including the Mighty Mouse that ships with Apple desktops. There's
  a formal event for this in SDL 1.3.
  - Mousewheel no longer looks like a button: SDL 1.2 treats wheelup as
  button 4 and wheeldown as button 5. This was an accident of history,
  since XFree86 mapped the wheel to these buttons back when Loki had an
  interest in making this work Right Now, but it wasn't guaranteed to be
  those buttons, and it never was on other platforms. These have been
  moved to formal events in 1.3.
  - Separation of text input and key events: Basically, we're fixing the
  Unicode support. The keyboard can be treated as a 101-button gamepad
  with the usual KEYUP/KEYDOWN events, but there will be separate
  events for text input, so IME implementations can let users compose
  characters as they'd expect to on their platform. This will replace the
  "unicode" field in 1.2 key events, which was universally unreliable
  once you stepped outside of America and Europe.
  - Formal API to permit screensaver: no more environment variable hack!
  This is useful if you're writing a windowed application and not a game.

  - Audio capture support: You can record from a microphone, etc, and recover
  this data through SDL.
  - Audio device enumeration: You can find and choose specific audio devices.
  - Multiple audio device support: You can open multiple devices and playback
  different audio from each at the same time. Take all these things and
  you could, for example, have a game where the audio plays through a
  set of speakers, but speech from your teammates comes to a USB headset
  while you reply through a microphone...and probably other interesting
  things we haven't thought of yet.
  - Audio device disconnect notification: if someone accidentally kicks out
  their USB audio widget, the app can be notified, so they can pause and
  let the user get reconfigured, etc.
  - Support for PCM data in int32 format.
  - Support for PCM data in float32 format.
  - Non-power-of-two resampling. If you had to do something other than
  double or halve your sample rate, SDL 1.2 would break (and probably
  corrupt memory). This will be fixed in SDL 1.3. This is useful for
  programs that worked fine with data at 22050Hz when everyone was using
  audio cards at 11025Hz, 22050Hz, or 44100Hz, but now there are a lot of
  motherboard cards that only eat at 48000Hz and break badly in 1.2.
  - 7.1 output support.
  - Macros to parse audio format enumerations.
  No more need to do things like this:
  const int bitsize = MyAudioFormat & 0xFF;
  Now you can do the more readable:
  const int bitsize = SDL_AUDIO_BITSIZE(MyAudioFormat);
  (...and others like this.)
  - SDL_MixAudio() won't need an open audio device: In SDL 1.2, you could
  only mix audio buffers based on the opened device format. This has been
  changed to a generic interface in SDL 1.3 that allows mixing data without
  dependency on a specific device, or a device at all.
  - Better audio format converters: these should be faster and work better,
  since we generate all the possible cases in a perl script now instead of
  trying to tapdance at runtime. This means converting a buffer takes one
  pass regardless of format, instead of a pass to change bitsize, another
  to change the format, another to change the signedness, etc. This is
  cleaner to maintain and extend, and doesn't thrash the CPU cache as much,

  - Connect notification: In 1.2, you needed to restart the
  joystick subsystem to find new sticks. In 1.3, your friend can walk up
  and plug in his controller, and your game will be able to announce "a
  new challenger approaches!"
  - Disconnect notification: ...and you'll also be able to deal with the
  controller getting kicked out midgame, or your friend getting tired of
  losing and leaving with his controller.
  - Force feedback: sticks and platforms that support vibration, rumble, etc,
  will be controllable via SDL.

  - No longer required on any platform. Now it does what it was intended
  for: hiding differences in main/WinMain/etc. Initialization details
  are being moved into SDL_Init() where they belong. This makes it easier
  to have SDL as a plugin, or use a non-SDL path without it hijacking your
  mainline just to function. This is really useful for scripting languages,
  since, say, a Python program might want to use SDL without linking SDL
  directly to python.exe and replacing its main() function.

  - Atomic operations API: a way to deal with atomic operations like
  test-and-set and compare-and-swap will be added. This is becoming
  increasingly important in game development, and every processor and
  platform handles this differently, so it'll be nice to abstract the
  details into SDL.
  - SDL_KillThread() is gone. It was never safe or portable. The function
  will continue to exist for binary compatibility, but it will always
  be a no-op that reports failure. If you need this, your program has
  problems anyhow and needs minor reworking to cleanly handle thread
  termination, even if KillThread was still available.

  Planned but not yet fully considered:
  - Some minor cleanups and clarifications to the RWOPS api are planned
  to fill some gaps, but this is still work in progress.
  - A basic API to read/write from the system clipboard would be nice.
  - A basic API to support drag'n'drop with the system would be nice.
  - Probably other stuff! Let Ryan know what you want!

When this .plan was written: 2007-10-07 16:50:57
.plan archives for this user are here (RSS here).
Powered by IcculusFinger v2.1.27
Stick it in the camel and go.