1<HTML 2><HEAD 3><TITLE 4>SDL_MapRGBA</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_MapRGB" 17HREF="sdlmaprgb.html"><LINK 18REL="NEXT" 19TITLE="SDL_GetRGB" 20HREF="sdlgetrgb.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="sdlmaprgb.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="sdlgetrgb.html" 63ACCESSKEY="N" 64>Next</A 65></TD 66></TR 67></TABLE 68><HR 69ALIGN="LEFT" 70WIDTH="100%"></DIV 71><H1 72><A 73NAME="SDLMAPRGBA" 74></A 75>SDL_MapRGBA</H1 76><DIV 77CLASS="REFNAMEDIV" 78><A 79NAME="AEN1687" 80></A 81><H2 82>Name</H2 83>SDL_MapRGBA -- Map a RGBA color value to a pixel format.</DIV 84><DIV 85CLASS="REFSYNOPSISDIV" 86><A 87NAME="AEN1690" 88></A 89><H2 90>Synopsis</H2 91><DIV 92CLASS="FUNCSYNOPSIS" 93><A 94NAME="AEN1691" 95></A 96><P 97></P 98><PRE 99CLASS="FUNCSYNOPSISINFO" 100>#include "SDL.h"</PRE 101><P 102><CODE 103><CODE 104CLASS="FUNCDEF" 105>Uint32 <B 106CLASS="FSFUNC" 107>SDL_MapRGBA</B 108></CODE 109>(SDL_PixelFormat *fmt, Uint8 r, Uint8 g, Uint8 b, Uint8 a);</CODE 110></P 111><P 112></P 113></DIV 114></DIV 115><DIV 116CLASS="REFSECT1" 117><A 118NAME="AEN1697" 119></A 120><H2 121>Description</H2 122><P 123>Maps the RGBA color value to the specified pixel format and returns the 124pixel value as a 32-bit int.</P 125><P 126>If the format has a palette (8-bit) the index of the closest matching 127color in the palette will be returned.</P 128><P 129>If the specified pixel format has no alpha component the alpha value 130will be ignored (as it will be in formats with a palette).</P 131></DIV 132><DIV 133CLASS="REFSECT1" 134><A 135NAME="AEN1702" 136></A 137><H2 138>Return Value</H2 139><P 140>A pixel value best approximating the given RGBA color value for a given 141pixel format. If the pixel format bpp (color depth) is less than 32-bpp 142then the unused upper bits of the return value can safely be ignored 143(e.g., with a 16-bpp format the return value can be assigned to a 144<SPAN 145CLASS="TYPE" 146>Uint16</SPAN 147>, and similarly a <SPAN 148CLASS="TYPE" 149>Uint8</SPAN 150> for an 8-bpp 151format).</P 152></DIV 153><DIV 154CLASS="REFSECT1" 155><A 156NAME="AEN1707" 157></A 158><H2 159>See Also</H2 160><P 161><A 162HREF="sdlgetrgb.html" 163>SDL_GetRGB</A 164>, 165<A 166HREF="sdlgetrgba.html" 167>SDL_GetRGBA</A 168>, 169<A 170HREF="sdlmaprgb.html" 171>SDL_MapRGB</A 172>, 173<A 174HREF="sdlpixelformat.html" 175>SDL_PixelFormat</A 176></P 177></DIV 178><DIV 179CLASS="NAVFOOTER" 180><HR 181ALIGN="LEFT" 182WIDTH="100%"><TABLE 183SUMMARY="Footer navigation table" 184WIDTH="100%" 185BORDER="0" 186CELLPADDING="0" 187CELLSPACING="0" 188><TR 189><TD 190WIDTH="33%" 191ALIGN="left" 192VALIGN="top" 193><A 194HREF="sdlmaprgb.html" 195ACCESSKEY="P" 196>Prev</A 197></TD 198><TD 199WIDTH="34%" 200ALIGN="center" 201VALIGN="top" 202><A 203HREF="index.html" 204ACCESSKEY="H" 205>Home</A 206></TD 207><TD 208WIDTH="33%" 209ALIGN="right" 210VALIGN="top" 211><A 212HREF="sdlgetrgb.html" 213ACCESSKEY="N" 214>Next</A 215></TD 216></TR 217><TR 218><TD 219WIDTH="33%" 220ALIGN="left" 221VALIGN="top" 222>SDL_MapRGB</TD 223><TD 224WIDTH="34%" 225ALIGN="center" 226VALIGN="top" 227><A 228HREF="video.html" 229ACCESSKEY="U" 230>Up</A 231></TD 232><TD 233WIDTH="33%" 234ALIGN="right" 235VALIGN="top" 236>SDL_GetRGB</TD 237></TR 238></TABLE 239></DIV 240></BODY 241></HTML 242>