sdl-ios-xcode: docs/html/guidevideoopengl.html annotate

annotate docs/html/guidevideoopengl.html @ 1621:f12379c41042

Fixes bug #195: The proper name of Apple's operating system is "Mac OS X" not "MacOS X", as can bee seen in many places, for example http://www.apple.com/macosx/). This contrasts the naming of the old operating system, which was called "MacOS" and today is often refered to as "MacOS Classic". The attached patches fixes the misuse of the name "MacOS X" in both the SDL12 and sdlweb CVS modules.

author	Sam Lantinga <slouken@libsdl.org>
date	Thu, 13 Apr 2006 13:08:26 +0000
parents	355632dca928
children

rev	line source
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	1 <HTML
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	2 ><HEAD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	3 ><TITLE
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	4 >Using OpenGL With SDL</TITLE
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	5 ><META
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	6 NAME="GENERATOR"
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	8 "><LINK
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	9 REL="HOME"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	10 TITLE="SDL Library Documentation"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	11 HREF="index.html"><LINK
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	12 REL="UP"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	13 TITLE="Graphics and Video"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	14 HREF="guidevideo.html"><LINK
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	15 REL="PREVIOUS"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	16 TITLE="Graphics and Video"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	17 HREF="guidevideo.html"><LINK
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	18 REL="NEXT"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	19 TITLE="Input handling"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	20 HREF="guideinput.html"></HEAD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	21 ><BODY
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	22 CLASS="SECT1"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	23 BGCOLOR="#FFF8DC"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	24 TEXT="#000000"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	25 LINK="#0000ee"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	26 VLINK="#551a8b"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	27 ALINK="#ff0000"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	28 ><DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	29 CLASS="NAVHEADER"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	30 ><TABLE
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	31 SUMMARY="Header navigation table"
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	32 WIDTH="100%"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	33 BORDER="0"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	34 CELLPADDING="0"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	35 CELLSPACING="0"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	36 ><TR
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	37 ><TH
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	38 COLSPAN="3"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	39 ALIGN="center"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	40 >SDL Library Documentation</TH
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	41 ></TR
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	42 ><TR
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	43 ><TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	44 WIDTH="10%"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	45 ALIGN="left"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	46 VALIGN="bottom"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	47 ><A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	48 HREF="guidevideo.html"
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	49 ACCESSKEY="P"
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	50 >Prev</A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	51 ></TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	52 ><TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	53 WIDTH="80%"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	54 ALIGN="center"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	55 VALIGN="bottom"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	56 >Chapter 2. Graphics and Video</TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	57 ><TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	58 WIDTH="10%"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	59 ALIGN="right"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	60 VALIGN="bottom"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	61 ><A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	62 HREF="guideinput.html"
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	63 ACCESSKEY="N"
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	64 >Next</A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	65 ></TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	66 ></TR
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	67 ></TABLE
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	68 ><HR
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	69 ALIGN="LEFT"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	70 WIDTH="100%"></DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	71 ><DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	72 CLASS="SECT1"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	73 ><H1
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	74 CLASS="SECT1"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	75 ><A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	76 NAME="GUIDEVIDEOOPENGL"
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	77 ></A
355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	78 >Using OpenGL With SDL</H1
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	79 ><P
1621 f12379c41042 Fixes bug #195: Sam Lantinga <slouken@libsdl.org> parents: 803 diff changeset	80 >SDL has the ability to create and use OpenGL contexts on several platforms(Linux/X11, Win32, BeOS, MacOS Classic/Toolbox, Mac OS X, FreeBSD/X11 and Solaris/X11). This allows you to use SDL's audio, event handling, threads and times in your OpenGL applications (a function often performed by GLUT).</P
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	81 ><DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	82 CLASS="SECT2"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	83 ><H2
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	84 CLASS="SECT2"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	85 ><A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	86 NAME="AEN103"
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	87 ></A
355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	88 >Initialisation</H2
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	89 ><P
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	90 >Initialising SDL to use OpenGL is not very different to initialising SDL normally. There are three differences; you must pass <TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	91 CLASS="LITERAL"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	92 >SDL_OPENGL</TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	93 > to <A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	94 HREF="sdlsetvideomode.html"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	95 ><TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	96 CLASS="FUNCTION"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	97 >SDL_SetVideoMode</TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	98 ></A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	99 >, you must specify several GL attributes (depth buffer size, framebuffer sizes) using <A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	100 HREF="sdlglsetattribute.html"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	101 ><TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	102 CLASS="FUNCTION"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	103 >SDL_GL_SetAttribute</TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	104 ></A
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	105 > and finally, if you wish to use double buffering you must specify it as a GL attribute, <SPAN
355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	106 CLASS="emphasis"
355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	107 ><I
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	108 CLASS="EMPHASIS"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	109 >not</I
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	110 ></SPAN
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	111 > by passing the <TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	112 CLASS="LITERAL"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	113 >SDL_DOUBLEBUF</TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	114 > flag to <TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	115 CLASS="FUNCTION"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	116 >SDL_SetVideoMode</TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	117 >.</P
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	118 ><DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	119 CLASS="EXAMPLE"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	120 ><A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	121 NAME="AEN114"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	122 ></A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	123 ><P
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	124 ><B
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	125 >Example 2-7. Initializing SDL with OpenGL</B
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	126 ></P
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	127 ><PRE
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	128 CLASS="PROGRAMLISTING"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	129 > /* Information about the current video settings. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	130 const SDL_VideoInfo* info = NULL;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	131 /* Dimensions of our window. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	132 int width = 0;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	133 int height = 0;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	134 /* Color depth in bits of our window. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	135 int bpp = 0;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	136 /* Flags we will pass into SDL_SetVideoMode. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	137 int flags = 0;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	138
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	139 /* First, initialize SDL's video subsystem. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	140 if( SDL_Init( SDL_INIT_VIDEO ) < 0 ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	141 /* Failed, exit. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	142 fprintf( stderr, "Video initialization failed: %s\n",
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	143 SDL_GetError( ) );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	144 quit_tutorial( 1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	145 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	146
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	147 /* Let's get some video information. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	148 info = SDL_GetVideoInfo( );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	149
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	150 if( !info ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	151 /* This should probably never happen. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	152 fprintf( stderr, "Video query failed: %s\n",
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	153 SDL_GetError( ) );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	154 quit_tutorial( 1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	155 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	156
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	157 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	158 * Set our width/height to 640/480 (you would
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	159 * of course let the user decide this in a normal
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	160 * app). We get the bpp we will request from
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	161 * the display. On X11, VidMode can't change
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	162 * resolution, so this is probably being overly
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	163 * safe. Under Win32, ChangeDisplaySettings
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	164 * can change the bpp.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	165 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	166 width = 640;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	167 height = 480;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	168 bpp = info->vfmt->BitsPerPixel;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	169
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	170 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	171 * Now, we want to setup our requested
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	172 * window attributes for our OpenGL window.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	173 * We want at least 5 bits of red, green
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	174 * and blue. We also want at least a 16-bit
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	175 * depth buffer.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	176 *
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	177 * The last thing we do is request a double
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	178 * buffered window. '1' turns on double
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	179 * buffering, '0' turns it off.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	180 *
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	181 * Note that we do not use SDL_DOUBLEBUF in
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	182 * the flags to SDL_SetVideoMode. That does
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	183 * not affect the GL attribute state, only
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	184 * the standard 2D blitting setup.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	185 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	186 SDL_GL_SetAttribute( SDL_GL_RED_SIZE, 5 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	187 SDL_GL_SetAttribute( SDL_GL_GREEN_SIZE, 5 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	188 SDL_GL_SetAttribute( SDL_GL_BLUE_SIZE, 5 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	189 SDL_GL_SetAttribute( SDL_GL_DEPTH_SIZE, 16 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	190 SDL_GL_SetAttribute( SDL_GL_DOUBLEBUFFER, 1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	191
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	192 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	193 * We want to request that SDL provide us
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	194 * with an OpenGL window, in a fullscreen
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	195 * video mode.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	196 *
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	197 * EXERCISE:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	198 * Make starting windowed an option, and
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	199 * handle the resize events properly with
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	200 * glViewport.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	201 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	202 flags = SDL_OPENGL \| SDL_FULLSCREEN;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	203
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	204 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	205 * Set the video mode
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	206 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	207 if( SDL_SetVideoMode( width, height, bpp, flags ) == 0 ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	208 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	209 * This could happen for a variety of reasons,
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	210 * including DISPLAY not being set, the specified
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	211 * resolution not being available, etc.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	212 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	213 fprintf( stderr, "Video mode set failed: %s\n",
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	214 SDL_GetError( ) );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	215 quit_tutorial( 1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	216 }</PRE
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	217 ></DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	218 ></DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	219 ><DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	220 CLASS="SECT2"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	221 ><H2
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	222 CLASS="SECT2"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	223 ><A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	224 NAME="AEN117"
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	225 ></A
355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	226 >Drawing</H2
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	227 ><P
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	228 >Apart from initialisation, using OpenGL within SDL is the same as using OpenGL
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	229 with any other API, e.g. GLUT. You still use all the same function calls and
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	230 data types. However if you are using a double-buffered display, then you must
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	231 use
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	232 <A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	233 HREF="sdlglswapbuffers.html"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	234 ><TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	235 CLASS="FUNCTION"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	236 >SDL_GL_SwapBuffers()</TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	237 ></A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	238 >
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	239 to swap the buffers and update the display. To request double-buffering
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	240 with OpenGL, use
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	241 <A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	242 HREF="sdlglsetattribute.html"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	243 ><TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	244 CLASS="FUNCTION"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	245 >SDL_GL_SetAttribute</TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	246 ></A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	247 >
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	248 with <TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	249 CLASS="LITERAL"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	250 >SDL_GL_DOUBLEBUFFER</TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	251 >, and use
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	252 <A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	253 HREF="sdlglgetattribute.html"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	254 ><TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	255 CLASS="FUNCTION"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	256 >SDL_GL_GetAttribute</TT
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	257 ></A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	258 >
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	259 to see if you actually got it.</P
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	260 ><P
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	261 >A full example code listing is now presented below.</P
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	262 ><DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	263 CLASS="EXAMPLE"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	264 ><A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	265 NAME="AEN128"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	266 ></A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	267 ><P
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	268 ><B
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	269 >Example 2-8. SDL and OpenGL</B
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	270 ></P
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	271 ><PRE
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	272 CLASS="PROGRAMLISTING"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	273 >/*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	274 * SDL OpenGL Tutorial.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	275 * (c) Michael Vance, 2000
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	276 * briareos@lokigames.com
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	277 *
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	278 * Distributed under terms of the LGPL.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	279 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	280
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	281 #include <SDL/SDL.h>
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	282 #include <GL/gl.h>
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	283 #include <GL/glu.h>
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	284
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	285 #include <stdio.h>
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	286 #include <stdlib.h>
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	287
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	288 static GLboolean should_rotate = GL_TRUE;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	289
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	290 static void quit_tutorial( int code )
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	291 {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	292 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	293 * Quit SDL so we can release the fullscreen
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	294 * mode and restore the previous video settings,
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	295 * etc.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	296 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	297 SDL_Quit( );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	298
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	299 /* Exit program. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	300 exit( code );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	301 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	302
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	303 static void handle_key_down( SDL_keysym* keysym )
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	304 {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	305
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	306 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	307 * We're only interested if 'Esc' has
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	308 * been presssed.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	309 *
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	310 * EXERCISE:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	311 * Handle the arrow keys and have that change the
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	312 * viewing position/angle.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	313 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	314 switch( keysym->sym ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	315 case SDLK_ESCAPE:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	316 quit_tutorial( 0 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	317 break;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	318 case SDLK_SPACE:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	319 should_rotate = !should_rotate;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	320 break;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	321 default:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	322 break;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	323 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	324
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	325 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	326
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	327 static void process_events( void )
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	328 {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	329 /* Our SDL event placeholder. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	330 SDL_Event event;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	331
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	332 /* Grab all the events off the queue. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	333 while( SDL_PollEvent( &event ) ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	334
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	335 switch( event.type ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	336 case SDL_KEYDOWN:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	337 /* Handle key presses. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	338 handle_key_down( &event.key.keysym );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	339 break;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	340 case SDL_QUIT:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	341 /* Handle quit requests (like Ctrl-c). */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	342 quit_tutorial( 0 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	343 break;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	344 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	345
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	346 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	347
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	348 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	349
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	350 static void draw_screen( void )
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	351 {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	352 /* Our angle of rotation. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	353 static float angle = 0.0f;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	354
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	355 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	356 * EXERCISE:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	357 * Replace this awful mess with vertex
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	358 * arrays and a call to glDrawElements.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	359 *
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	360 * EXERCISE:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	361 * After completing the above, change
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	362 * it to use compiled vertex arrays.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	363 *
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	364 * EXERCISE:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	365 * Verify my windings are correct here ;).
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	366 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	367 static GLfloat v0[] = { -1.0f, -1.0f, 1.0f };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	368 static GLfloat v1[] = { 1.0f, -1.0f, 1.0f };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	369 static GLfloat v2[] = { 1.0f, 1.0f, 1.0f };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	370 static GLfloat v3[] = { -1.0f, 1.0f, 1.0f };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	371 static GLfloat v4[] = { -1.0f, -1.0f, -1.0f };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	372 static GLfloat v5[] = { 1.0f, -1.0f, -1.0f };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	373 static GLfloat v6[] = { 1.0f, 1.0f, -1.0f };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	374 static GLfloat v7[] = { -1.0f, 1.0f, -1.0f };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	375 static GLubyte red[] = { 255, 0, 0, 255 };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	376 static GLubyte green[] = { 0, 255, 0, 255 };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	377 static GLubyte blue[] = { 0, 0, 255, 255 };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	378 static GLubyte white[] = { 255, 255, 255, 255 };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	379 static GLubyte yellow[] = { 0, 255, 255, 255 };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	380 static GLubyte black[] = { 0, 0, 0, 255 };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	381 static GLubyte orange[] = { 255, 255, 0, 255 };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	382 static GLubyte purple[] = { 255, 0, 255, 0 };
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	383
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	384 /* Clear the color and depth buffers. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	385 glClear( GL_COLOR_BUFFER_BIT \| GL_DEPTH_BUFFER_BIT );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	386
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	387 /* We don't want to modify the projection matrix. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	388 glMatrixMode( GL_MODELVIEW );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	389 glLoadIdentity( );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	390
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	391 /* Move down the z-axis. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	392 glTranslatef( 0.0, 0.0, -5.0 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	393
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	394 /* Rotate. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	395 glRotatef( angle, 0.0, 1.0, 0.0 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	396
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	397 if( should_rotate ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	398
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	399 if( ++angle > 360.0f ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	400 angle = 0.0f;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	401 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	402
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	403 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	404
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	405 /* Send our triangle data to the pipeline. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	406 glBegin( GL_TRIANGLES );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	407
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	408 glColor4ubv( red );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	409 glVertex3fv( v0 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	410 glColor4ubv( green );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	411 glVertex3fv( v1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	412 glColor4ubv( blue );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	413 glVertex3fv( v2 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	414
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	415 glColor4ubv( red );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	416 glVertex3fv( v0 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	417 glColor4ubv( blue );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	418 glVertex3fv( v2 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	419 glColor4ubv( white );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	420 glVertex3fv( v3 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	421
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	422 glColor4ubv( green );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	423 glVertex3fv( v1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	424 glColor4ubv( black );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	425 glVertex3fv( v5 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	426 glColor4ubv( orange );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	427 glVertex3fv( v6 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	428
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	429 glColor4ubv( green );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	430 glVertex3fv( v1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	431 glColor4ubv( orange );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	432 glVertex3fv( v6 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	433 glColor4ubv( blue );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	434 glVertex3fv( v2 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	435
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	436 glColor4ubv( black );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	437 glVertex3fv( v5 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	438 glColor4ubv( yellow );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	439 glVertex3fv( v4 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	440 glColor4ubv( purple );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	441 glVertex3fv( v7 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	442
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	443 glColor4ubv( black );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	444 glVertex3fv( v5 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	445 glColor4ubv( purple );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	446 glVertex3fv( v7 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	447 glColor4ubv( orange );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	448 glVertex3fv( v6 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	449
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	450 glColor4ubv( yellow );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	451 glVertex3fv( v4 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	452 glColor4ubv( red );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	453 glVertex3fv( v0 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	454 glColor4ubv( white );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	455 glVertex3fv( v3 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	456
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	457 glColor4ubv( yellow );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	458 glVertex3fv( v4 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	459 glColor4ubv( white );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	460 glVertex3fv( v3 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	461 glColor4ubv( purple );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	462 glVertex3fv( v7 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	463
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	464 glColor4ubv( white );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	465 glVertex3fv( v3 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	466 glColor4ubv( blue );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	467 glVertex3fv( v2 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	468 glColor4ubv( orange );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	469 glVertex3fv( v6 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	470
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	471 glColor4ubv( white );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	472 glVertex3fv( v3 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	473 glColor4ubv( orange );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	474 glVertex3fv( v6 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	475 glColor4ubv( purple );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	476 glVertex3fv( v7 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	477
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	478 glColor4ubv( green );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	479 glVertex3fv( v1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	480 glColor4ubv( red );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	481 glVertex3fv( v0 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	482 glColor4ubv( yellow );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	483 glVertex3fv( v4 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	484
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	485 glColor4ubv( green );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	486 glVertex3fv( v1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	487 glColor4ubv( yellow );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	488 glVertex3fv( v4 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	489 glColor4ubv( black );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	490 glVertex3fv( v5 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	491
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	492 glEnd( );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	493
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	494 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	495 * EXERCISE:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	496 * Draw text telling the user that 'Spc'
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	497 * pauses the rotation and 'Esc' quits.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	498 * Do it using vetors and textured quads.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	499 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	500
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	501 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	502 * Swap the buffers. This this tells the driver to
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	503 * render the next frame from the contents of the
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	504 * back-buffer, and to set all rendering operations
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	505 * to occur on what was the front-buffer.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	506 *
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	507 * Double buffering prevents nasty visual tearing
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	508 * from the application drawing on areas of the
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	509 * screen that are being updated at the same time.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	510 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	511 SDL_GL_SwapBuffers( );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	512 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	513
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	514 static void setup_opengl( int width, int height )
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	515 {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	516 float ratio = (float) width / (float) height;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	517
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	518 /* Our shading model--Gouraud (smooth). */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	519 glShadeModel( GL_SMOOTH );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	520
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	521 /* Culling. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	522 glCullFace( GL_BACK );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	523 glFrontFace( GL_CCW );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	524 glEnable( GL_CULL_FACE );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	525
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	526 /* Set the clear color. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	527 glClearColor( 0, 0, 0, 0 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	528
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	529 /* Setup our viewport. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	530 glViewport( 0, 0, width, height );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	531
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	532 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	533 * Change to the projection matrix and set
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	534 * our viewing volume.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	535 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	536 glMatrixMode( GL_PROJECTION );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	537 glLoadIdentity( );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	538 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	539 * EXERCISE:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	540 * Replace this with a call to glFrustum.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	541 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	542 gluPerspective( 60.0, ratio, 1.0, 1024.0 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	543 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	544
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	545 int main( int argc, char* argv[] )
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	546 {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	547 /* Information about the current video settings. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	548 const SDL_VideoInfo* info = NULL;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	549 /* Dimensions of our window. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	550 int width = 0;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	551 int height = 0;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	552 /* Color depth in bits of our window. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	553 int bpp = 0;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	554 /* Flags we will pass into SDL_SetVideoMode. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	555 int flags = 0;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	556
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	557 /* First, initialize SDL's video subsystem. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	558 if( SDL_Init( SDL_INIT_VIDEO ) < 0 ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	559 /* Failed, exit. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	560 fprintf( stderr, "Video initialization failed: %s\n",
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	561 SDL_GetError( ) );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	562 quit_tutorial( 1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	563 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	564
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	565 /* Let's get some video information. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	566 info = SDL_GetVideoInfo( );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	567
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	568 if( !info ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	569 /* This should probably never happen. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	570 fprintf( stderr, "Video query failed: %s\n",
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	571 SDL_GetError( ) );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	572 quit_tutorial( 1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	573 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	574
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	575 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	576 * Set our width/height to 640/480 (you would
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	577 * of course let the user decide this in a normal
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	578 * app). We get the bpp we will request from
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	579 * the display. On X11, VidMode can't change
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	580 * resolution, so this is probably being overly
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	581 * safe. Under Win32, ChangeDisplaySettings
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	582 * can change the bpp.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	583 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	584 width = 640;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	585 height = 480;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	586 bpp = info->vfmt->BitsPerPixel;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	587
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	588 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	589 * Now, we want to setup our requested
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	590 * window attributes for our OpenGL window.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	591 * We want at least 5 bits of red, green
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	592 * and blue. We also want at least a 16-bit
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	593 * depth buffer.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	594 *
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	595 * The last thing we do is request a double
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	596 * buffered window. '1' turns on double
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	597 * buffering, '0' turns it off.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	598 *
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	599 * Note that we do not use SDL_DOUBLEBUF in
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	600 * the flags to SDL_SetVideoMode. That does
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	601 * not affect the GL attribute state, only
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	602 * the standard 2D blitting setup.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	603 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	604 SDL_GL_SetAttribute( SDL_GL_RED_SIZE, 5 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	605 SDL_GL_SetAttribute( SDL_GL_GREEN_SIZE, 5 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	606 SDL_GL_SetAttribute( SDL_GL_BLUE_SIZE, 5 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	607 SDL_GL_SetAttribute( SDL_GL_DEPTH_SIZE, 16 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	608 SDL_GL_SetAttribute( SDL_GL_DOUBLEBUFFER, 1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	609
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	610 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	611 * We want to request that SDL provide us
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	612 * with an OpenGL window, in a fullscreen
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	613 * video mode.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	614 *
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	615 * EXERCISE:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	616 * Make starting windowed an option, and
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	617 * handle the resize events properly with
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	618 * glViewport.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	619 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	620 flags = SDL_OPENGL \| SDL_FULLSCREEN;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	621
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	622 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	623 * Set the video mode
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	624 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	625 if( SDL_SetVideoMode( width, height, bpp, flags ) == 0 ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	626 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	627 * This could happen for a variety of reasons,
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	628 * including DISPLAY not being set, the specified
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	629 * resolution not being available, etc.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	630 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	631 fprintf( stderr, "Video mode set failed: %s\n",
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	632 SDL_GetError( ) );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	633 quit_tutorial( 1 );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	634 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	635
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	636 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	637 * At this point, we should have a properly setup
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	638 * double-buffered window for use with OpenGL.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	639 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	640 setup_opengl( width, height );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	641
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	642 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	643 * Now we want to begin our normal app process--
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	644 * an event loop with a lot of redrawing.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	645 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	646 while( 1 ) {
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	647 /* Process incoming events. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	648 process_events( );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	649 /* Draw the screen. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	650 draw_screen( );
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	651 }
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	652
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	653 /*
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	654 * EXERCISE:
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	655 * Record timings using SDL_GetTicks() and
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	656 * and print out frames per second at program
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	657 * end.
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	658 */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	659
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	660 /* Never reached. */
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	661 return 0;
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	662 }</PRE
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	663 ></DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	664 ></DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	665 ></DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	666 ><DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	667 CLASS="NAVFOOTER"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	668 ><HR
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	669 ALIGN="LEFT"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	670 WIDTH="100%"><TABLE
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	671 SUMMARY="Footer navigation table"
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	672 WIDTH="100%"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	673 BORDER="0"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	674 CELLPADDING="0"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	675 CELLSPACING="0"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	676 ><TR
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	677 ><TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	678 WIDTH="33%"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	679 ALIGN="left"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	680 VALIGN="top"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	681 ><A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	682 HREF="guidevideo.html"
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	683 ACCESSKEY="P"
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	684 >Prev</A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	685 ></TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	686 ><TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	687 WIDTH="34%"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	688 ALIGN="center"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	689 VALIGN="top"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	690 ><A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	691 HREF="index.html"
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	692 ACCESSKEY="H"
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	693 >Home</A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	694 ></TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	695 ><TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	696 WIDTH="33%"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	697 ALIGN="right"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	698 VALIGN="top"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	699 ><A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	700 HREF="guideinput.html"
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	701 ACCESSKEY="N"
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	702 >Next</A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	703 ></TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	704 ></TR
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	705 ><TR
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	706 ><TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	707 WIDTH="33%"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	708 ALIGN="left"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	709 VALIGN="top"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	710 >Graphics and Video</TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	711 ><TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	712 WIDTH="34%"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	713 ALIGN="center"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	714 VALIGN="top"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	715 ><A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	716 HREF="guidevideo.html"
803 355632dca928 Updated SDL HTML documentation Sam Lantinga <slouken@libsdl.org> parents: 55 diff changeset	717 ACCESSKEY="U"
55 55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	718 >Up</A
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	719 ></TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	720 ><TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	721 WIDTH="33%"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	722 ALIGN="right"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	723 VALIGN="top"
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	724 >Input handling</TD
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	725 ></TR
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	726 ></TABLE
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	727 ></DIV
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	728 ></BODY
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	729 ></HTML
55f1f1b3e27d Added new docs for SDL 1.2.1 Sam Lantinga <slouken@lokigames.com> parents: diff changeset	730 >

Mercurial > sdl-ios-xcode

annotate docs/html/guidevideoopengl.html @ 1621:f12379c41042