DragonFly On-Line Manual Pages

SDL_EnableUNICODE(3)	       SDL API Reference	  SDL_EnableUNICODE(3)

NAME
       SDL_EnableUNICODE - Enable UNICODE translation

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)