1<HTML 2><HEAD 3><TITLE 4>SDL_EnableUNICODE</TITLE 5><META 6NAME="GENERATOR" 7CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ 8"><LINK 9REL="HOME" 10TITLE="SDL Library Documentation" 11HREF="index.html"><LINK 12REL="UP" 13TITLE="Event Functions." 14HREF="eventfunctions.html"><LINK 15REL="PREVIOUS" 16TITLE="SDL_GetKeyName" 17HREF="sdlgetkeyname.html"><LINK 18REL="NEXT" 19TITLE="SDL_EnableKeyRepeat" 20HREF="sdlenablekeyrepeat.html"></HEAD 21><BODY 22CLASS="REFENTRY" 23BGCOLOR="#FFF8DC" 24TEXT="#000000" 25LINK="#0000ee" 26VLINK="#551a8b" 27ALINK="#ff0000" 28><DIV 29CLASS="NAVHEADER" 30><TABLE 31SUMMARY="Header navigation table" 32WIDTH="100%" 33BORDER="0" 34CELLPADDING="0" 35CELLSPACING="0" 36><TR 37><TH 38COLSPAN="3" 39ALIGN="center" 40>SDL Library Documentation</TH 41></TR 42><TR 43><TD 44WIDTH="10%" 45ALIGN="left" 46VALIGN="bottom" 47><A 48HREF="sdlgetkeyname.html" 49ACCESSKEY="P" 50>Prev</A 51></TD 52><TD 53WIDTH="80%" 54ALIGN="center" 55VALIGN="bottom" 56></TD 57><TD 58WIDTH="10%" 59ALIGN="right" 60VALIGN="bottom" 61><A 62HREF="sdlenablekeyrepeat.html" 63ACCESSKEY="N" 64>Next</A 65></TD 66></TR 67></TABLE 68><HR 69ALIGN="LEFT" 70WIDTH="100%"></DIV 71><H1 72><A 73NAME="SDLENABLEUNICODE" 74></A 75>SDL_EnableUNICODE</H1 76><DIV 77CLASS="REFNAMEDIV" 78><A 79NAME="AEN5805" 80></A 81><H2 82>Name</H2 83>SDL_EnableUNICODE -- Enable UNICODE translation</DIV 84><DIV 85CLASS="REFSYNOPSISDIV" 86><A 87NAME="AEN5808" 88></A 89><H2 90>Synopsis</H2 91><DIV 92CLASS="FUNCSYNOPSIS" 93><A 94NAME="AEN5809" 95></A 96><P 97></P 98><PRE 99CLASS="FUNCSYNOPSISINFO" 100>#include "SDL.h"</PRE 101><P 102><CODE 103><CODE 104CLASS="FUNCDEF" 105>int <B 106CLASS="FSFUNC" 107>SDL_EnableUNICODE</B 108></CODE 109>(int enable);</CODE 110></P 111><P 112></P 113></DIV 114></DIV 115><DIV 116CLASS="REFSECT1" 117><A 118NAME="AEN5815" 119></A 120><H2 121>Description</H2 122><P 123>Enables/Disables Unicode keyboard translation.</P 124><P 125>To obtain the character codes corresponding to received keyboard events, 126Unicode translation must first be turned on using this function. The 127translation incurs a slight overhead for each keyboard event and is therefore 128disabled by default. For each subsequently received key down event, the 129<TT 130CLASS="STRUCTFIELD" 131><I 132>unicode</I 133></TT 134> member of the 135<A 136HREF="sdlkeysym.html" 137><SPAN 138CLASS="STRUCTNAME" 139>SDL_keysym</SPAN 140></A 141> structure 142will then contain the corresponding character code, or zero for keysyms that do 143not correspond to any character code.</P 144><P 145>A value of 1 for <TT 146CLASS="PARAMETER" 147><I 148>enable</I 149></TT 150> enables Unicode translation; 1510 disables it, and -1 leaves it unchanged (useful for querying the current 152translation mode).</P 153><P 154>Note that only key press events will be translated, not release events.</P 155></DIV 156><DIV 157CLASS="REFSECT1" 158><A 159NAME="AEN5825" 160></A 161><H2 162>Return Value</H2 163><P 164>Returns the previous translation mode (<SPAN 165CLASS="RETURNVALUE" 166>0</SPAN 167> or <SPAN 168CLASS="RETURNVALUE" 169>1</SPAN 170>).</P 171></DIV 172><DIV 173CLASS="REFSECT1" 174><A 175NAME="AEN5830" 176></A 177><H2 178>See Also</H2 179><P 180><A 181HREF="sdlkeysym.html" 182><SPAN 183CLASS="STRUCTNAME" 184>SDL_keysym</SPAN 185></A 186></P 187></DIV 188><DIV 189CLASS="NAVFOOTER" 190><HR 191ALIGN="LEFT" 192WIDTH="100%"><TABLE 193SUMMARY="Footer navigation table" 194WIDTH="100%" 195BORDER="0" 196CELLPADDING="0" 197CELLSPACING="0" 198><TR 199><TD 200WIDTH="33%" 201ALIGN="left" 202VALIGN="top" 203><A 204HREF="sdlgetkeyname.html" 205ACCESSKEY="P" 206>Prev</A 207></TD 208><TD 209WIDTH="34%" 210ALIGN="center" 211VALIGN="top" 212><A 213HREF="index.html" 214ACCESSKEY="H" 215>Home</A 216></TD 217><TD 218WIDTH="33%" 219ALIGN="right" 220VALIGN="top" 221><A 222HREF="sdlenablekeyrepeat.html" 223ACCESSKEY="N" 224>Next</A 225></TD 226></TR 227><TR 228><TD 229WIDTH="33%" 230ALIGN="left" 231VALIGN="top" 232>SDL_GetKeyName</TD 233><TD 234WIDTH="34%" 235ALIGN="center" 236VALIGN="top" 237><A 238HREF="eventfunctions.html" 239ACCESSKEY="U" 240>Up</A 241></TD 242><TD 243WIDTH="33%" 244ALIGN="right" 245VALIGN="top" 246>SDL_EnableKeyRepeat</TD 247></TR 248></TABLE 249></DIV 250></BODY 251></HTML 252>