ale/doc/user/defaults/index.xml
2022-07-30 14:46:04 -03:00

109 lines
2.9 KiB
XML

<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//Norman Walsh//DTD DocBk XML V3.1.4//EN"
"file:///usr/share/xml/docbook/schema/dtd/4.4/docbookx.dtd">
<chapter id="user-defaults">
<title>Default Settings</title>
<p>ALE offers five different default settings, each of which emphasizes
image quality, speed, or some other rendering characteristic, as follows:</p>
<ll>--q0 Low quality, high speed. [default]
--qn Low noise, moderate speed.
--q1 Moderate quality and speed.
--q2 High quality, low speed.
--qr Range-extended high quality.
</ll>
<p>These settings specify defaults for other options: <l>--dchain</l>,
<l>--achain</l>, <l>--3d-chain</l>, <l>--ips</l>, <l>--exp-extend</l>, and
<l>--cx</l>. For more information about these options, see <xref
linkend="user-rendering"/> and <xref linkend="user-3d"/>. Details regarding
these defaults are provided in the following sections.</p>
<s><t>High speed (--q0)</t>
<p><code>--q0</code> emphasizes speed over image quality. This option is default, and
sets other options' defaults as follows:</p>
<ll>--dchain fine:box:1,triangle:2
--achain triangle:2
--ips 0
--exp-noextend
--no-cx
--3d-chain fine:box:1,triangle:2
</ll>
</s>
<s><t>Low noise (--qn)</t>
<p><code>--qn</code> emphasizes low noise over resolution and rendering speed, and
sets the following defaults:</p>
<ll>--dchain sinc*lanc:6
--achain sinc*lanc:6
--ips 0
--exp-noextend
--no-cx
--3d-chain sinc*lanc:6
</ll>
</s>
<s><t>Balanced quality and speed (--q1)</t>
<p><code>--q1</code> balances image quality and rendering speed, offering higher
resolution than <code>--qn</code>. As this option uses median values, its memory use
is linear in the number of input images (rather than constant).</p>
<ll>--dchain median:fine:sinc*lanc:8,triangle:2
--achain triangle:2
--ips 0
--exp-noextend
--no-cx
--3d-chain median:fine:sinc*lanc:8,triangle:2
</ll>
</s>
<s><t>High quality (--q2)</t>
<p><l>--q2</l> favors image quality over rendering speed, offering greater
emphasis for high-frequency details than <l>--q0</l>, <l>--qn</l>,
or <l>--q1</l>. It depends on the <l>--lpsf</l> and
<l>--nlpsf</l> options, which can be set indirectly via the
<l>--device</l> option. (More information about these options can be
found in <xref linkend="user-psf"/> and <xref linkend="user-device"/>.) <l>--q2</l>
sets the following defaults:</p>
<ll>--dchain triangle:2
--achain triangle:2
--ips 4
--exp-noextend
--no-cx
--3d-chain median:fine:sinc*lanc:8,triangle:2
</ll>
</s>
<s><t>Range extension (--qr)</t>
<p><code>--qr</code> is similar to <code>--q2</code>, but offers improved
rendering when input images have been taken with unequal exposures. In other
cases, it may exacerbate noise in light and dark regions. This option sets the
following defaults:</p>
<ll>--dchain triangle:2
--achain triangle:2
--ips 6
--exp-extend
--cx 0.7
--3d-chain median:fine:sinc*lanc:8,triangle:2
</ll>
</s>
</chapter>