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 johnathan.white@2718R8BGH51.accenture.com
Mon, 08 Mar 2010 18:45:03 +0000
changeset 46 b6935a90ca64
parent 1 2fb8b9db1c86
permissions -rw-r--r--
Modify framebuffer and NGA framebuffer to read screen size from board model dtb file. Optimise memory usuage of frame buffer Add example minigui application with hooks to profiler (which writes results to S:\). Modified NGA framebuffer to run its own dfc queue at high priority
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