initial commit

doc/user/defaults/index.xml

@@ -0,0 +1,108 @@
+<?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>