dwww Home | Manual pages | Find package

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)

Generated by dwww version 1.15 on Sun Jun 23 04:43:21 CEST 2024.