Debian Codegraph @

Docs/html/_s_d_l__gfx_blit_func_8h.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml">
3 <head>
4 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5 <meta http-equiv="X-UA-Compatible" content="IE=9"/>
6 <title>SDL_gfx: I:/Sources/sdlgfx/SDL_gfxBlitFunc.h File Reference</title>
7
8 <link href="tabs.css" rel="stylesheet" type="text/css"/>
9 <link href="doxygen.css" rel="stylesheet" type="text/css" />
10
11
12
13 </head>
14 <body>
15 <div id="top"><!-- do not remove this div! -->
16
17
18 <div id="titlearea">
19 <table cellspacing="0" cellpadding="0">
20 <tbody>
21 <tr style="height: 56px;">
22
23
24 <td style="padding-left: 0.5em;">
25 <div id="projectname">SDL_gfx
26 &#160;<span id="projectnumber">2.0.25</span>
27 </div>
28
29 </td>
30
31
32
33 </tr>
34 </tbody>
35 </table>
36 </div>
37
38 <!-- Generated by Doxygen 1.8.0 -->
39 <div id="navrow1" class="tabs">
40 <ul class="tablist">
41 <li><a href="index.html"><span>Main&#160;Page</span></a></li>
42 <li><a href="annotated.html"><span>Data&#160;Structures</span></a></li>
43 <li class="current"><a href="files.html"><span>Files</span></a></li>
44 </ul>
45 </div>
46 <div id="navrow2" class="tabs2">
47 <ul class="tablist">
48 <li><a href="files.html"><span>File&#160;List</span></a></li>
49 <li><a href="globals.html"><span>Globals</span></a></li>
50 </ul>
51 </div>
52 </div>
53 <div class="header">
54 <div class="summary">
55 <a href="#nested-classes">Data Structures</a> &#124;
56 <a href="#define-members">Defines</a> &#124;
57 <a href="#func-members">Functions</a> &#124;
58 <a href="#var-members">Variables</a> </div>
59 <div class="headertitle">
60 <div class="title">I:/Sources/sdlgfx/SDL_gfxBlitFunc.h File Reference</div> </div>
61 </div><!--header-->
62 <div class="contents">
63 <div class="textblock"><code>#include &lt;stdio.h&gt;</code><br/>
64 <code>#include &lt;stdlib.h&gt;</code><br/>
65 <code>#include &quot;SDL.h&quot;</code><br/>
66 <code>#include &quot;SDL_video.h&quot;</code><br/>
67 </div>
68 <p><a href="_s_d_l__gfx_blit_func_8h_source.html">Go to the source code of this file.</a></p>
69 <table class="memberdecls">
70 <tr><td colspan="2"><h2><a name="nested-classes"></a>
71 Data Structures</h2></td></tr>
72 <tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="struct_s_d_l__gfx_blit_info.html">SDL_gfxBlitInfo</a></td></tr>
73 <tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">The structure passed to the low level blit functions. <a href="struct_s_d_l__gfx_blit_info.html#details">More...</a><br/></td></tr>
74 <tr><td colspan="2"><h2><a name="define-members"></a>
75 Defines</h2></td></tr>
76 <tr class="memitem:a8fcea397327309f4ab31a3251f15f911"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a8fcea397327309f4ab31a3251f15f911">SDL_GFXBLITFUNC_SCOPE</a>&#160;&#160;&#160;extern</td></tr>
77 <tr class="memitem:ae6b2c815be86ad92310efb40d4b0b30e"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#ae6b2c815be86ad92310efb40d4b0b30e">GFX_RGBA_FROM_PIXEL</a>(pixel, fmt, r, g, b, a)</td></tr>
78 <tr class="memdesc:ae6b2c815be86ad92310efb40d4b0b30e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Unwrap RGBA values from a pixel using mask, shift and loss for surface. <a href="#ae6b2c815be86ad92310efb40d4b0b30e"></a><br/></td></tr>
79 <tr class="memitem:a7dda3984ca04929e2ea0a3679f7452a9"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a7dda3984ca04929e2ea0a3679f7452a9">GFX_DISASSEMBLE_RGBA</a>(buf, bpp, fmt, pixel, r, g, b, a)</td></tr>
80 <tr class="memdesc:a7dda3984ca04929e2ea0a3679f7452a9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Disassemble buffer pointer into a pixel and separate RGBA values. <a href="#a7dda3984ca04929e2ea0a3679f7452a9"></a><br/></td></tr>
81 <tr class="memitem:a64927ca5690904716f7ac93b1fcd4420"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a64927ca5690904716f7ac93b1fcd4420">GFX_PIXEL_FROM_RGBA</a>(pixel, fmt, r, g, b, a)</td></tr>
82 <tr class="memdesc:a64927ca5690904716f7ac93b1fcd4420"><td class="mdescLeft">&#160;</td><td class="mdescRight">Wrap a pixel from RGBA values using mask, shift and loss for surface. <a href="#a64927ca5690904716f7ac93b1fcd4420"></a><br/></td></tr>
83 <tr class="memitem:a4e59f926fb98a86c01a4ffc5cc20e8d5"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a4e59f926fb98a86c01a4ffc5cc20e8d5">GFX_ASSEMBLE_RGBA</a>(buf, bpp, fmt, r, g, b, a)</td></tr>
84 <tr class="memdesc:a4e59f926fb98a86c01a4ffc5cc20e8d5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Assemble pixel into buffer pointer from separate RGBA values. <a href="#a4e59f926fb98a86c01a4ffc5cc20e8d5"></a><br/></td></tr>
85 <tr class="memitem:ae3efb9e67172838c394c148a62822da6"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#ae3efb9e67172838c394c148a62822da6">GFX_ALPHA_BLEND</a>(sR, sG, sB, A, dR, dG, dB)</td></tr>
86 <tr class="memdesc:ae3efb9e67172838c394c148a62822da6"><td class="mdescLeft">&#160;</td><td class="mdescRight">Blend the RGB values of two pixels based on a source alpha value. <a href="#ae3efb9e67172838c394c148a62822da6"></a><br/></td></tr>
87 <tr class="memitem:a44c498dca765a515f40eecad8f19aac4"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a44c498dca765a515f40eecad8f19aac4">GFX_DUFFS_LOOP4</a>(pixel_copy_increment, width)</td></tr>
88 <tr class="memdesc:a44c498dca765a515f40eecad8f19aac4"><td class="mdescLeft">&#160;</td><td class="mdescRight">4-times unrolled DUFFs loop. <a href="#a44c498dca765a515f40eecad8f19aac4"></a><br/></td></tr>
89 <tr><td colspan="2"><h2><a name="func-members"></a>
90 Functions</h2></td></tr>
91 <tr class="memitem:ab49c560e89b8305051b2e6b347215f03"><td class="memItemLeft" align="right" valign="top"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a8fcea397327309f4ab31a3251f15f911">SDL_GFXBLITFUNC_SCOPE</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#ab49c560e89b8305051b2e6b347215f03">SDL_gfxBlitRGBA</a> (SDL_Surface *src, SDL_Rect *srcrect, SDL_Surface *dst, SDL_Rect *dstrect)</td></tr>
92 <tr class="memdesc:ab49c560e89b8305051b2e6b347215f03"><td class="mdescLeft">&#160;</td><td class="mdescRight">Blitter for RGBA-&gt;RGBA blits with alpha adjustment. <a href="#ab49c560e89b8305051b2e6b347215f03"></a><br/></td></tr>
93 <tr class="memitem:a4627ae4a0037d0b248bed87f3c294735"><td class="memItemLeft" align="right" valign="top"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a8fcea397327309f4ab31a3251f15f911">SDL_GFXBLITFUNC_SCOPE</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a4627ae4a0037d0b248bed87f3c294735">SDL_gfxSetAlpha</a> (SDL_Surface *src, Uint8 a)</td></tr>
94 <tr class="memdesc:a4627ae4a0037d0b248bed87f3c294735"><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the alpha channel in a 32 bit surface. <a href="#a4627ae4a0037d0b248bed87f3c294735"></a><br/></td></tr>
95 <tr class="memitem:a7c93594525ae349b5cef0156b8f758fc"><td class="memItemLeft" align="right" valign="top"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a8fcea397327309f4ab31a3251f15f911">SDL_GFXBLITFUNC_SCOPE</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a7c93594525ae349b5cef0156b8f758fc">SDL_gfxMultiplyAlpha</a> (SDL_Surface *src, Uint8 a)</td></tr>
96 <tr class="memdesc:a7c93594525ae349b5cef0156b8f758fc"><td class="mdescLeft">&#160;</td><td class="mdescRight">Multiply the alpha channel in a 32bit surface. <a href="#a7c93594525ae349b5cef0156b8f758fc"></a><br/></td></tr>
97 <tr><td colspan="2"><h2><a name="var-members"></a>
98 Variables</h2></td></tr>
99 <tr class="memitem:a6d0c17342154e14322a281603960691a"><td class="memItemLeft" align="right" valign="top">const unsigned int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a6d0c17342154e14322a281603960691a">GFX_ALPHA_ADJUST_ARRAY</a> [256]</td></tr>
100 <tr class="memdesc:a6d0c17342154e14322a281603960691a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Alpha adjustment table for custom blitter. <a href="#a6d0c17342154e14322a281603960691a"></a><br/></td></tr>
101 </table>
102 <hr/><h2>Define Documentation</h2>
103 <a class="anchor" id="ae3efb9e67172838c394c148a62822da6"></a>
104 <div class="memitem">
105 <div class="memproto">
106 <table class="memname">
107 <tr>
108 <td class="memname">#define <a class="el" href="_s_d_l__gfx_blit_func_8h.html#ae3efb9e67172838c394c148a62822da6">GFX_ALPHA_BLEND</a></td>
109 <td>(</td>
110 <td class="paramtype">&#160;</td>
111 <td class="paramname">sR, </td>
112 </tr>
113 <tr>
114 <td class="paramkey"></td>
115 <td></td>
116 <td class="paramtype">&#160;</td>
117 <td class="paramname">sG, </td>
118 </tr>
119 <tr>
120 <td class="paramkey"></td>
121 <td></td>
122 <td class="paramtype">&#160;</td>
123 <td class="paramname">sB, </td>
124 </tr>
125 <tr>
126 <td class="paramkey"></td>
127 <td></td>
128 <td class="paramtype">&#160;</td>
129 <td class="paramname">A, </td>
130 </tr>
131 <tr>
132 <td class="paramkey"></td>
133 <td></td>
134 <td class="paramtype">&#160;</td>
135 <td class="paramname">dR, </td>
136 </tr>
137 <tr>
138 <td class="paramkey"></td>
139 <td></td>
140 <td class="paramtype">&#160;</td>
141 <td class="paramname">dG, </td>
142 </tr>
143 <tr>
144 <td class="paramkey"></td>
145 <td></td>
146 <td class="paramtype">&#160;</td>
147 <td class="paramname">dB&#160;</td>
148 </tr>
149 <tr>
150 <td></td>
151 <td>)</td>
152 <td></td><td></td>
153 </tr>
154 </table>
155 </div>
156 <div class="memdoc">
157 <b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">do</span> { \
158 dR = (((sR-dR)*(A))/255)+dR; \
159 dG = (((sG-dG)*(A))/255)+dG; \
160 dB = (((sB-dB)*(A))/255)+dB; \
161 } <span class="keywordflow">while</span>(0)
162 </pre></div>
163 <p>Blend the RGB values of two pixels based on a source alpha value. </p>
164
165 <p>Definition at line <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html#l00138">138</a> of file <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html">SDL_gfxBlitFunc.h</a>.</p>
166
167 </div>
168 </div>
169 <a class="anchor" id="a4e59f926fb98a86c01a4ffc5cc20e8d5"></a>
170 <div class="memitem">
171 <div class="memproto">
172 <table class="memname">
173 <tr>
174 <td class="memname">#define <a class="el" href="_s_d_l__gfx_blit_func_8h.html#a4e59f926fb98a86c01a4ffc5cc20e8d5">GFX_ASSEMBLE_RGBA</a></td>
175 <td>(</td>
176 <td class="paramtype">&#160;</td>
177 <td class="paramname">buf, </td>
178 </tr>
179 <tr>
180 <td class="paramkey"></td>
181 <td></td>
182 <td class="paramtype">&#160;</td>
183 <td class="paramname">bpp, </td>
184 </tr>
185 <tr>
186 <td class="paramkey"></td>
187 <td></td>
188 <td class="paramtype">&#160;</td>
189 <td class="paramname">fmt, </td>
190 </tr>
191 <tr>
192 <td class="paramkey"></td>
193 <td></td>
194 <td class="paramtype">&#160;</td>
195 <td class="paramname">r, </td>
196 </tr>
197 <tr>
198 <td class="paramkey"></td>
199 <td></td>
200 <td class="paramtype">&#160;</td>
201 <td class="paramname">g, </td>
202 </tr>
203 <tr>
204 <td class="paramkey"></td>
205 <td></td>
206 <td class="paramtype">&#160;</td>
207 <td class="paramname">b, </td>
208 </tr>
209 <tr>
210 <td class="paramkey"></td>
211 <td></td>
212 <td class="paramtype">&#160;</td>
213 <td class="paramname">a&#160;</td>
214 </tr>
215 <tr>
216 <td></td>
217 <td>)</td>
218 <td></td><td></td>
219 </tr>
220 </table>
221 </div>
222 <div class="memdoc">
223 <b>Value:</b><div class="fragment"><pre class="fragment">{ \
224 Uint32 pixel; <a class="code" href="_s_d_l__gfx_blit_func_8h.html#a64927ca5690904716f7ac93b1fcd4420" title="Wrap a pixel from RGBA values using mask, shift and loss for surface.">\</a>
225 <a class="code" href="_s_d_l__gfx_blit_func_8h.html#a64927ca5690904716f7ac93b1fcd4420" title="Wrap a pixel from RGBA values using mask, shift and loss for surface."> \</a>
226 <a class="code" href="_s_d_l__gfx_blit_func_8h.html#a64927ca5690904716f7ac93b1fcd4420" title="Wrap a pixel from RGBA values using mask, shift and loss for surface."> GFX_PIXEL_FROM_RGBA</a>(pixel, fmt, r, g, b, a); \
227 *((Uint32 *)(buf)) = pixel; \
228 }
229 </pre></div>
230 <p>Assemble pixel into buffer pointer from separate RGBA values. </p>
231
232 <p>Definition at line <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html#l00127">127</a> of file <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html">SDL_gfxBlitFunc.h</a>.</p>
233
234 </div>
235 </div>
236 <a class="anchor" id="a7dda3984ca04929e2ea0a3679f7452a9"></a>
237 <div class="memitem">
238 <div class="memproto">
239 <table class="memname">
240 <tr>
241 <td class="memname">#define <a class="el" href="_s_d_l__gfx_blit_func_8h.html#a7dda3984ca04929e2ea0a3679f7452a9">GFX_DISASSEMBLE_RGBA</a></td>
242 <td>(</td>
243 <td class="paramtype">&#160;</td>
244 <td class="paramname">buf, </td>
245 </tr>
246 <tr>
247 <td class="paramkey"></td>
248 <td></td>
249 <td class="paramtype">&#160;</td>
250 <td class="paramname">bpp, </td>
251 </tr>
252 <tr>
253 <td class="paramkey"></td>
254 <td></td>
255 <td class="paramtype">&#160;</td>
256 <td class="paramname">fmt, </td>
257 </tr>
258 <tr>
259 <td class="paramkey"></td>
260 <td></td>
261 <td class="paramtype">&#160;</td>
262 <td class="paramname">pixel, </td>
263 </tr>
264 <tr>
265 <td class="paramkey"></td>
266 <td></td>
267 <td class="paramtype">&#160;</td>
268 <td class="paramname">r, </td>
269 </tr>
270 <tr>
271 <td class="paramkey"></td>
272 <td></td>
273 <td class="paramtype">&#160;</td>
274 <td class="paramname">g, </td>
275 </tr>
276 <tr>
277 <td class="paramkey"></td>
278 <td></td>
279 <td class="paramtype">&#160;</td>
280 <td class="paramname">b, </td>
281 </tr>
282 <tr>
283 <td class="paramkey"></td>
284 <td></td>
285 <td class="paramtype">&#160;</td>
286 <td class="paramname">a&#160;</td>
287 </tr>
288 <tr>
289 <td></td>
290 <td>)</td>
291 <td></td><td></td>
292 </tr>
293 </table>
294 </div>
295 <div class="memdoc">
296 <b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">do</span> { \
297 pixel = *((Uint32 *)(buf)); \
298 GFX_RGBA_FROM_PIXEL(pixel, fmt, r, g, b, a); \
299 pixel &amp;= ~fmt-&gt;Amask; \
300 } <span class="keywordflow">while</span>(0)
301 </pre></div>
302 <p>Disassemble buffer pointer into a pixel and separate RGBA values. </p>
303
304 <p>Definition at line <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html#l00106">106</a> of file <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html">SDL_gfxBlitFunc.h</a>.</p>
305
306 </div>
307 </div>
308 <a class="anchor" id="a44c498dca765a515f40eecad8f19aac4"></a>
309 <div class="memitem">
310 <div class="memproto">
311 <table class="memname">
312 <tr>
313 <td class="memname">#define <a class="el" href="_s_d_l__gfx_blit_func_8h.html#a44c498dca765a515f40eecad8f19aac4">GFX_DUFFS_LOOP4</a></td>
314 <td>(</td>
315 <td class="paramtype">&#160;</td>
316 <td class="paramname">pixel_copy_increment, </td>
317 </tr>
318 <tr>
319 <td class="paramkey"></td>
320 <td></td>
321 <td class="paramtype">&#160;</td>
322 <td class="paramname">width&#160;</td>
323 </tr>
324 <tr>
325 <td></td>
326 <td>)</td>
327 <td></td><td></td>
328 </tr>
329 </table>
330 </div>
331 <div class="memdoc">
332 <b>Value:</b><div class="fragment"><pre class="fragment">{ <span class="keywordtype">int</span> n = (width+3)/4; \
333 switch (width &amp; 3) { \
334 case 0: <span class="keywordflow">do</span> { pixel_copy_increment; \
335 case 3: pixel_copy_increment; \
336 case 2: pixel_copy_increment; \
337 case 1: pixel_copy_increment; \
338 } <span class="keywordflow">while</span> ( --n &gt; 0 ); \
339 } \
340 }
341 </pre></div>
342 <p>4-times unrolled DUFFs loop. </p>
343 <p>This is a very useful loop for optimizing blitters. </p>
344
345 <p>Definition at line <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html#l00150">150</a> of file <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html">SDL_gfxBlitFunc.h</a>.</p>
346
347 </div>
348 </div>
349 <a class="anchor" id="a64927ca5690904716f7ac93b1fcd4420"></a>
350 <div class="memitem">
351 <div class="memproto">
352 <table class="memname">
353 <tr>
354 <td class="memname">#define <a class="el" href="_s_d_l__gfx_blit_func_8h.html#a64927ca5690904716f7ac93b1fcd4420">GFX_PIXEL_FROM_RGBA</a></td>
355 <td>(</td>
356 <td class="paramtype">&#160;</td>
357 <td class="paramname">pixel, </td>
358 </tr>
359 <tr>
360 <td class="paramkey"></td>
361 <td></td>
362 <td class="paramtype">&#160;</td>
363 <td class="paramname">fmt, </td>
364 </tr>
365 <tr>
366 <td class="paramkey"></td>
367 <td></td>
368 <td class="paramtype">&#160;</td>
369 <td class="paramname">r, </td>
370 </tr>
371 <tr>
372 <td class="paramkey"></td>
373 <td></td>
374 <td class="paramtype">&#160;</td>
375 <td class="paramname">g, </td>
376 </tr>
377 <tr>
378 <td class="paramkey"></td>
379 <td></td>
380 <td class="paramtype">&#160;</td>
381 <td class="paramname">b, </td>
382 </tr>
383 <tr>
384 <td class="paramkey"></td>
385 <td></td>
386 <td class="paramtype">&#160;</td>
387 <td class="paramname">a&#160;</td>
388 </tr>
389 <tr>
390 <td></td>
391 <td>)</td>
392 <td></td><td></td>
393 </tr>
394 </table>
395 </div>
396 <div class="memdoc">
397 <b>Value:</b><div class="fragment"><pre class="fragment">{ \
398 pixel = ((r&gt;&gt;fmt-&gt;Rloss)&lt;&lt;fmt-&gt;Rshift)| \
399 ((g&gt;&gt;fmt-&gt;Gloss)&lt;&lt;fmt-&gt;Gshift)| \
400 ((b&gt;&gt;fmt-&gt;Bloss)&lt;&lt;fmt-&gt;Bshift)| \
401 ((a&lt;&lt;fmt-&gt;Aloss)&lt;&lt;fmt-&gt;Ashift); \
402 }
403 </pre></div>
404 <p>Wrap a pixel from RGBA values using mask, shift and loss for surface. </p>
405
406 <p>Definition at line <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html#l00116">116</a> of file <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html">SDL_gfxBlitFunc.h</a>.</p>
407
408 </div>
409 </div>
410 <a class="anchor" id="ae6b2c815be86ad92310efb40d4b0b30e"></a>
411 <div class="memitem">
412 <div class="memproto">
413 <table class="memname">
414 <tr>
415 <td class="memname">#define <a class="el" href="_s_d_l__gfx_blit_func_8h.html#ae6b2c815be86ad92310efb40d4b0b30e">GFX_RGBA_FROM_PIXEL</a></td>
416 <td>(</td>
417 <td class="paramtype">&#160;</td>
418 <td class="paramname">pixel, </td>
419 </tr>
420 <tr>
421 <td class="paramkey"></td>
422 <td></td>
423 <td class="paramtype">&#160;</td>
424 <td class="paramname">fmt, </td>
425 </tr>
426 <tr>
427 <td class="paramkey"></td>
428 <td></td>
429 <td class="paramtype">&#160;</td>
430 <td class="paramname">r, </td>
431 </tr>
432 <tr>
433 <td class="paramkey"></td>
434 <td></td>
435 <td class="paramtype">&#160;</td>
436 <td class="paramname">g, </td>
437 </tr>
438 <tr>
439 <td class="paramkey"></td>
440 <td></td>
441 <td class="paramtype">&#160;</td>
442 <td class="paramname">b, </td>
443 </tr>
444 <tr>
445 <td class="paramkey"></td>
446 <td></td>
447 <td class="paramtype">&#160;</td>
448 <td class="paramname">a&#160;</td>
449 </tr>
450 <tr>
451 <td></td>
452 <td>)</td>
453 <td></td><td></td>
454 </tr>
455 </table>
456 </div>
457 <div class="memdoc">
458 <b>Value:</b><div class="fragment"><pre class="fragment">{ \
459 r = ((pixel&amp;fmt-&gt;Rmask)&gt;&gt;fmt-&gt;Rshift)&lt;&lt;fmt-&gt;Rloss; \
460 g = ((pixel&amp;fmt-&gt;Gmask)&gt;&gt;fmt-&gt;Gshift)&lt;&lt;fmt-&gt;Gloss; \
461 b = ((pixel&amp;fmt-&gt;Bmask)&gt;&gt;fmt-&gt;Bshift)&lt;&lt;fmt-&gt;Bloss; \
462 a = ((pixel&amp;fmt-&gt;Amask)&gt;&gt;fmt-&gt;Ashift)&lt;&lt;fmt-&gt;Aloss; \
463 }
464 </pre></div>
465 <p>Unwrap RGBA values from a pixel using mask, shift and loss for surface. </p>
466
467 <p>Definition at line <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html#l00095">95</a> of file <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html">SDL_gfxBlitFunc.h</a>.</p>
468
469 </div>
470 </div>
471 <a class="anchor" id="a8fcea397327309f4ab31a3251f15f911"></a>
472 <div class="memitem">
473 <div class="memproto">
474 <table class="memname">
475 <tr>
476 <td class="memname">#define <a class="el" href="_s_d_l__gfx_blit_func_8h.html#a8fcea397327309f4ab31a3251f15f911">SDL_GFXBLITFUNC_SCOPE</a>&#160;&#160;&#160;extern</td>
477 </tr>
478 </table>
479 </div>
480 <div class="memdoc">
481
482 <p>Definition at line <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html#l00059">59</a> of file <a class="el" href="_s_d_l__gfx_blit_func_8h_source.html">SDL_gfxBlitFunc.h</a>.</p>
483
484 </div>
485 </div>
486 <hr/><h2>Function Documentation</h2>
487 <a class="anchor" id="ab49c560e89b8305051b2e6b347215f03"></a>
488 <div class="memitem">
489 <div class="memproto">
490 <table class="memname">
491 <tr>
492 <td class="memname"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a8fcea397327309f4ab31a3251f15f911">SDL_GFXBLITFUNC_SCOPE</a> int <a class="el" href="_s_d_l__gfx_blit_func_8h.html#ab49c560e89b8305051b2e6b347215f03">SDL_gfxBlitRGBA</a> </td>
493 <td>(</td>
494 <td class="paramtype">SDL_Surface *&#160;</td>
495 <td class="paramname"><em>src</em>, </td>
496 </tr>
497 <tr>
498 <td class="paramkey"></td>
499 <td></td>
500 <td class="paramtype">SDL_Rect *&#160;</td>
501 <td class="paramname"><em>srcrect</em>, </td>
502 </tr>
503 <tr>
504 <td class="paramkey"></td>
505 <td></td>
506 <td class="paramtype">SDL_Surface *&#160;</td>
507 <td class="paramname"><em>dst</em>, </td>
508 </tr>
509 <tr>
510 <td class="paramkey"></td>
511 <td></td>
512 <td class="paramtype">SDL_Rect *&#160;</td>
513 <td class="paramname"><em>dstrect</em>&#160;</td>
514 </tr>
515 <tr>
516 <td></td>
517 <td>)</td>
518 <td></td><td></td>
519 </tr>
520 </table>
521 </div>
522 <div class="memdoc">
523
524 <p>Blitter for RGBA-&gt;RGBA blits with alpha adjustment. </p>
525 <p>Verifies the input 'src' and 'dst' surfaces and rectangles and performs blit. The destination clip rectangle is honored.</p>
526 <dl class="params"><dt><b>Parameters:</b></dt><dd>
527 <table class="params">
528 <tr><td class="paramname">src</td><td>The source surface. </td></tr>
529 <tr><td class="paramname">srcrect</td><td>The source rectangle. </td></tr>
530 <tr><td class="paramname">dst</td><td>The destination surface. </td></tr>
531 <tr><td class="paramname">dstrect</td><td>The destination rectangle.</td></tr>
532 </table>
533 </dd>
534 </dl>
535 <dl class="section return"><dt>Returns:</dt><dd>Returns 1 if blit was performed, 0 otherwise, or -1 if an error occured. </dd></dl>
536
537 <p>Definition at line <a class="el" href="_s_d_l__gfx_blit_func_8c_source.html#l00411">411</a> of file <a class="el" href="_s_d_l__gfx_blit_func_8c_source.html">SDL_gfxBlitFunc.c</a>.</p>
538
539 </div>
540 </div>
541 <a class="anchor" id="a7c93594525ae349b5cef0156b8f758fc"></a>
542 <div class="memitem">
543 <div class="memproto">
544 <table class="memname">
545 <tr>
546 <td class="memname"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a8fcea397327309f4ab31a3251f15f911">SDL_GFXBLITFUNC_SCOPE</a> int <a class="el" href="_s_d_l__gfx_blit_func_8h.html#a7c93594525ae349b5cef0156b8f758fc">SDL_gfxMultiplyAlpha</a> </td>
547 <td>(</td>
548 <td class="paramtype">SDL_Surface *&#160;</td>
549 <td class="paramname"><em>src</em>, </td>
550 </tr>
551 <tr>
552 <td class="paramkey"></td>
553 <td></td>
554 <td class="paramtype">Uint8&#160;</td>
555 <td class="paramname"><em>a</em>&#160;</td>
556 </tr>
557 <tr>
558 <td></td>
559 <td>)</td>
560 <td></td><td></td>
561 </tr>
562 </table>
563 </div>
564 <div class="memdoc">
565
566 <p>Multiply the alpha channel in a 32bit surface. </p>
567 <p>Helper function that multiplies the alpha channel in a 32 bit surface with a constant value. The final alpha is always scaled to the range 0-255 (i.e. the factor is a/256).</p>
568 <p>Only 32 bit surfaces can be used with this function.</p>
569 <dl class="params"><dt><b>Parameters:</b></dt><dd>
570 <table class="params">
571 <tr><td class="paramname">src</td><td>Pointer to the target surface to change. </td></tr>
572 <tr><td class="paramname">a</td><td>The alpha value to multiply with. When a is 255, this function is a NoOp.</td></tr>
573 </table>
574 </dd>
575 </dl>
576 <dl class="section return"><dt>Returns:</dt><dd>Returns 1 if alpha was changed, 0 otherwise. Returns -1 if input surface is invalid. </dd></dl>
577
578 <p>Definition at line <a class="el" href="_s_d_l__gfx_blit_func_8c_source.html#l00587">587</a> of file <a class="el" href="_s_d_l__gfx_blit_func_8c_source.html">SDL_gfxBlitFunc.c</a>.</p>
579
580 </div>
581 </div>
582 <a class="anchor" id="a4627ae4a0037d0b248bed87f3c294735"></a>
583 <div class="memitem">
584 <div class="memproto">
585 <table class="memname">
586 <tr>
587 <td class="memname"><a class="el" href="_s_d_l__gfx_blit_func_8h.html#a8fcea397327309f4ab31a3251f15f911">SDL_GFXBLITFUNC_SCOPE</a> int <a class="el" href="_s_d_l__gfx_blit_func_8h.html#a4627ae4a0037d0b248bed87f3c294735">SDL_gfxSetAlpha</a> </td>
588 <td>(</td>
589 <td class="paramtype">SDL_Surface *&#160;</td>
590 <td class="paramname"><em>src</em>, </td>
591 </tr>
592 <tr>
593 <td class="paramkey"></td>
594 <td></td>
595 <td class="paramtype">Uint8&#160;</td>
596 <td class="paramname"><em>a</em>&#160;</td>
597 </tr>
598 <tr>
599 <td></td>
600 <td>)</td>
601 <td></td><td></td>
602 </tr>
603 </table>
604 </div>
605 <div class="memdoc">
606
607 <p>Sets the alpha channel in a 32 bit surface. </p>
608 <p>Helper function that sets the alpha channel in a 32 bit surface to a constant value. Only 32 bit surfaces can be used with this function.</p>
609 <dl class="params"><dt><b>Parameters:</b></dt><dd>
610 <table class="params">
611 <tr><td class="paramname">src</td><td>Pointer to the target surface to change. </td></tr>
612 <tr><td class="paramname">a</td><td>The alpha value to set.</td></tr>
613 </table>
614 </dd>
615 </dl>
616 <dl class="section return"><dt>Returns:</dt><dd>Returns 1 if alpha was changed, -1 otherwise. </dd></dl>
617
618 <p>Definition at line <a class="el" href="_s_d_l__gfx_blit_func_8c_source.html#l00524">524</a> of file <a class="el" href="_s_d_l__gfx_blit_func_8c_source.html">SDL_gfxBlitFunc.c</a>.</p>
619
620 </div>
621 </div>
622 <hr/><h2>Variable Documentation</h2>
623 <a class="anchor" id="a6d0c17342154e14322a281603960691a"></a>
624 <div class="memitem">
625 <div class="memproto">
626 <table class="memname">
627 <tr>
628 <td class="memname">const unsigned int <a class="el" href="_s_d_l__gfx_blit_func_8h.html#a6d0c17342154e14322a281603960691a">GFX_ALPHA_ADJUST_ARRAY</a>[256]</td>
629 </tr>
630 </table>
631 </div>
632 <div class="memdoc">
633
634 <p>Alpha adjustment table for custom blitter. </p>
635 <p>The table provides values for a modified, non-linear transfer function which maintain brightness. </p>
636
637 <p>Definition at line <a class="el" href="_s_d_l__gfx_blit_func_8c_source.html#l00039">39</a> of file <a class="el" href="_s_d_l__gfx_blit_func_8c_source.html">SDL_gfxBlitFunc.c</a>.</p>
638
639 </div>
640 </div>
641 </div><!-- contents -->
642
643
644 <hr class="footer"/><address class="footer"><small>
645 Generated by &#160;<a href="http://www.doxygen.org/index.html">
646 <img class="footer" src="doxygen.png" alt="doxygen"/>
647 </a> 1.8.0
648 </small></address>
649
650 </body>
651 </html>