comparison docs/html/sdlenableunicode.html @ 181:e5bc29de3f0a

Updated from the SDL Documentation Project
author Sam Lantinga <slouken@libsdl.org>
date Fri, 14 Sep 2001 02:41:09 +0000
parents 55f1f1b3e27d
children 355632dca928
comparison
equal deleted inserted replaced
180:578815880307 181:e5bc29de3f0a
71 >SDL_EnableUNICODE</A 71 >SDL_EnableUNICODE</A
72 ></H1 72 ></H1
73 ><DIV 73 ><DIV
74 CLASS="REFNAMEDIV" 74 CLASS="REFNAMEDIV"
75 ><A 75 ><A
76 NAME="AEN5262" 76 NAME="AEN5417"
77 ></A 77 ></A
78 ><H2 78 ><H2
79 >Name</H2 79 >Name</H2
80 >SDL_EnableUNICODE&nbsp;--&nbsp;Enable UNICODE translation</DIV 80 >SDL_EnableUNICODE&nbsp;--&nbsp;Enable UNICODE translation</DIV
81 ><DIV 81 ><DIV
82 CLASS="REFSYNOPSISDIV" 82 CLASS="REFSYNOPSISDIV"
83 ><A 83 ><A
84 NAME="AEN5265" 84 NAME="AEN5420"
85 ></A 85 ></A
86 ><H2 86 ><H2
87 >Synopsis</H2 87 >Synopsis</H2
88 ><DIV 88 ><DIV
89 CLASS="FUNCSYNOPSIS" 89 CLASS="FUNCSYNOPSIS"
90 ><A 90 ><A
91 NAME="AEN5266" 91 NAME="AEN5421"
92 ></A 92 ></A
93 ><P 93 ><P
94 ></P 94 ></P
95 ><PRE 95 ><PRE
96 CLASS="FUNCSYNOPSISINFO" 96 CLASS="FUNCSYNOPSISINFO"
110 ></DIV 110 ></DIV
111 ></DIV 111 ></DIV
112 ><DIV 112 ><DIV
113 CLASS="REFSECT1" 113 CLASS="REFSECT1"
114 ><A 114 ><A
115 NAME="AEN5272" 115 NAME="AEN5427"
116 ></A 116 ></A
117 ><H2 117 ><H2
118 >Description</H2 118 >Description</H2
119 ><P 119 ><P
120 >Enables/Disables UNICODE keyboard translation.</P 120 >Enables/Disables Unicode keyboard translation.</P
121 ><P 121 ><P
122 >If you wish to translate a keysym to it's printable representation, you need to enable UNICODE translation 122 >To obtain the character codes corresponding to received keyboard events,
123 using this function (<TT 123 Unicode translation must first be turned on using this function. The
124 translation incurs a slight overhead for each keyboard event and is therefore
125 disabled by default. For each subsequently received key down event, the
126 <TT
127 CLASS="STRUCTFIELD"
128 ><I
129 >unicode</I
130 ></TT
131 > member of the
132 <A
133 HREF="sdlkeysym.html"
134 ><SPAN
135 CLASS="STRUCTNAME"
136 >SDL_keysym</SPAN
137 ></A
138 > structure
139 will then contain the corresponding character code, or zero for keysyms that do
140 not correspond to any character code.</P
141 ><P
142 >A value of 1 for <TT
124 CLASS="PARAMETER" 143 CLASS="PARAMETER"
125 ><I 144 ><I
126 >enable</I 145 >enable</I
127 ></TT 146 ></TT
128 >=0) and then look in the <TT 147 > enables Unicode translation;
129 CLASS="STRUCTFIELD" 148 0 disables it, and -1 leaves it unchanged (useful for querying the current
130 ><I 149 translation mode).</P
131 >unicode</I 150 ><P
132 ></TT 151 >Note that only key press events will be translated, not release events.</P
133 > member
134 of the <A
135 HREF="sdlkeysym.html"
136 ><SPAN
137 CLASS="STRUCTNAME"
138 >SDL_keysym</SPAN
139 ></A
140 > structure. This value will be zero for keysyms
141 that do not have a printable representation. UNICODE translation is disabled by default as the conversion can cause a slight overhead.</P
142 ></DIV 152 ></DIV
143 ><DIV 153 ><DIV
144 CLASS="REFSECT1" 154 CLASS="REFSECT1"
145 ><A 155 ><A
146 NAME="AEN5280" 156 NAME="AEN5437"
147 ></A 157 ></A
148 ><H2 158 ><H2
149 >Return Value</H2 159 >Return Value</H2
150 ><P 160 ><P
151 >Returns the previous translation mode.</P 161 >Returns the previous translation mode (<SPAN
162 CLASS="RETURNVALUE"
163 >0</SPAN
164 > or <SPAN
165 CLASS="RETURNVALUE"
166 >1</SPAN
167 >).</P
152 ></DIV 168 ></DIV
153 ><DIV 169 ><DIV
154 CLASS="REFSECT1" 170 CLASS="REFSECT1"
155 ><A 171 ><A
156 NAME="AEN5283" 172 NAME="AEN5442"
157 ></A 173 ></A
158 ><H2 174 ><H2
159 >See Also</H2 175 >See Also</H2
160 ><P 176 ><P
161 ><A 177 ><A