SDL-1.2.14
[sdl_omap.git] / docs / man3 / SDL_SetGammaRamp.3
CommitLineData
e14743d1 1.TH "SDL_SetGammaRamp" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference"
2.SH "NAME"
3SDL_SetGammaRamp \- Sets the color gamma lookup tables for the display
4.SH "SYNOPSIS"
5.PP
6\fB#include "SDL\&.h"
7.sp
8\fBint \fBSDL_SetGammaRamp\fP\fR(\fBUint16 *redtable, Uint16 *greentable, Uint16 *bluetable\fR);
9.SH "DESCRIPTION"
10.PP
11Sets the gamma lookup tables for the display for each color component\&. Each table is an array of 256 Uint16 values, representing a mapping between the input and output for that channel\&. The input is the index into the array, and the output is the 16-bit gamma value at that index, scaled to the output color precision\&. You may pass NULL to any of the channels to leave them unchanged\&.
12.PP
13This function adjusts the gamma based on lookup tables, you can also have the gamma calculated based on a "gamma function" parameter with \fISDL_SetGamma\fR\&.
14.PP
15Not all display hardware is able to change gamma\&.
16.SH "RETURN VALUE"
17.PP
18Returns -1 on error (or if gamma adjustment is not supported)\&.
19.SH "SEE ALSO"
20.PP
21\fISDL_SetGamma\fR \fISDL_GetGammaRamp\fR
22.\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01