/usr/share/doc/libsdl-stretch-dev/html/man/rn01re06.html is in libsdl-stretch-dev 0.3.1-10.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>SDL_SetRowStretchCode</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"><link rel="home" href="index.html" title="Manual Pages"><link rel="up" href="index.html" title="Manual Pages"><link rel="prev" href="rn01re05.html" title="SDL_GetRowStretchCode"><link rel="next" href="rn01re07.html" title="SDL_StretchRowInfo"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">SDL_SetRowStretchCode</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="rn01re05.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="rn01re07.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="SDL_SetRowStretchCode"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>SDL_SetRowStretchCode, SDL_PutRowStretchCode, SDL_RunRowStretchCode, SDL_StretchRow1, SDL_StretchRow2, SDL_StretchRow3, SDL_StretchRow4 — (src/SDL_stretchcode.h) </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">
#include <SDL_stretch.h>
</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">unsigned char* <b class="fsfunc">SDL_SetRowStretchCode</b>(</code></td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>int src_w</code>;<br><code>int dst_w</code>;<br><code>int bpp</code>;</div><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">unsigned char* <b class="fsfunc">SDL_PutRowStretchCode</b>(</code></td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>unsigned char* buffer</code>;<br><code>int buflen</code>;<br><code>int src_w</code>;<br><code>int dst_w</code>;<br><code>int bpp</code>;</div><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">SDL_RunRowStretchCode</b>(</code></td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>unsigned char* buffer</code>;<br><code>unsigned char* src</code>;<br><code>unsigned char* dst</code>;</div><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">SDL_StretchRow1</b>(</code></td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>Uint8 *src</code>;<br><code>int src_w</code>;<br><code>Uint8 *dst</code>;<br><code>int dst_w</code>;</div><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">SDL_StretchRow2</b>(</code></td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>Uint16 *src</code>;<br><code>int src_w</code>;<br><code>Uint16 *dst</code>;<br><code>int dst_w</code>;</div><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">SDL_StretchRow3</b>(</code></td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>Uint8 *src</code>;<br><code>int src_w</code>;<br><code>Uint8 *dst</code>;<br><code>int dst_w</code>;</div><div class="funcprototype-spacer"> </div><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <b class="fsfunc">SDL_StretchRow4</b>(</code></td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td>, </td><td> </td></tr><tr><td> </td><td><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>Uint32 *src</code>;<br><code>int src_w</code>;<br><code>Uint32 *dst</code>;<br><code>int dst_w</code>;</div><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm202"></a><h2>Description</h2><p>
The SetRowStretchCode is a wrapper around PutRowStretchCode that
uses the Adress and Size of the shared SDL_TheRowStretchCode buffer.
The PutRowStretchCode will fill the given buffer with an assembler
stream that should be called with SDL_RunRowStretchCode. The
assembler stream is usually faster as all the scale decisions are
done in advance of the execution. This helps when a RunCode is
done multiple times with the same src_w/dst_w/bpp pair. All the
pixel-get and pixel-set calls are unrolled in that buffer. Therefore,
the buffer should be big enough - as a rule of thumb use a buffer
of size (src_w+dst_w)*5
</p><p>
If PutCode or SetCode fails, a NULL is returned and SDL_SetError.
Otherwise, the start adress of the machine code buffer is returned,
which is also the input argument of PutCode and RunCode.
</p><p>
</p><p>
</p><p>
If SDL_SetRowStretchCode fails, <code class="function">the SDL_StretchRow1 function</code> must be used instead.
<code class="function">The SDL_StretchRow1 function</code> and its cousins are singular routines that work in
a tight loop to scale a single row. The number specifies the
byte-width of each pixel (it is not a bit-width!).
</p><p>
</p><p>
</p><p>
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="rn01re05.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="rn01re07.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">SDL_GetRowStretchCode </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> SDL_StretchRowInfo</td></tr></table></div></body></html>
|