handle src buffer underflow corner cases
[sdl_omap.git] / docs / man3 / SDL_GetRGBA.3
CommitLineData
e14743d1 1.TH "SDL_GetRGBA" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference"
2.SH "NAME"
3SDL_GetRGBA \- Get RGBA values from a pixel in the specified pixel format\&.
4.SH "SYNOPSIS"
5.PP
6\fB#include "SDL\&.h"
7.sp
8\fBvoid \fBSDL_GetRGBA\fP\fR(\fBUint32 pixel, SDL_PixelFormat *fmt, Uint8 *r, Uint8 *g, Uint8 *b, Uint8 *a\fR);
9.SH "DESCRIPTION"
10.PP
11Get RGBA component values from a pixel stored in the specified pixel format\&.
12.PP
13This function uses the entire 8-bit [0\&.\&.255] range when converting color components from pixel formats with less than 8-bits per RGB component (e\&.g\&., a completely white pixel in 16-bit RGB565 format would return [0xff, 0xff, 0xff] not [0xf8, 0xfc, 0xf8])\&.
14.PP
15If the surface has no alpha component, the alpha will be returned as 0xff (100% opaque)\&.
16.SH "SEE ALSO"
17.PP
18\fISDL_GetRGB\fR, \fISDL_MapRGB\fR, \fISDL_MapRGBA\fR, \fISDL_PixelFormat\fR
19.\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01