Mercurial Mercurial > oss > MCL > sf > adapt > 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/guidebasicsinit.html
author John Kern <johnk@symbian.org>
Tue, 08 Dec 2009 11:07:49 -0800
changeset 23 8374da225e88
parent 1 2fb8b9db1c86
permissions -rw-r--r--
fix for S^2 builds
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
 
>Initializing SDL</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="The Basics"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    14
 
HREF="guidethebasics.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="The Basics"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    17
 
HREF="guidethebasics.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="Graphics and Video"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    20
 
HREF="guidevideo.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="guidethebasics.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 1. The Basics</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="guidevideo.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="GUIDEBASICSINIT"
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
 
>Initializing SDL</H1
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    79
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    80
 
>SDL is composed of eight subsystems - Audio, CDROM, Event Handling, File I/O, Joystick Handling, Threading, Timers and Video. Before you can use any of these subsystems they must be initialized by calling <A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    81
 
HREF="sdlinit.html"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    82
 
><TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    83
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    84
 
>SDL_Init</TT
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
 
> (or <A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    87
 
HREF="sdlinitsubsystem.html"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    88
 
><TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    89
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    90
 
>SDL_InitSubSystem</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    91
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    92
 
>). <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    93
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    94
 
>SDL_Init</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    95
 
> must be called before any other SDL function. It automatically initializes the Event Handling, File I/O and Threading subsystems and it takes a parameter specifying which other subsystems to initialize. So, to initialize the default subsystems and the Video subsystems you would call:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    96
 
<PRE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    97
 
CLASS="PROGRAMLISTING"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    98
 
>    SDL_Init ( SDL_INIT_VIDEO );</PRE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
    99
 
>
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   100
 
To initialize the default subsystems, the Video subsystem and the Timers subsystem you would call:
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   101
 
<PRE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   102
 
CLASS="PROGRAMLISTING"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   103
 
>    SDL_Init ( SDL_INIT_VIDEO | SDL_INIT_TIMER );</PRE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   104
 
></P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   105
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   106
 
><TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   107
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   108
 
>SDL_Init</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   109
 
> is complemented by <A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   110
 
HREF="sdlquit.html"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   111
 
><TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   112
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   113
 
>SDL_Quit</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   114
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   115
 
> (and <A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   116
 
HREF="sdlquitsubsystem.html"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   117
 
><TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   118
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   119
 
>SDL_QuitSubSystem</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   120
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   121
 
>). <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   122
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   123
 
>SDL_Quit</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   124
 
> shuts down all subsystems, including the default ones. It should always be called before a SDL application exits.</P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   125
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   126
 
>With <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   127
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   128
 
>SDL_Init</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   129
 
> and <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   130
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   131
 
>SDL_Quit</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   132
 
> firmly embedded in your programmers toolkit you can write your first and most basic SDL application. However, we must be prepare to handle errors. Many SDL functions return a value and indicates whether the function has succeeded or failed, <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   133
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   134
 
>SDL_Init</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   135
 
>, for instance, returns -1 if it could not initialize a subsystem. SDL provides a useful facility that allows you to determine exactly what the problem was, every time an error occurs within SDL an error message is stored which can be retrieved using <TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   136
 
CLASS="FUNCTION"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   137
 
>SDL_GetError</TT
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   138
 
>. Use this often, you can never know too much about an error.</P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   139
 
><DIV
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   140
 
CLASS="EXAMPLE"
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
 
NAME="AEN60"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   143
 
></A
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   144
 
><P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   145
 
><B
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   146
 
>Example 1-1. Initializing SDL</B
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   147
 
></P
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   148
 
><PRE
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   149
 
CLASS="PROGRAMLISTING"
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   150
 
>#include "SDL.h"   /* All SDL App's need this */
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   151
 
#include &#60;stdio.h&#62;
2fb8b9db1c86 Initial QEMU (symbian-qemu-0.9.1-12) import
martin.trojer@nokia.com
parents:
diff changeset 
   152
 












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



martin.trojer@nokia.com


parents: 

diff
changeset




   153


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













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



martin.trojer@nokia.com


parents: 

diff
changeset




   154


    













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



martin.trojer@nokia.com


parents: 

diff
changeset




   155


    printf("Initializing SDL.\n");













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



martin.trojer@nokia.com


parents: 

diff
changeset




   156


    













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



martin.trojer@nokia.com


parents: 

diff
changeset




   157


    /* Initialize defaults, Video and Audio */













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



martin.trojer@nokia.com


parents: 

diff
changeset




   158


    if((SDL_Init(SDL_INIT_VIDEO|SDL_INIT_AUDIO)==-1)) { 













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



martin.trojer@nokia.com


parents: 

diff
changeset




   159


        printf("Could not initialize SDL: %s.\n", SDL_GetError());













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



martin.trojer@nokia.com


parents: 

diff
changeset




   160


        exit(-1);













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



martin.trojer@nokia.com


parents: 

diff
changeset




   161


    }













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



martin.trojer@nokia.com


parents: 

diff
changeset




   162














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



martin.trojer@nokia.com


parents: 

diff
changeset




   163


    printf("SDL initialized.\n");













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



martin.trojer@nokia.com


parents: 

diff
changeset




   164














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



martin.trojer@nokia.com


parents: 

diff
changeset




   165


    printf("Quiting SDL.\n");













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



martin.trojer@nokia.com


parents: 

diff
changeset




   166


    













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



martin.trojer@nokia.com


parents: 

diff
changeset




   167


    /* Shutdown all subsystems */













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



martin.trojer@nokia.com


parents: 

diff
changeset




   168


    SDL_Quit();













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



martin.trojer@nokia.com


parents: 

diff
changeset




   169


    













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



martin.trojer@nokia.com


parents: 

diff
changeset




   170


    printf("Quiting....\n");













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



martin.trojer@nokia.com


parents: 

diff
changeset




   171














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



martin.trojer@nokia.com


parents: 

diff
changeset




   172


    exit(0);













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



martin.trojer@nokia.com


parents: 

diff
changeset




   173


}&#13;</PRE













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



martin.trojer@nokia.com


parents: 

diff
changeset




   174


></DIV













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



martin.trojer@nokia.com


parents: 

diff
changeset




   175


></DIV













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



martin.trojer@nokia.com


parents: 

diff
changeset




   176


><DIV













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



martin.trojer@nokia.com


parents: 

diff
changeset




   177


CLASS="NAVFOOTER"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   178


><HR













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



martin.trojer@nokia.com


parents: 

diff
changeset




   179


ALIGN="LEFT"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   180


WIDTH="100%"><TABLE













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



martin.trojer@nokia.com


parents: 

diff
changeset




   181


SUMMARY="Footer navigation table"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   182


WIDTH="100%"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   183


BORDER="0"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   184


CELLPADDING="0"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   185


CELLSPACING="0"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   186


><TR













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



martin.trojer@nokia.com


parents: 

diff
changeset




   187


><TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   188


WIDTH="33%"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   189


ALIGN="left"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   190


VALIGN="top"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   191


><A













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



martin.trojer@nokia.com


parents: 

diff
changeset




   192


HREF="guidethebasics.html"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   193


ACCESSKEY="P"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   194


>Prev</A













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



martin.trojer@nokia.com


parents: 

diff
changeset




   195


></TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   196


><TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   197


WIDTH="34%"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   198


ALIGN="center"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   199


VALIGN="top"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   200


><A













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



martin.trojer@nokia.com


parents: 

diff
changeset




   201


HREF="index.html"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   202


ACCESSKEY="H"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   203


>Home</A













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



martin.trojer@nokia.com


parents: 

diff
changeset




   204


></TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   205


><TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   206


WIDTH="33%"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   207


ALIGN="right"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   208


VALIGN="top"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   209


><A













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



martin.trojer@nokia.com


parents: 

diff
changeset




   210


HREF="guidevideo.html"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   211


ACCESSKEY="N"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   212


>Next</A













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



martin.trojer@nokia.com


parents: 

diff
changeset




   213


></TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   214


></TR













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



martin.trojer@nokia.com


parents: 

diff
changeset




   215


><TR













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



martin.trojer@nokia.com


parents: 

diff
changeset




   216


><TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   217


WIDTH="33%"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   218


ALIGN="left"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   219


VALIGN="top"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   220


>The Basics</TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   221


><TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   222


WIDTH="34%"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   223


ALIGN="center"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   224


VALIGN="top"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   225


><A













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



martin.trojer@nokia.com


parents: 

diff
changeset




   226


HREF="guidethebasics.html"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   227


ACCESSKEY="U"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   228


>Up</A













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



martin.trojer@nokia.com


parents: 

diff
changeset




   229


></TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   230


><TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   231


WIDTH="33%"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   232


ALIGN="right"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   233


VALIGN="top"













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



martin.trojer@nokia.com


parents: 

diff
changeset




   234


>Graphics and Video</TD













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



martin.trojer@nokia.com


parents: 

diff
changeset




   235


></TR













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



martin.trojer@nokia.com


parents: 

diff
changeset




   236


></TABLE













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



martin.trojer@nokia.com


parents: 

diff
changeset




   237


></DIV













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



martin.trojer@nokia.com


parents: 

diff
changeset




   238


></BODY













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



martin.trojer@nokia.com


parents: 

diff
changeset




   239


></HTML













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



martin.trojer@nokia.com


parents: 

diff
changeset




   240


>














MCL/sf/adapt/qemu