SYNOPSIS

       #include "SDL.h"

       int SDL_EnableUNICODE(int enable);

DESCRIPTION

       Enables/Disables Unicode keyboard translation.

       To  obtain  the  character  codes  corresponding  to  received keyboard
       events, Unicode translation must first be turned on  using  this  func-
       tion.  The translation incurs a slight overhead for each keyboard event
       and is therefore disabled by default. For  each  subsequently  received
       key  down  event,  the  unicode member of the SDL_keysym structure will
       then contain the corresponding character code, or zero for keysyms that
       do not correspond to any character code.

       A value of 1 for enable enables Unicode translation; 0 disables it, and
       -1 leaves it unchanged (useful for  querying  the  current  translation
       mode).

       Note that only key press events will be translated, not release events.

RETURN VALUE

       Returns the previous translation mode (0 or 1).

SEE ALSO

       SDL_keysym



SDL                         Tue 11 Sep 2001, 22:59        SDL_EnableUNICODE(3)