1<HTML 2><HEAD 3><TITLE 4>SDL_Palette</TITLE 5><META 6NAME="GENERATOR" 7CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ 8"><LINK 9REL="HOME" 10TITLE="SDL Library Documentation" 11HREF="index.html"><LINK 12REL="UP" 13TITLE="Video" 14HREF="video.html"><LINK 15REL="PREVIOUS" 16TITLE="SDL_Color" 17HREF="sdlcolor.html"><LINK 18REL="NEXT" 19TITLE="SDL_PixelFormat" 20HREF="sdlpixelformat.html"></HEAD 21><BODY 22CLASS="REFENTRY" 23BGCOLOR="#FFF8DC" 24TEXT="#000000" 25LINK="#0000ee" 26VLINK="#551a8b" 27ALINK="#ff0000" 28><DIV 29CLASS="NAVHEADER" 30><TABLE 31SUMMARY="Header navigation table" 32WIDTH="100%" 33BORDER="0" 34CELLPADDING="0" 35CELLSPACING="0" 36><TR 37><TH 38COLSPAN="3" 39ALIGN="center" 40>SDL Library Documentation</TH 41></TR 42><TR 43><TD 44WIDTH="10%" 45ALIGN="left" 46VALIGN="bottom" 47><A 48HREF="sdlcolor.html" 49ACCESSKEY="P" 50>Prev</A 51></TD 52><TD 53WIDTH="80%" 54ALIGN="center" 55VALIGN="bottom" 56></TD 57><TD 58WIDTH="10%" 59ALIGN="right" 60VALIGN="bottom" 61><A 62HREF="sdlpixelformat.html" 63ACCESSKEY="N" 64>Next</A 65></TD 66></TR 67></TABLE 68><HR 69ALIGN="LEFT" 70WIDTH="100%"></DIV 71><H1 72><A 73NAME="SDLPALETTE" 74></A 75>SDL_Palette</H1 76><DIV 77CLASS="REFNAMEDIV" 78><A 79NAME="AEN3129" 80></A 81><H2 82>Name</H2 83>SDL_Palette -- Color palette for 8-bit pixel formats</DIV 84><DIV 85CLASS="REFSECT1" 86><A 87NAME="AEN3132" 88></A 89><H2 90>Structure Definition</H2 91><PRE 92CLASS="PROGRAMLISTING" 93>typedef struct{ 94 int ncolors; 95 SDL_Color *colors; 96} SDL_Palette;</PRE 97></DIV 98><DIV 99CLASS="REFSECT1" 100><A 101NAME="AEN3135" 102></A 103><H2 104>Structure Data</H2 105><DIV 106CLASS="INFORMALTABLE" 107><A 108NAME="AEN3137" 109></A 110><P 111></P 112><TABLE 113BORDER="0" 114CLASS="CALSTABLE" 115><TBODY 116><TR 117><TD 118ALIGN="LEFT" 119VALIGN="TOP" 120><TT 121CLASS="STRUCTFIELD" 122><I 123>ncolors</I 124></TT 125></TD 126><TD 127ALIGN="LEFT" 128VALIGN="TOP" 129>Number of colors used in this palette</TD 130></TR 131><TR 132><TD 133ALIGN="LEFT" 134VALIGN="TOP" 135><TT 136CLASS="STRUCTFIELD" 137><I 138>colors</I 139></TT 140></TD 141><TD 142ALIGN="LEFT" 143VALIGN="TOP" 144>Pointer to <A 145HREF="sdlcolor.html" 146><SPAN 147CLASS="STRUCTNAME" 148>SDL_Color</SPAN 149></A 150> structures that make up the palette.</TD 151></TR 152></TBODY 153></TABLE 154><P 155></P 156></DIV 157></DIV 158><DIV 159CLASS="REFSECT1" 160><A 161NAME="AEN3150" 162></A 163><H2 164>Description</H2 165><P 166>Each pixel in an 8-bit surface is an index into the <TT 167CLASS="STRUCTFIELD" 168><I 169>colors</I 170></TT 171> field of the <SPAN 172CLASS="STRUCTNAME" 173>SDL_Palette</SPAN 174> structure store in <A 175HREF="sdlpixelformat.html" 176><SPAN 177CLASS="STRUCTNAME" 178>SDL_PixelFormat</SPAN 179></A 180>. A <SPAN 181CLASS="STRUCTNAME" 182>SDL_Palette</SPAN 183> should never need to be created manually. It is automatically created when SDL allocates a <SPAN 184CLASS="STRUCTNAME" 185>SDL_PixelFormat</SPAN 186> for a surface. The colors values of a <A 187HREF="sdlsurface.html" 188><SPAN 189CLASS="STRUCTNAME" 190>SDL_Surface</SPAN 191></A 192>s palette can be set with the <A 193HREF="sdlsetcolors.html" 194><TT 195CLASS="FUNCTION" 196>SDL_SetColors</TT 197></A 198>.</P 199></DIV 200><DIV 201CLASS="REFSECT1" 202><A 203NAME="AEN3163" 204></A 205><H2 206>See Also</H2 207><P 208><A 209HREF="sdlcolor.html" 210><SPAN 211CLASS="STRUCTNAME" 212>SDL_Color</SPAN 213></A 214>, 215<A 216HREF="sdlsurface.html" 217><SPAN 218CLASS="STRUCTNAME" 219>SDL_Surface</SPAN 220></A 221>, 222<A 223HREF="sdlsetcolors.html" 224><TT 225CLASS="FUNCTION" 226>SDL_SetColors</TT 227></A 228> 229<A 230HREF="sdlsetpalette.html" 231><TT 232CLASS="FUNCTION" 233>SDL_SetPalette</TT 234></A 235></P 236></DIV 237><DIV 238CLASS="NAVFOOTER" 239><HR 240ALIGN="LEFT" 241WIDTH="100%"><TABLE 242SUMMARY="Footer navigation table" 243WIDTH="100%" 244BORDER="0" 245CELLPADDING="0" 246CELLSPACING="0" 247><TR 248><TD 249WIDTH="33%" 250ALIGN="left" 251VALIGN="top" 252><A 253HREF="sdlcolor.html" 254ACCESSKEY="P" 255>Prev</A 256></TD 257><TD 258WIDTH="34%" 259ALIGN="center" 260VALIGN="top" 261><A 262HREF="index.html" 263ACCESSKEY="H" 264>Home</A 265></TD 266><TD 267WIDTH="33%" 268ALIGN="right" 269VALIGN="top" 270><A 271HREF="sdlpixelformat.html" 272ACCESSKEY="N" 273>Next</A 274></TD 275></TR 276><TR 277><TD 278WIDTH="33%" 279ALIGN="left" 280VALIGN="top" 281>SDL_Color</TD 282><TD 283WIDTH="34%" 284ALIGN="center" 285VALIGN="top" 286><A 287HREF="video.html" 288ACCESSKEY="U" 289>Up</A 290></TD 291><TD 292WIDTH="33%" 293ALIGN="right" 294VALIGN="top" 295>SDL_PixelFormat</TD 296></TR 297></TABLE 298></DIV 299></BODY 300></HTML 301>