comparison docs/html/guidevideo.html @ 803:355632dca928

Updated SDL HTML documentation
author Sam Lantinga <slouken@libsdl.org>
date Tue, 10 Feb 2004 15:15:40 +0000
parents 55f1f1b3e27d
children
comparison
equal deleted inserted replaced
802:3c609d54f100 803:355632dca928
2 ><HEAD 2 ><HEAD
3 ><TITLE 3 ><TITLE
4 >Graphics and Video</TITLE 4 >Graphics and Video</TITLE
5 ><META 5 ><META
6 NAME="GENERATOR" 6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64 7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
8 "><LINK 8 "><LINK
9 REL="HOME" 9 REL="HOME"
10 TITLE="SDL Library Documentation" 10 TITLE="SDL Library Documentation"
11 HREF="index.html"><LINK 11 HREF="index.html"><LINK
12 REL="UP" 12 REL="UP"
26 VLINK="#551a8b" 26 VLINK="#551a8b"
27 ALINK="#ff0000" 27 ALINK="#ff0000"
28 ><DIV 28 ><DIV
29 CLASS="NAVHEADER" 29 CLASS="NAVHEADER"
30 ><TABLE 30 ><TABLE
31 SUMMARY="Header navigation table"
31 WIDTH="100%" 32 WIDTH="100%"
32 BORDER="0" 33 BORDER="0"
33 CELLPADDING="0" 34 CELLPADDING="0"
34 CELLSPACING="0" 35 CELLSPACING="0"
35 ><TR 36 ><TR
43 WIDTH="10%" 44 WIDTH="10%"
44 ALIGN="left" 45 ALIGN="left"
45 VALIGN="bottom" 46 VALIGN="bottom"
46 ><A 47 ><A
47 HREF="guidebasicsinit.html" 48 HREF="guidebasicsinit.html"
49 ACCESSKEY="P"
48 >Prev</A 50 >Prev</A
49 ></TD 51 ></TD
50 ><TD 52 ><TD
51 WIDTH="80%" 53 WIDTH="80%"
52 ALIGN="center" 54 ALIGN="center"
56 WIDTH="10%" 58 WIDTH="10%"
57 ALIGN="right" 59 ALIGN="right"
58 VALIGN="bottom" 60 VALIGN="bottom"
59 ><A 61 ><A
60 HREF="guidevideoopengl.html" 62 HREF="guidevideoopengl.html"
63 ACCESSKEY="N"
61 >Next</A 64 >Next</A
62 ></TD 65 ></TD
63 ></TR 66 ></TR
64 ></TABLE 67 ></TABLE
65 ><HR 68 ><HR
68 ><DIV 71 ><DIV
69 CLASS="CHAPTER" 72 CLASS="CHAPTER"
70 ><H1 73 ><H1
71 ><A 74 ><A
72 NAME="GUIDEVIDEO" 75 NAME="GUIDEVIDEO"
73 >Chapter 2. Graphics and Video</A 76 ></A
74 ></H1 77 >Chapter 2. Graphics and Video</H1
75 ><DIV 78 ><DIV
76 CLASS="TOC" 79 CLASS="TOC"
77 ><DL 80 ><DL
78 ><DT 81 ><DT
79 ><B 82 ><B
95 CLASS="SECT1" 98 CLASS="SECT1"
96 ><H1 99 ><H1
97 CLASS="SECT1" 100 CLASS="SECT1"
98 ><A 101 ><A
99 NAME="GUIDEVIDEOINTRO" 102 NAME="GUIDEVIDEOINTRO"
100 >Introduction to SDL Video</A 103 ></A
101 ></H1 104 >Introduction to SDL Video</H1
102 ><P 105 ><P
103 >Video is probably the most common thing that SDL is used for, and 106 >Video is probably the most common thing that SDL is used for, and
104 so it has the most complete subsystem. Here are a few 107 so it has the most complete subsystem. Here are a few
105 examples to demonstrate the basics.</P 108 examples to demonstrate the basics.</P
106 ><DIV 109 ><DIV
107 CLASS="SECT2" 110 CLASS="SECT2"
108 ><H2 111 ><H2
109 CLASS="SECT2" 112 CLASS="SECT2"
110 ><A 113 ><A
111 NAME="AEN68" 114 NAME="AEN68"
112 >Initializing the Video Display</A 115 ></A
113 ></H2 116 >Initializing the Video Display</H2
114 ><P 117 ><P
115 >This is what almost all SDL programs have to do in one way or 118 >This is what almost all SDL programs have to do in one way or
116 another.</P 119 another.</P
117 ><DIV 120 ><DIV
118 CLASS="EXAMPLE" 121 CLASS="EXAMPLE"
153 CLASS="SECT2" 156 CLASS="SECT2"
154 ><H2 157 ><H2
155 CLASS="SECT2" 158 CLASS="SECT2"
156 ><A 159 ><A
157 NAME="AEN74" 160 NAME="AEN74"
158 >Initializing the Best Video Mode</A 161 ></A
159 ></H2 162 >Initializing the Best Video Mode</H2
160 ><P 163 ><P
161 >If you have a preference for a certain pixel depth but will accept any 164 >If you have a preference for a certain pixel depth but will accept any
162 other, use SDL_SetVideoMode with SDL_ANYFORMAT as below. You can also 165 other, use SDL_SetVideoMode with SDL_ANYFORMAT as below. You can also
163 use SDL_VideoModeOK() to find the native video mode that is closest to 166 use SDL_VideoModeOK() to find the native video mode that is closest to
164 the mode you request.</P 167 the mode you request.</P
188 CLASS="SECT2" 191 CLASS="SECT2"
189 ><H2 192 ><H2
190 CLASS="SECT2" 193 CLASS="SECT2"
191 ><A 194 ><A
192 NAME="AEN80" 195 NAME="AEN80"
193 >Loading and Displaying a BMP File</A 196 ></A
194 ></H2 197 >Loading and Displaying a BMP File</H2
195 ><P 198 ><P
196 >The following function loads and displays a BMP file given as 199 >The following function loads and displays a BMP file given as
197 argument, once SDL is initialised and a video mode has been set.</P 200 argument, once SDL is initialised and a video mode has been set.</P
198 ><DIV 201 ><DIV
199 CLASS="EXAMPLE" 202 CLASS="EXAMPLE"
242 CLASS="SECT2" 245 CLASS="SECT2"
243 ><H2 246 ><H2
244 CLASS="SECT2" 247 CLASS="SECT2"
245 ><A 248 ><A
246 NAME="AEN86" 249 NAME="AEN86"
247 >Drawing Directly to the Display</A 250 ></A
248 ></H2 251 >Drawing Directly to the Display</H2
249 ><P 252 ><P
250 >The following two functions can be used to get and set single 253 >The following two functions can be used to get and set single
251 pixels of a surface. They are carefully written to work with any depth 254 pixels of a surface. They are carefully written to work with any depth
252 currently supported by SDL. Remember to lock the surface before 255 currently supported by SDL. Remember to lock the surface before
253 calling them, and to unlock it before calling any other SDL 256 calling them, and to unlock it before calling any other SDL
396 ><DIV 399 ><DIV
397 CLASS="NAVFOOTER" 400 CLASS="NAVFOOTER"
398 ><HR 401 ><HR
399 ALIGN="LEFT" 402 ALIGN="LEFT"
400 WIDTH="100%"><TABLE 403 WIDTH="100%"><TABLE
404 SUMMARY="Footer navigation table"
401 WIDTH="100%" 405 WIDTH="100%"
402 BORDER="0" 406 BORDER="0"
403 CELLPADDING="0" 407 CELLPADDING="0"
404 CELLSPACING="0" 408 CELLSPACING="0"
405 ><TR 409 ><TR
407 WIDTH="33%" 411 WIDTH="33%"
408 ALIGN="left" 412 ALIGN="left"
409 VALIGN="top" 413 VALIGN="top"
410 ><A 414 ><A
411 HREF="guidebasicsinit.html" 415 HREF="guidebasicsinit.html"
416 ACCESSKEY="P"
412 >Prev</A 417 >Prev</A
413 ></TD 418 ></TD
414 ><TD 419 ><TD
415 WIDTH="34%" 420 WIDTH="34%"
416 ALIGN="center" 421 ALIGN="center"
417 VALIGN="top" 422 VALIGN="top"
418 ><A 423 ><A
419 HREF="index.html" 424 HREF="index.html"
425 ACCESSKEY="H"
420 >Home</A 426 >Home</A
421 ></TD 427 ></TD
422 ><TD 428 ><TD
423 WIDTH="33%" 429 WIDTH="33%"
424 ALIGN="right" 430 ALIGN="right"
425 VALIGN="top" 431 VALIGN="top"
426 ><A 432 ><A
427 HREF="guidevideoopengl.html" 433 HREF="guidevideoopengl.html"
434 ACCESSKEY="N"
428 >Next</A 435 >Next</A
429 ></TD 436 ></TD
430 ></TR 437 ></TR
431 ><TR 438 ><TR
432 ><TD 439 ><TD
438 WIDTH="34%" 445 WIDTH="34%"
439 ALIGN="center" 446 ALIGN="center"
440 VALIGN="top" 447 VALIGN="top"
441 ><A 448 ><A
442 HREF="guide.html" 449 HREF="guide.html"
450 ACCESSKEY="U"
443 >Up</A 451 >Up</A
444 ></TD 452 ></TD
445 ><TD 453 ><TD
446 WIDTH="33%" 454 WIDTH="33%"
447 ALIGN="right" 455 ALIGN="right"