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

annotate docs/html/guidevideoopengl.html @ 4226:dbdf8b108e31 SDL-1.2

Fixed bug #638 Philipp Nordhus 2008-11-05 13:56:33 PST The Linux version of SDL_SYS_JoystickQuit() tries to free an invalid pointer when the number of joysticks was reduced since the last call. Reproduce: Connect two joysticks, call SDL_Init() and SDL_Quit(), then disconnect one joystick and call the functions again.

author	Sam Lantinga <slouken@libsdl.org>
date	Mon, 21 Sep 2009 11:34:50 +0000
parents	f12379c41042
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 @ 4226:dbdf8b108e31 SDL-1.2