/usr/share/doc/liblqr-1-0-dev/html/ref-lqr-carver-resize.html is in liblqr-1-0-dev 0.4.2-2.1.
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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>lqr_carver_resize</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"><link rel="home" href="index.html" title="The Liquid Rescale library Manual"><link rel="up" href="ref-carve.html" title="Carver objects"><link rel="prev" href="ref-lqr-carver-set-black-channel.html" title="lqr_carver_set_black_channel"><link rel="next" href="ref-lqr-carver-flatten.html" title="lqr_carver_flatten"></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"><code class="function">lqr_carver_resize</code></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ref-lqr-carver-set-black-channel.html">Prev</a> </td><th width="60%" align="center">Carver objects</th><td width="20%" align="right"> <a accesskey="n" href="ref-lqr-carver-flatten.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="ref-lqr-carver-resize"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>lqr_carver_resize — liquid rescale a <code class="classname">LqrCarver</code> object</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <lqr.h></pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">LqrRetVal <b class="fsfunc">lqr_carver_resize</b>(</code></td><td>LqrCarver* <var class="pdparam">carver</var>, </td></tr><tr><td> </td><td>gint <var class="pdparam">new_width</var>, </td></tr><tr><td> </td><td>gint <var class="pdparam">new_height</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="idm2156"></a><h2>Description</h2><p>
The function <code class="function">lqr_carver_resize</code> performs the liquid rescaling over the
<code class="classname">LqrCarver</code> object pointed to by <em class="parameter"><code>carver</code></em>. If a visibility map was loaded
through the function <code class="function">lqr_vmap_load</code>, and the carver was not initialised, the
resizing operations must be limited to the direction and the sizes included in the loaded map.
If the carver was initialised through the function <code class="function">lqr_carver_init</code>, there
are no limitations to the final size.
</p><p>
The resizing function can be called multiple times, and it will decide automatically whether the
computation of the visibility map is necessary or not. In case it isn't, the function returns
almost immediately, otherwise operations will proceed following the order given through the
function <code class="function">lqr_carver_set_resize_order</code>. Currently, on-the-fly rescaling
without computation is only possible for a single direction at a time.
</p><p>
If the new size (in one direction or in both) is greater than or equal to the original size
multiplied by the enlargement step of the <em class="parameter"><code>carver</code></em> object (as obtained
through <a class="xref" href="ref-lqr-carver-get-enl-step.html" title="lqr_carver_get_enl_step"><span class="refentrytitle"><code class="function">lqr_carver_get_enl_step</code></span>(3)</a>), the rescaling will be performed in
multiple steps. At each step, the original size stored internally is reset to the new value;
therefore, each step in the process can be bigger then the previous one.
</p><p>
Whenever the resizing dirction changes (this may happen in a single call of the rescaling
function or through multiple calls), or if performing a multiple steps enlargement as per the
previous paragraph, the visibility map computed during the first direction rescale is dropped to
make place for the one for the second (and the original size of the image is reset to the
current value). These visibility maps can be saved by using the
<code class="function">lqr_carver_set_vmap_dump</code> function, for inspection or future use.
</p></div><div class="refsect1"><a name="idm2171"></a><h2>Return value</h2><p>
The return value follows the Liquid Rescale library signalling system. It returns an error if trying to exceed
the limitations of a loaded visibility map, or if passed a negative or null size.
</p></div><div class="refsect1"><a name="idm2174"></a><h2>See also</h2><p>
<span class="simplelist"><a class="xref" href="ref-lqr-ret-val.html" title="LqrRetVal"><span class="refentrytitle"><span class="type">LqrRetVal</span></span>(3)</a>, <a class="xref" href="ref-lqr-carver-init.html" title="lqr_carver_init"><span class="refentrytitle"><code class="function">lqr_carver_init</code></span>(3)</a>, <a class="xref" href="ref-lqr-carver-flatten.html" title="lqr_carver_flatten"><span class="refentrytitle"><code class="function">lqr_carver_flatten</code></span>(3)</a>, <a class="xref" href="ref-lqr-carver-set-enl-step.html" title="lqr_carver_set_enl_step"><span class="refentrytitle"><code class="function">lqr_carver_set_enl_step</code></span>(3)</a>, <a class="xref" href="ref-lqr-carver-get-enl-step.html" title="lqr_carver_get_enl_step"><span class="refentrytitle"><code class="function">lqr_carver_get_enl_step</code></span>(3)</a>, <a class="xref" href="ref-lqr-carver-cancel.html" title="lqr_carver_cancel"><span class="refentrytitle"><code class="function">lqr_carver_cancel</code></span>(3)</a>, <a class="xref" href="ref-lqr-vmap-load.html" title="lqr_vmap_load"><span class="refentrytitle"><code class="function">lqr_vmap_load</code></span>(3)</a></span>
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ref-lqr-carver-set-black-channel.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref-carve.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ref-lqr-carver-flatten.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><code class="function">lqr_carver_set_black_channel</code> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <code class="function">lqr_carver_flatten</code></td></tr></table></div></body></html>
|