Mercurial Mercurial > oss > FCL > interim > QEMU / annotate
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
symbian-qemu-0.9.1-12/libsdl-trunk/docs/html/guideinputkeyboard.html
author mikek
Mon, 17 May 2010 18:37:02 +0100
changeset 16 ccc8ba7d117c
parent 1 2fb8b9db1c86
permissions -rw-r--r--
Build was broken by a type in gui_common.h
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
     1
 
<HTML
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
     2
 
><HEAD
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
     3
 
><TITLE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
     4
 
>Handling the Keyboard</TITLE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
     5
 
><META
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
     6
 
NAME="GENERATOR"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
     7
 
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
     8
 
"><LINK
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
     9
 
REL="HOME"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    10
 
TITLE="SDL Library Documentation"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    11
 
HREF="index.html"><LINK
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    12
 
REL="UP"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    13
 
TITLE="Input handling"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    14
 
HREF="guideinput.html"><LINK
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    15
 
REL="PREVIOUS"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    16
 
TITLE="Input handling"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    17
 
HREF="guideinput.html"><LINK
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    18
 
REL="NEXT"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    19
 
TITLE="Examples"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    20
 
HREF="guideexamples.html"></HEAD
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    21
 
><BODY
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    22
 
CLASS="SECT1"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    23
 
BGCOLOR="#FFF8DC"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    24
 
TEXT="#000000"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    25
 
LINK="#0000ee"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    26
 
VLINK="#551a8b"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    27
 
ALINK="#ff0000"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    28
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    29
 
CLASS="NAVHEADER"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    30
 
><TABLE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    31
 
SUMMARY="Header navigation table"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    32
 
WIDTH="100%"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    33
 
BORDER="0"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    34
 
CELLPADDING="0"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    35
 
CELLSPACING="0"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    36
 
><TR
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    37
 
><TH
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    38
 
COLSPAN="3"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    39
 
ALIGN="center"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    40
 
>SDL Library Documentation</TH
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    41
 
></TR
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    42
 
><TR
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    43
 
><TD
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    44
 
WIDTH="10%"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    45
 
ALIGN="left"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    46
 
VALIGN="bottom"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    47
 
><A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    48
 
HREF="guideinput.html"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    49
 
ACCESSKEY="P"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    50
 
>Prev</A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    51
 
></TD
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    52
 
><TD
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    53
 
WIDTH="80%"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    54
 
ALIGN="center"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    55
 
VALIGN="bottom"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    56
 
>Chapter 3. Input handling</TD
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    57
 
><TD
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    58
 
WIDTH="10%"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    59
 
ALIGN="right"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    60
 
VALIGN="bottom"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    61
 
><A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    62
 
HREF="guideexamples.html"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    63
 
ACCESSKEY="N"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    64
 
>Next</A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    65
 
></TD
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    66
 
></TR
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    67
 
></TABLE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    68
 
><HR
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    69
 
ALIGN="LEFT"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    70
 
WIDTH="100%"></DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    71
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    72
 
CLASS="SECT1"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    73
 
><H1
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    74
 
CLASS="SECT1"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    75
 
><A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    76
 
NAME="GUIDEINPUTKEYBOARD"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    77
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    78
 
>Handling the Keyboard</H1
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    79
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    80
 
CLASS="SECT2"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    81
 
><H2
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    82
 
CLASS="SECT2"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    83
 
><A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    84
 
NAME="AEN271"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    85
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    86
 
>Keyboard Related Structures</H2
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    87
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    88
 
>It should make it a lot easier to understand this tutorial is you are familiar with the data types involved in keyboard access, so I'll explain them first.</P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    89
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    90
 
CLASS="SECT3"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    91
 
><H3
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    92
 
CLASS="SECT3"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    93
 
><A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    94
 
NAME="AEN274"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    95
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    96
 
>SDLKey</H3
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    97
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    98
 
><SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    99
 
CLASS="STRUCTNAME"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   100
 
>SDLKey</SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   101
 
> is an enumerated type defined in SDL/include/SDL_keysym.h and detailed <A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   102
 
HREF="sdlkey.html"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   103
 
>here</A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   104
 
>. Each <SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   105
 
CLASS="STRUCTNAME"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   106
 
>SDLKey</SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   107
 
> symbol represents a key, <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   108
 
CLASS="LITERAL"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   109
 
>SDLK_a</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   110
 
> corresponds to the 'a' key on a keyboard, <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   111
 
CLASS="LITERAL"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   112
 
>SDLK_SPACE</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   113
 
> corresponds to the space bar, and so on.</P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   114
 
></DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   115
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   116
 
CLASS="SECT3"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   117
 
><H3
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   118
 
CLASS="SECT3"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   119
 
><A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   120
 
NAME="AEN282"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   121
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   122
 
>SDLMod</H3
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   123
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   124
 
>SDLMod is an enumerated type, similar to <SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   125
 
CLASS="STRUCTNAME"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   126
 
>SDLKey</SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   127
 
>, however it enumerates keyboard modifiers (Control, Alt, Shift). The full list of modifier symbols is <A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   128
 
HREF="sdlkey.html#SDLMOD"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   129
 
>here</A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   130
 
>. <SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   131
 
CLASS="STRUCTNAME"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   132
 
>SDLMod</SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   133
 
> values can be AND'd together to represent several modifiers.</P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   134
 
></DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   135
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   136
 
CLASS="SECT3"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   137
 
><H3
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   138
 
CLASS="SECT3"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   139
 
><A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   140
 
NAME="AEN288"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   141
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   142
 
>SDL_keysym</H3
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   143
 
><PRE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   144
 
CLASS="PROGRAMLISTING"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   145
 
>typedef struct{
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   146
 
  Uint8 scancode;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   147
 
  SDLKey sym;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   148
 
  SDLMod mod;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   149
 
  Uint16 unicode;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   150
 
} SDL_keysym;</PRE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   151
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   152
 
>The <SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   153
 
CLASS="STRUCTNAME"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   154
 
>SDL_keysym</SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   155
 
> structure describes a key press or a key release. The <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   156
 
CLASS="STRUCTFIELD"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   157
 
><I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   158
 
>scancode</I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   159
 
></TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   160
 
> field is hardware specific and should be ignored unless you know what your doing. The <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   161
 
CLASS="STRUCTFIELD"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   162
 
><I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   163
 
>sym</I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   164
 
></TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   165
 
> field is the <SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   166
 
CLASS="STRUCTNAME"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   167
 
>SDLKey</SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   168
 
> value of the key being pressed or released. The <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   169
 
CLASS="STRUCTFIELD"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   170
 
><I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   171
 
>mod</I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   172
 
></TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   173
 
> field describes the state of the keyboard modifiers at the time the key press or release occurred. So a value of <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   174
 
CLASS="LITERAL"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   175
 
>KMOD_NUM | KMOD_CAPS | KMOD_LSHIFT</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   176
 
> would mean that Numlock, Capslock and the left shift key were all press (or enabled in the case of the lock keys). Finally, the <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   177
 
CLASS="STRUCTFIELD"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   178
 
><I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   179
 
>unicode</I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   180
 
></TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   181
 
> field stores the 16-bit unicode value of the key.</P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   182
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   183
 
CLASS="NOTE"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   184
 
><BLOCKQUOTE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   185
 
CLASS="NOTE"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   186
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   187
 
><B
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   188
 
>Note: </B
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   189
 
>It should be noted and understood that this field is only valid when the <SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   190
 
CLASS="STRUCTNAME"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   191
 
>SDL_keysym</SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   192
 
> is describing a key press, not a key release. Unicode values only make sense on a key press because the unicode value describes an international character and only key presses produce characters. More information on Unicode can be found at <A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   193
 
HREF="http://www.unicode.org"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   194
 
TARGET="_top"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   195
 
>www.unicode.org</A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   196
 
></P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   197
 
></BLOCKQUOTE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   198
 
></DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   199
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   200
 
CLASS="NOTE"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   201
 
><BLOCKQUOTE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   202
 
CLASS="NOTE"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   203
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   204
 
><B
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   205
 
>Note: </B
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   206
 
>Unicode translation must be enabled using the <A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   207
 
HREF="sdlenableunicode.html"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   208
 
><TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   209
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   210
 
>SDL_EnableUNICODE</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   211
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   212
 
> function.</P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   213
 
></BLOCKQUOTE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   214
 
></DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   215
 
></DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   216
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   217
 
CLASS="SECT3"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   218
 
><H3
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   219
 
CLASS="SECT3"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   220
 
><A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   221
 
NAME="AEN307"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   222
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   223
 
>SDL_KeyboardEvent</H3
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   224
 
><PRE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   225
 
CLASS="PROGRAMLISTING"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   226
 
>typedef struct{
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   227
 
  Uint8 type;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   228
 
  Uint8 state;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   229
 
  SDL_keysym keysym;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   230
 
} SDL_KeyboardEvent;</PRE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   231
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   232
 
>The <SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   233
 
CLASS="STRUCTNAME"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   234
 
>SDL_KeyboardEvent</SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   235
 
> describes a keyboard event (obviously). The <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   236
 
CLASS="STRUCTFIELD"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   237
 
><I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   238
 
>key</I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   239
 
></TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   240
 
> member of the <A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   241
 
HREF="sdlevent.html"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   242
 
><SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   243
 
CLASS="STRUCTNAME"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   244
 
>SDL_Event</SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   245
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   246
 
> union is a <SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   247
 
CLASS="STRUCTNAME"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   248
 
>SDL_KeyboardEvent</SPAN
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   249
 
> structure. The <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   250
 
CLASS="STRUCTFIELD"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   251
 
><I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   252
 
>type</I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   253
 
></TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   254
 
> field specifies whether the event is a key release (<TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   255
 
CLASS="LITERAL"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   256
 
>SDL_KEYUP</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   257
 
>) or a key press (<TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   258
 
CLASS="LITERAL"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   259
 
>SDL_KEYDOWN</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   260
 
>) event. The <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   261
 
CLASS="STRUCTFIELD"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   262
 
><I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   263
 
>state</I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   264
 
></TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   265
 
> is largely redundant, it reports the same information as the <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   266
 
CLASS="STRUCTFIELD"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   267
 
><I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   268
 
>type</I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   269
 
></TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   270
 
> field but uses different values (<TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   271
 
CLASS="LITERAL"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   272
 
>SDL_RELEASED</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   273
 
> and <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   274
 
CLASS="LITERAL"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   275
 
>SDL_PRESSED</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   276
 
>). The <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   277
 
CLASS="STRUCTFIELD"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   278
 
><I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   279
 
>keysym</I
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   280
 
></TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   281
 
> contains information of the key press or release that this event represents (see above).</P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   282
 
></DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   283
 
></DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   284
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   285
 
CLASS="SECT2"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   286
 
><H2
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   287
 
CLASS="SECT2"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   288
 
><A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   289
 
NAME="AEN324"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   290
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   291
 
>Reading Keyboard Events</H2
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   292
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   293
 
>Reading keybaord events from the event queue is quite simple (the event queue and using it is described <A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   294
 
HREF="sdlevent.html"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   295
 
>here</A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   296
 
>). We read events using <A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   297
 
HREF="sdlpollevent.html"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   298
 
><TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   299
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   300
 
>SDL_PollEvent</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   301
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   302
 
> in a <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   303
 
CLASS="LITERAL"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   304
 
>while()</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   305
 
> loop and check for <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   306
 
CLASS="LITERAL"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   307
 
>SDL_KEYUP</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   308
 
> and <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   309
 
CLASS="LITERAL"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   310
 
>SDL_KEYDOWN</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   311
 
> events using a <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   312
 
CLASS="LITERAL"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   313
 
>switch</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   314
 
> statement, like so:</P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   315
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   316
 
CLASS="EXAMPLE"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   317
 
><A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   318
 
NAME="AEN334"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   319
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   320
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   321
 
><B
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   322
 
>Example 3-10. Reading Keyboard Events</B
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   323
 
></P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   324
 
><PRE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   325
 
CLASS="PROGRAMLISTING"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   326
 
>  SDL_Event event;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   327
 
  .
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   328
 
  .
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   329
 
  /* Poll for events. SDL_PollEvent() returns 0 when there are no  */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   330
 
  /* more events on the event queue, our while loop will exit when */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   331
 
  /* that occurs.                                                  */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   332
 
  while( SDL_PollEvent( &#38;event ) ){
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   333
 
    /* We are only worried about SDL_KEYDOWN and SDL_KEYUP events */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   334
 
    switch( event.type ){
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   335
 
      case SDL_KEYDOWN:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   336
 
        printf( "Key press detected\n" );
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   337
 
        break;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   338
 












2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   339


      case SDL_KEYUP:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   340


        printf( "Key release detected\n" );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   341


        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   342














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   343


      default:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   344


        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   345


    }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   346


  }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   347


  .













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   348


  .</PRE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   349


></DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   350


><P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   351


>This is a very basic example. No information about the key press or release is interpreted. We will explore the other extreme out our first full example below - reporting all available information about a keyboard event.</P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   352


></DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   353


><DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   354


CLASS="SECT2"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   355


><H2













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   356


CLASS="SECT2"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   357


><A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   358


NAME="AEN338"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   359


></A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   360


>A More Detailed Look</H2













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   361


><P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   362


>Before we can read events SDL must be initialised with <A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   363


HREF="sdlinit.html"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   364


><TT













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   365


CLASS="FUNCTION"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   366


>SDL_Init</TT













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   367


></A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   368


> and a video mode must be set using <A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   369


HREF="sdlsetvideomode.html"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   370


><TT













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   371


CLASS="FUNCTION"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   372


>SDL_SetVideoMode</TT













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   373


></A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   374


>. There are, however, two other functions we must use to obtain all the information required. We must enable unicode translation by calling <TT













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   375


CLASS="FUNCTION"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   376


>SDL_EnableUNICODE(1)</TT













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   377


> and we must convert <SPAN













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   378


CLASS="STRUCTNAME"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   379


>SDLKey</SPAN













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   380


> values into something printable, using <A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   381


HREF="sdlgetkeyname.html"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   382


><TT













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   383


CLASS="FUNCTION"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   384


>SDL_GetKeyName</TT













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   385


></A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   386


></P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   387


><DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   388


CLASS="NOTE"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   389


><BLOCKQUOTE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   390


CLASS="NOTE"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   391


><P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   392


><B













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   393


>Note: </B













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   394


>It is useful to note that unicode values &#60; 0x80 translate directly a characters ASCII value. THis is used in the example below</P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   395


></BLOCKQUOTE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   396


></DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   397


><DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   398


CLASS="EXAMPLE"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   399


><A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   400


NAME="AEN351"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   401


></A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   402


><P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   403


><B













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   404


>Example 3-11. Interpreting Key Event Information</B













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   405


></P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   406


><PRE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   407


CLASS="PROGRAMLISTING"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   408


>&#13;    #include "SDL.h"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   409














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   410


    /* Function Prototypes */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   411


    void PrintKeyInfo( SDL_KeyboardEvent *key );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   412


    void PrintModifiers( SDLMod mod );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   413














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   414


    /* main */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   415


    int main( int argc, char *argv[] ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   416


        













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   417


        SDL_Event event;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   418


        int quit = 0;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   419


        













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   420


        /* Initialise SDL */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   421


        if( SDL_Init( SDL_INIT_VIDEO ) &#60; 0){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   422


            fprintf( stderr, "Could not initialise SDL: %s\n", SDL_GetError() );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   423


            exit( -1 );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   424


        }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   425














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   426


        /* Set a video mode */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   427


        if( !SDL_SetVideoMode( 320, 200, 0, 0 ) ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   428


            fprintf( stderr, "Could not set video mode: %s\n", SDL_GetError() );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   429


            SDL_Quit();













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   430


            exit( -1 );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   431


        }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   432














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   433


        /* Enable Unicode translation */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   434


        SDL_EnableUNICODE( 1 );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   435














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   436


        /* Loop until an SDL_QUIT event is found */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   437


        while( !quit ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   438














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   439


            /* Poll for events */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   440


            while( SDL_PollEvent( &#38;event ) ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   441


                













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   442


                switch( event.type ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   443


                    /* Keyboard event */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   444


                    /* Pass the event data onto PrintKeyInfo() */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   445


                    case SDL_KEYDOWN:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   446


                    case SDL_KEYUP:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   447


                        PrintKeyInfo( &#38;event.key );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   448


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   449














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   450


                    /* SDL_QUIT event (window close) */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   451


                    case SDL_QUIT:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   452


                        quit = 1;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   453


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   454














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   455


                    default:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   456


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   457


                }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   458














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   459


            }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   460














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   461


        }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   462














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   463


        /* Clean up */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   464


        SDL_Quit();













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   465


        exit( 0 );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   466


    }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   467














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   468


    /* Print all information about a key event */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   469


    void PrintKeyInfo( SDL_KeyboardEvent *key ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   470


        /* Is it a release or a press? */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   471


        if( key-&#62;type == SDL_KEYUP )













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   472


            printf( "Release:- " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   473


        else













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   474


            printf( "Press:- " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   475














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   476


        /* Print the hardware scancode first */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   477


        printf( "Scancode: 0x%02X", key-&#62;keysym.scancode );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   478


        /* Print the name of the key */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   479


        printf( ", Name: %s", SDL_GetKeyName( key-&#62;keysym.sym ) );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   480


        /* We want to print the unicode info, but we need to make */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   481


        /* sure its a press event first (remember, release events */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   482


        /* don't have unicode info                                */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   483


        if( key-&#62;type == SDL_KEYDOWN ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   484


            /* If the Unicode value is less than 0x80 then the    */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   485


            /* unicode value can be used to get a printable       */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   486


            /* representation of the key, using (char)unicode.    */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   487


            printf(", Unicode: " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   488


            if( key-&#62;keysym.unicode &#60; 0x80 &#38;&#38; key-&#62;keysym.unicode &#62; 0 ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   489


                printf( "%c (0x%04X)", (char)key-&#62;keysym.unicode,













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   490


                        key-&#62;keysym.unicode );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   491


            }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   492


            else{













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   493


                printf( "? (0x%04X)", key-&#62;keysym.unicode );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   494


            }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   495


        }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   496


        printf( "\n" );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   497


        /* Print modifier info */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   498


        PrintModifiers( key-&#62;keysym.mod );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   499


    }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   500














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   501


    /* Print modifier info */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   502


    void PrintModifiers( SDLMod mod ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   503


        printf( "Modifers: " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   504














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   505


        /* If there are none then say so and return */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   506


        if( mod == KMOD_NONE ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   507


            printf( "None\n" );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   508


            return;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   509


        }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   510














2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   511


        /* Check for the presence of each SDLMod value */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   512


        /* This looks messy, but there really isn't    */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   513


        /* a clearer way.                              */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   514


        if( mod &#38; KMOD_NUM ) printf( "NUMLOCK " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   515


        if( mod &#38; KMOD_CAPS ) printf( "CAPSLOCK " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   516


        if( mod &#38; KMOD_LCTRL ) printf( "LCTRL " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   517


        if( mod &#38; KMOD_RCTRL ) printf( "RCTRL " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   518


        if( mod &#38; KMOD_RSHIFT ) printf( "RSHIFT " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   519


        if( mod &#38; KMOD_LSHIFT ) printf( "LSHIFT " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   520


        if( mod &#38; KMOD_RALT ) printf( "RALT " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   521


        if( mod &#38; KMOD_LALT ) printf( "LALT " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   522


        if( mod &#38; KMOD_CTRL ) printf( "CTRL " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   523


        if( mod &#38; KMOD_SHIFT ) printf( "SHIFT " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   524


        if( mod &#38; KMOD_ALT ) printf( "ALT " );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   525


        printf( "\n" );













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   526


    }</PRE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   527


></DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   528


></DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   529


><DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   530


CLASS="SECT2"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   531


><H2













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   532


CLASS="SECT2"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   533


><A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   534


NAME="AEN354"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   535


></A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   536


>Game-type Input</H2













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   537


><P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   538


>I have found that people using keyboard events for games and other interactive applications don't always understand one fundemental point.</P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   539


><A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   540


NAME="AEN357"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   541


></A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   542


><BLOCKQUOTE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   543


CLASS="BLOCKQUOTE"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   544


><P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   545


>Keyboard events <SPAN













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   546


CLASS="emphasis"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   547


><I













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   548


CLASS="EMPHASIS"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   549


>only</I













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   550


></SPAN













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   551


> take place when a keys state changes from being unpressed to pressed, and vice versa.</P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   552


></BLOCKQUOTE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   553


><P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   554


>Imagine you have an image of an alien that you wish to move around using the cursor keys: when you pressed the left arrow key you want him to slide over to the left, and when you press the down key you want him to slide down the screen. Examine the following code; it highlights an error that many people have made.













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   555


<PRE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   556


CLASS="PROGRAMLISTING"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   557


>    /* Alien screen coordinates */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   558


    int alien_x=0, alien_y=0;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   559


    .













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   560


    .













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   561


    /* Initialise SDL and video modes and all that */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   562


    .













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   563


    /* Main game loop */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   564


    /* Check for events */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   565


    while( SDL_PollEvent( &#38;event ) ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   566


        switch( event.type ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   567


            /* Look for a keypress */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   568


            case SDL_KEYDOWN:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   569


                /* Check the SDLKey values and move change the coords */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   570


                switch( event.key.keysym.sym ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   571


                    case SDLK_LEFT:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   572


                        alien_x -= 1;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   573


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   574


                    case SDLK_RIGHT:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   575


                        alien_x += 1;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   576


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   577


                    case SDLK_UP:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   578


                        alien_y -= 1;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   579


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   580


                    case SDLK_DOWN:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   581


                        alien_y += 1;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   582


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   583


                    default:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   584


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   585


                }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   586


            }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   587


        }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   588


    }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   589


    .













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   590


    .</PRE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   591


>













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   592


At first glance you may think this is a perfectly reasonable piece of code for the task, but it isn't. Like I said keyboard events only occur when a key changes state, so the user would have to press and release the left cursor key 100 times to move the alien 100 pixels to the left.</P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   593


><P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   594


>To get around this problem we must not use the events to change the position of the alien, we use the events to set flags which are then used in a seperate section of code to move the alien. Something like this:</P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   595


><DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   596


CLASS="EXAMPLE"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   597


><A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   598


NAME="AEN363"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   599


></A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   600


><P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   601


><B













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   602


>Example 3-12. Proper Game Movement</B













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   603


></P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   604


><PRE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   605


CLASS="PROGRAMLISTING"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   606


>    /* Alien screen coordinates */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   607


    int alien_x=0, alien_y=0;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   608


    int alien_xvel=0, alien_yvel=0;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   609


    .













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   610


    .













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   611


    /* Initialise SDL and video modes and all that */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   612


    .













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   613


    /* Main game loop */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   614


    /* Check for events */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   615


    while( SDL_PollEvent( &#38;event ) ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   616


        switch( event.type ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   617


            /* Look for a keypress */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   618


            case SDL_KEYDOWN:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   619


                /* Check the SDLKey values and move change the coords */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   620


                switch( event.key.keysym.sym ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   621


                    case SDLK_LEFT:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   622


                        alien_xvel = -1;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   623


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   624


                    case SDLK_RIGHT:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   625


                        alien_xvel =  1;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   626


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   627


                    case SDLK_UP:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   628


                        alien_yvel = -1;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   629


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   630


                    case SDLK_DOWN:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   631


                        alien_yvel =  1;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   632


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   633


                    default:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   634


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   635


                }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   636


                break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   637


            /* We must also use the SDL_KEYUP events to zero the x */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   638


            /* and y velocity variables. But we must also be       */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   639


            /* careful not to zero the velocities when we shouldn't*/













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   640


            case SDL_KEYUP:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   641


                switch( event.key.keysym.sym ){













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   642


                    case SDLK_LEFT:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   643


                        /* We check to make sure the alien is moving */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   644


                        /* to the left. If it is then we zero the    */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   645


                        /* velocity. If the alien is moving to the   */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   646


                        /* right then the right key is still press   */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   647


                        /* so we don't tocuh the velocity            */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   648


                        if( alien_xvel &#60; 0 )













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   649


                            alien_xvel = 0;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   650


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   651


                    case SDLK_RIGHT:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   652


                        if( alien_xvel &#62; 0 )













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   653


                            alien_xvel = 0;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   654


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   655


                    case SDLK_UP:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   656


                        if( alien_yvel &#60; 0 )













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   657


                            alien_yvel = 0;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   658


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   659


                    case SDLK_DOWN:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   660


                        if( alien_yvel &#62; 0 )













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   661


                            alien_yvel = 0;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   662


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   663


                    default:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   664


                        break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   665


                }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   666


                break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   667


            













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   668


            default:













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   669


                break;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   670


        }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   671


    }













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   672


    .













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   673


    .













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   674


    /* Update the alien position */













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   675


    alien_x += alien_xvel;













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   676


    alien_y += alien_yvel;</PRE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   677


></DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   678


><P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   679


>As can be seen, we use two extra variables, alien_xvel and alien_yvel, which represent the motion of the ship, it is these variables that we update when we detect keypresses and releases.</P













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   680


></DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   681


></DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   682


><DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   683


CLASS="NAVFOOTER"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   684


><HR













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   685


ALIGN="LEFT"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   686


WIDTH="100%"><TABLE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   687


SUMMARY="Footer navigation table"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   688


WIDTH="100%"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   689


BORDER="0"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   690


CELLPADDING="0"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   691


CELLSPACING="0"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   692


><TR













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   693


><TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   694


WIDTH="33%"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   695


ALIGN="left"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   696


VALIGN="top"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   697


><A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   698


HREF="guideinput.html"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   699


ACCESSKEY="P"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   700


>Prev</A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   701


></TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   702


><TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   703


WIDTH="34%"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   704


ALIGN="center"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   705


VALIGN="top"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   706


><A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   707


HREF="index.html"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   708


ACCESSKEY="H"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   709


>Home</A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   710


></TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   711


><TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   712


WIDTH="33%"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   713


ALIGN="right"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   714


VALIGN="top"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   715


><A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   716


HREF="guideexamples.html"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   717


ACCESSKEY="N"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   718


>Next</A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   719


></TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   720


></TR













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   721


><TR













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   722


><TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   723


WIDTH="33%"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   724


ALIGN="left"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   725


VALIGN="top"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   726


>Input handling</TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   727


><TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   728


WIDTH="34%"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   729


ALIGN="center"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   730


VALIGN="top"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   731


><A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   732


HREF="guideinput.html"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   733


ACCESSKEY="U"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   734


>Up</A













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   735


></TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   736


><TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   737


WIDTH="33%"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   738


ALIGN="right"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   739


VALIGN="top"













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   740


>Examples</TD













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   741


></TR













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   742


></TABLE













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   743


></DIV













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   744


></BODY













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   745


></HTML













2fb8b9db1c86
Initial QEMU (symbian-qemu-0.9.1-12) import



martin.trojer@nokia.com


parents: 

diff
changeset




   746


>














FCL/interim/QEMU