README
author Sam Lantinga <slouken@libsdl.org>
Tue, 19 Apr 2011 08:08:50 -0700
changeset 5539 b305e3c2d2e7
parent 5537 8a66741be632
child 6251 3e8c673cad58
permissions -rw-r--r--
Fixed: Windows always fails with SDL_HapticOpenFromJoystick

The windows function SDL_SYS_HapticOpenFromJoystick fails because DIDEVICEINSTANCE joy_instance does not have its dwSize field initialized. The attached patch includes the fix along with a fix for two similar problems.

Daniel Heath
slouken@0
     1
slouken@0
     2
                         Simple DirectMedia Layer
slouken@0
     3
slouken@0
     4
                                  (SDL)
slouken@0
     5
slouken@5103
     6
                                Version 1.3
slouken@0
     7
slouken@0
     8
---
slouken@0
     9
http://www.libsdl.org/
slouken@0
    10
slouken@602
    11
This is the Simple DirectMedia Layer, a general API that provides low
slouken@0
    12
level access to audio, keyboard, mouse, joystick, 3D hardware via OpenGL,
slouken@0
    13
and 2D framebuffer across multiple platforms.
slouken@0
    14
slouken@5103
    15
The current version supports Windows, Windows CE, Mac OS X, Linux, FreeBSD,
slouken@5150
    16
NetBSD, OpenBSD, BSD/OS, Solaris, iOS, and Android. The code contains
slouken@5103
    17
support for other operating systems but those are not officially supported.
slouken@1763
    18
slouken@0
    19
SDL is written in C, but works with C++ natively, and has bindings to
slouken@1763
    20
several other languages, including Ada, C#, Eiffel, Erlang, Euphoria,
slouken@5327
    21
Go, Guile, Haskell, Java, Lisp, Lua, ML, Objective C, Pascal, Perl, PHP,
slouken@1763
    22
Pike, Pliant, Python, Ruby, and Smalltalk.
slouken@0
    23
slouken@5537
    24
This library is distributed under the zlib license, which can be found
slouken@5537
    25
in the file "COPYING".
slouken@0
    26
slouken@0
    27
The best way to learn how to use SDL is to check out the header files in
slouken@0
    28
the "include" subdirectory and the programs in the "test" subdirectory.
slouken@0
    29
The header files and test programs are well commented and always up to date.
slouken@1763
    30
More documentation is available in HTML format in "docs/index.html", and
slouken@1763
    31
a documentation wiki is available online at:
slouken@1763
    32
	http://www.libsdl.org/cgi/docwiki.cgi
slouken@0
    33
slouken@0
    34
The test programs in the "test" subdirectory are in the public domain.
slouken@0
    35
slouken@0
    36
Frequently asked questions are answered online:
slouken@369
    37
	http://www.libsdl.org/faq.php
slouken@0
    38
slouken@0
    39
If you need help with the library, or just want to discuss SDL related
slouken@0
    40
issues, you can join the developers mailing list:
slouken@369
    41
	http://www.libsdl.org/mailing-list.php
slouken@0
    42
slouken@0
    43
Enjoy!
slouken@0
    44
	Sam Lantinga				(slouken@libsdl.org)
slouken@0
    45