doc/user/psf/index.xml

   1 <?xml version="1.0"?>
   2
   3 <!DOCTYPE book PUBLIC "-//Norman Walsh//DTD DocBk XML V3.1.4//EN"
   4         "file:///usr/share/xml/docbook/schema/dtd/4.4/docbookx.dtd">
   5
   6 <appendix id="user-psf"><title>Point Spread Functions</title>
   7 <p>The ALE Irani-Peleg renderer uses a point-spread function to model the optical
   8 and electronic properties of the capture device used.  The PSF can be specified
   9 in terms of one linear and one non-linear component.</p>
  10
  11 <s><t>PSF specification</t>
  12
  13 <p>The PSF can be explicitly specified by using one or both of the psf options.</p>
  14
  15 <ll>--lpsf &lt;p>        Set linear colorspace point-spread function to &lt;p>
  16 --nlpsf &lt;p>       Set non-linear colorspace point-spread function to &lt;p>
  17 </ll>
  18
  19 <p>Available explicit point-spread functions are as follows:</p>
  20
  21 <ll>box=&lt;d>           Set the PSF to a box filter with diameter &lt;d>.
  22 circle=&lt;d>        Set the PSF to a circular filter with diameter &lt;d>.
  23 stdin             Specify a custom filter at runtime.
  24 stdin_vg          stdin with vertically-oriented gaps after every 8th pixel.
  25 &lt;p>+&lt;p>           Summation of two functions
  26 &lt;p>^&lt;p>           Convolution of two functions.
  27 &lt;n>*&lt;p>           Multiplication by a scalar &lt;n>.
  28 </ll>
  29
  30 <p>If a device is known to ALE, then its PSF can be implicitly set with the
  31 <l>--device</l> option.  (See the <a href="../../device/">device</a> page
  32 for more information.)  If a device is not specified, then the default linear
  33 PSF component is <l>box=1</l>.  The non-linear PSF component is disabled
  34 by default.</p>
  35
  36 </s><s><t>Determining the PSF</t>
  37
  38 <p>The PSF can be approximated based on images of known scenes.  The ALE source
  39 distribution includes an experimental script that numerically approximates the
  40 PSF in this way (<l>d2/render/psf/ale-psf-calibrate</l>).  Other, more
  41 efficient methods for approximating the PSF are likely possible, however.</p>
  42
  43 </s>
  44
  45 </appendix>