home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 7 / RISCWORLD_VOL7.iso / Software / Issue2 / SDL.ARC / sdlhtmldox / sdlsetgamm < prev    next >
Encoding:
Text File  |  2001-05-09  |  3.1 KB  |  222 lines
  1. <HTML
  2. ><HEAD
  3. ><TITLE
  4. >SDL_SetGammaRamp</TITLE
  5. ><META
  6. NAME="GENERATOR"
  7. CONTENT="Modular DocBook HTML Stylesheet Version 1.64
  8. "><LINK
  9. REL="HOME"
  10. TITLE="SDL Library Documentation"
  11. HREF="index.html"><LINK
  12. REL="UP"
  13. TITLE="Video"
  14. HREF="video.html"><LINK
  15. REL="PREVIOUS"
  16. TITLE="SDL_GetGammaRamp"
  17. HREF="sdlgetgammaramp.html"><LINK
  18. REL="NEXT"
  19. TITLE="SDL_MapRGB"
  20. HREF="sdlmaprgb.html"></HEAD
  21. ><BODY
  22. CLASS="REFENTRY"
  23. BGCOLOR="#FFF8DC"
  24. TEXT="#000000"
  25. LINK="#0000ee"
  26. VLINK="#551a8b"
  27. ALINK="#ff0000"
  28. ><DIV
  29. CLASS="NAVHEADER"
  30. ><TABLE
  31. WIDTH="100%"
  32. BORDER="0"
  33. CELLPADDING="0"
  34. CELLSPACING="0"
  35. ><TR
  36. ><TH
  37. COLSPAN="3"
  38. ALIGN="center"
  39. >SDL Library Documentation</TH
  40. ></TR
  41. ><TR
  42. ><TD
  43. WIDTH="10%"
  44. ALIGN="left"
  45. VALIGN="bottom"
  46. ><A
  47. HREF="sdlgetgammaramp.html"
  48. >Prev</A
  49. ></TD
  50. ><TD
  51. WIDTH="80%"
  52. ALIGN="center"
  53. VALIGN="bottom"
  54. ></TD
  55. ><TD
  56. WIDTH="10%"
  57. ALIGN="right"
  58. VALIGN="bottom"
  59. ><A
  60. HREF="sdlmaprgb.html"
  61. >Next</A
  62. ></TD
  63. ></TR
  64. ></TABLE
  65. ><HR
  66. ALIGN="LEFT"
  67. WIDTH="100%"></DIV
  68. ><H1
  69. ><A
  70. NAME="SDLSETGAMMARAMP"
  71. >SDL_SetGammaRamp</A
  72. ></H1
  73. ><DIV
  74. CLASS="REFNAMEDIV"
  75. ><A
  76. NAME="AEN1242"
  77. ></A
  78. ><H2
  79. >Name</H2
  80. >SDL_SetGammaRamp -- Sets the color gamma lookup tables for the display</DIV
  81. ><DIV
  82. CLASS="REFSYNOPSISDIV"
  83. ><A
  84. NAME="AEN1245"
  85. ></A
  86. ><H2
  87. >Synopsis</H2
  88. ><DIV
  89. CLASS="FUNCSYNOPSIS"
  90. ><A
  91. NAME="AEN1246"
  92. ></A
  93. ><P
  94. ></P
  95. ><PRE
  96. CLASS="FUNCSYNOPSISINFO"
  97. >#include "SDL.h"</PRE
  98. ><P
  99. ><CODE
  100. ><CODE
  101. CLASS="FUNCDEF"
  102. >int <B
  103. CLASS="FSFUNC"
  104. >SDL_SetGammaRamp</B
  105. ></CODE
  106. >(Uint16 *redtable, Uint16 *greentable, Uint16 *bluetable);</CODE
  107. ></P
  108. ><P
  109. ></P
  110. ></DIV
  111. ></DIV
  112. ><DIV
  113. CLASS="REFSECT1"
  114. ><A
  115. NAME="AEN1252"
  116. ></A
  117. ><H2
  118. >Description</H2
  119. ><P
  120. >Sets the gamma lookup tables for the display for each color component.
  121. Each table is an array of 256 Uint16 values, representing a mapping
  122. between the input and output for that channel. The input is the index
  123. into the array, and the output is the 16-bit gamma value at that index,
  124. scaled to the output color precision. You may pass NULL to any of the
  125. channels to leave them unchanged.</P
  126. ><P
  127. >This function adjusts the gamma based on lookup tables, you can also
  128. have the gamma calculated based on a "gamma function" parameter with
  129. <A
  130. HREF="sdlsetgamma.html"
  131. >SDL_SetGamma</A
  132. >.</P
  133. ><P
  134. >Not all display hardware is able to change gamma.</P
  135. ></DIV
  136. ><DIV
  137. CLASS="REFSECT1"
  138. ><A
  139. NAME="AEN1258"
  140. ></A
  141. ><H2
  142. >Return Value</H2
  143. ><P
  144. >Returns -1 on error (or if gamma adjustment is not supported).</P
  145. ></DIV
  146. ><DIV
  147. CLASS="REFSECT1"
  148. ><A
  149. NAME="AEN1261"
  150. ></A
  151. ><H2
  152. >See Also</H2
  153. ><P
  154. ><A
  155. HREF="sdlsetgamma.html"
  156. >SDL_SetGamma</A
  157. >
  158. <A
  159. HREF="sdlgetgammaramp.html"
  160. >SDL_GetGammaRamp</A
  161. ></P
  162. ></DIV
  163. ><DIV
  164. CLASS="NAVFOOTER"
  165. ><HR
  166. ALIGN="LEFT"
  167. WIDTH="100%"><TABLE
  168. WIDTH="100%"
  169. BORDER="0"
  170. CELLPADDING="0"
  171. CELLSPACING="0"
  172. ><TR
  173. ><TD
  174. WIDTH="33%"
  175. ALIGN="left"
  176. VALIGN="top"
  177. ><A
  178. HREF="sdlgetgammaramp.html"
  179. >Prev</A
  180. ></TD
  181. ><TD
  182. WIDTH="34%"
  183. ALIGN="center"
  184. VALIGN="top"
  185. ><A
  186. HREF="index.html"
  187. >Home</A
  188. ></TD
  189. ><TD
  190. WIDTH="33%"
  191. ALIGN="right"
  192. VALIGN="top"
  193. ><A
  194. HREF="sdlmaprgb.html"
  195. >Next</A
  196. ></TD
  197. ></TR
  198. ><TR
  199. ><TD
  200. WIDTH="33%"
  201. ALIGN="left"
  202. VALIGN="top"
  203. >SDL_GetGammaRamp</TD
  204. ><TD
  205. WIDTH="34%"
  206. ALIGN="center"
  207. VALIGN="top"
  208. ><A
  209. HREF="video.html"
  210. >Up</A
  211. ></TD
  212. ><TD
  213. WIDTH="33%"
  214. ALIGN="right"
  215. VALIGN="top"
  216. >SDL_MapRGB</TD
  217. ></TR
  218. ></TABLE
  219. ></DIV
  220. ></BODY
  221. ></HTML
  222. >