/usr/share/doc/liblqr-1-0-dev/html/ref-lqr-carver-set-side-switch-frequency.html is in liblqr-1-0-dev 0.4.1-1.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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>lqr_carver_set_side_switch_frequency</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><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-dump-vmaps.html" title="lqr_carver_set_dump_vmaps"><link rel="next" href="ref-lqr-carver-set-progress.html" title="lqr_carver_set_progress"></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_set_side_switch_frequency</code></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ref-lqr-carver-set-dump-vmaps.html">Prev</a> </td><th width="60%" align="center">Carver objects</th><td width="20%" align="right"> <a accesskey="n" href="ref-lqr-carver-set-progress.html">Next</a></td></tr></table><hr></div><div class="refentry" title="lqr_carver_set_side_switch_frequency"><a name="ref-lqr-carver-set-side-switch-frequency"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>lqr_carver_set_side_switch_frequency — set <code class="classname">LqrCarver</code> object side switch frequency</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <lqr.h></pre><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">void <b class="fsfunc">lqr_carver_set_side_switch_frequency</b>(</code></td><td>LqrCarver* <var class="pdparam">carver</var>, </td></tr><tr><td> </td><td>guint <var class="pdparam">switch_frequency</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Description"><a name="idp33184352"></a><h2>Description</h2><p>
When the function <a class="xref" href="ref-lqr-carver-resize.html" title="lqr_carver_resize"><span class="refentrytitle"><code class="function">lqr_carver_resize</code></span>(3)</a> is invoked, it computes a
relevance value for each pixel in the image, then chooses the optimal seam to carve based on
such relvance values. However, in the case two seams are equivalent (which may happen when
large portions of the image have the same colour, for example), the algorithm always chooses the
seams from one side.
</p><p>
In order to overcome this effect, an option is given to automatically switch the favoured side
during rescaling, at the cost of a slightly worse performance.
</p><p>
The function <code class="function">lqr_carver_set_side_switch_frequency</code> sets the side switch
frequency to <em class="parameter"><code>switch_frequency</code></em> for the <code class="classname">LqrCarver</code> object pointed to by
<em class="parameter"><code>carver</code></em>. This will have the effect that, for each rescale operation, the
favoured side will be switched <em class="parameter"><code>switch_frequency</code></em> times (or as much times
as the number of pixels to rescale).
</p><p>
The default value for newly created <code class="classname">LqrCarver</code> objects is <code class="literal">0</code>.
</p><p>
As for the final result, a very small value (e.g. <code class="literal">1<code class="literal"> to </code>4</code>)
will normally suffice to balance the left and right side of the image (or the top and the boddom
sides for vertical rescalings), without noticeable computational costs. However, in order to
obtain a smoother behaviour for the visibiliy map, i.e. for the intermediate steps, higher
values may be required.
</p></div><div class="refsect1" title="See also"><a name="idp33194336"></a><h2>See also</h2><p>
<span class="simplelist"><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-set-resize-order.html" title="lqr_carver_set_resize_order"><span class="refentrytitle"><code class="function">lqr_carver_set_resize_order</code></span>(3)</a>, <a class="xref" href="ref-lqr-carver-set-dump-vmaps.html" title="lqr_carver_set_dump_vmaps"><span class="refentrytitle"><code class="function">lqr_carver_set_dump_vmaps</code></span>(3)</a>, <a class="xref" href="ref-lqr-carver-set-progress.html" title="lqr_carver_set_progress"><span class="refentrytitle"><code class="function">lqr_carver_set_progress</code></span>(3)</a>, <a class="xref" href="ref-lqr-carver-set-preserve-input-image.html" title="lqr_carver_set_preserve_input_image"><span class="refentrytitle"><code class="function">lqr_carver_set_preserve_input_image</code></span>(3)</a>, <a class="xref" href="ref-lqr-carver-set-use-cache.html" title="lqr_carver_set_use_cache"><span class="refentrytitle"><code class="function">lqr_carver_set_use_cache</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-dump-vmaps.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-set-progress.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><code class="function">lqr_carver_set_dump_vmaps</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_set_progress</code></td></tr></table></div></body></html>
|