  <sect3 id="editor-enhance-restoration" >
    <sect3info>
      <title>Photograph Restoration</title>
      <abstract>
        <para>
          <ulink url="http://cimg.sourceforge.net" >
            <inlinemediaobject>
              <imageobject>
                <imagedata fileref="&path;logo-cimg.png" format="PNG" />
              </imageobject>
              <textobject>
                <phrase>cimglogo</phrase>
              </textobject>
            </inlinemediaobject>
          </ulink>
        </para>
        <para>
&digikam;
The  <emphasis>Photograph Restoration</emphasis> is definitely one of the most advanced tools to reduce photograph artifacts.
</para>
      </abstract>
      <keywordset>
        <keyword>Digikam</keyword>
      </keywordset>
    </sect3info>
    <title>Introduction</title>
    <para>
This fantastic restoration filter is a new development providing unprecedented possibilities in the public domain to remove lots of unwanted stuff from your images. It is well adapted to deal with degraded images suffering from Gaussian noise, film grain, scratches or compression artifacts and local degradations usually encountered in digital (original or digitized) images. The smoothing happens along the image curvatures, thus preserving the meaningful content much alike our human eye would want it.
</para>
    <para>
The same algorithm can be used for colorization and texture replacement which is covered by another tool (inpainting). The restoration algorithm has been developed by the IMAGE team of GREC CNRS lab in Caen/France and is a part of the <ulink url="http://cimg.sourceforge.net" >CImg project</ulink>.
</para>
    <sect4 id="using-restoration" >
      <title>Using the Restoration tool</title>
      <para>
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="&path;editor-restoration.png" format="PNG" />
          </imageobject>
          <textobject>
            <phrase>Photograph Restoration Dialog</phrase>
          </textobject>
        </inlinemediaobject>
      </para>
      <para>The tool comes with several presets as starting points and to simplify the restoration. The preset settings available are listed below:

<itemizedlist>
          <listitem>
            <para>
              <guilabel>None</guilabel>: Using most common default filter settings not optimized for any particular purpose.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Reduce Uniform Noise</guilabel>: Optimum settings for image noise due to sensors.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Reduce JPEG Artifacts</guilabel>: JPEG's compression is not perfect, in fact for some types of images it is far from it. As a lossy compression algorithm, there are some compression &quot;artifacts&quot; - slight defaults showing in the decompressed image. This setting aims at correcting this problem.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Reduce Texturing</guilabel>: Optimized to remove artifacts from scanning, digitizing or Moire patterns.</para>
          </listitem>
        </itemizedlist>
      </para>
      <para>If you want to set filter parameters for finer adjustments, use <guilabel>Smoothing Settings</guilabel> and <guilabel>Advanced Settings</guilabel> tabs:</para>
      <para>
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="&path;editor-restoration-settings1.png" format="PNG" />
          </imageobject>
          <textobject>
            <phrase>The Restoration Smoothing Settings</phrase>
          </textobject>
        </inlinemediaobject>
      </para>
      <para>
        <itemizedlist>
          <listitem>
            <para>
              <guilabel>Detail Preservation</guilabel> p [0, 100]: this controls the preservation of the curvatures (features). A low value forces an equal smoothing across the image, whereas bigger values preferably smooth the homogeneous regions and leaves the details sharper. A value of 0.9 should well preserve details so that no sharpening is required afterwards. Note that <guilabel>Detail Preservation</guilabel> must be always inferior to <guilabel>Anisotropy</guilabel>.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Anisotropy</guilabel> alpha [0, 100]: a low value smooths equally in all directions, whereas a value close to 1 smooths in one direction only. If you have film grain or CCD kind of noise a high value will result in wave-like pattern, whereas JPEG artifacts are suited for values close to 1. </para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Smoothing</guilabel> [0, 500]: this sets the maximum overall smoothing factor (when p defines the relative smoothing). Set it according to the noise level.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Regularity</guilabel> [0, 100]: this parameter is concerned with the uniformity of the smoothing. Imagine the smoothing process as a combing of the image. Then the Regularity would correspond to the size of the comb. The bigger this value, the more even the overall smoothing will be. This is necessary when much noise is present since it is then difficult to estimate the local geometry. Also if you want to achieve a 'van Gogh' turbulence effect, setting it higher than 3 is recommended.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Filter Iterations</guilabel>: number of times the blurring algorithm is applied. Usually 1 or 2 is sufficient.</para>
          </listitem>
        </itemizedlist>
      </para>
      <para>
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="&path;editor-restoration-settings2.png" format="PNG" />
          </imageobject>
          <textobject>
            <phrase>The Restoration Advanced Settings</phrase>
          </textobject>
        </inlinemediaobject>
      </para>
      <para>
        <itemizedlist>
          <listitem>
            <para>
              <guilabel>Angular Step</guilabel> da [5, 90]: angular integration of the anisotropy alpha. If alpha is chosen small, da should also be chosen small. But beware, small angles result in long runs! Choose it as large as you can accept. </para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Integral Step</guilabel> [0.1, 10]: spatial integration step width in terms of pixels. Should remain less than 1 (sub-pixel smoothing) and never be higher than 2.</para>
          </listitem>
          <listitem>
            <para>
              <guilabel>Use Linear Interpolation</guilabel>: The gain in quality if you select this option is only marginal and you lose a factor of 2 in speed. Our recommendation is to leave it off.</para>
          </listitem>
        </itemizedlist>
      </para>
      <para>
        <guilabel>Save As...</guilabel> and <guilabel>Load...</guilabel> buttons are used to do just that. Any Photograph Restoration filter settings that you have set can be saved to the filesystem in a text file and loaded later.
</para>
      <warning>
        <para>
Photograph restoration is (comparatively) very fast in what it is doing, but it can take a long time to run and cause high CPU load. You may always abort computation by pressing <guilabel>Abort</guilabel> button during preview rendering.
</para>
      </warning>
    </sect4>
    <sect4 id="inaction-restoration" >
      <title>The Restoration tool in action</title>
      <para>
Below, you can see a <guilabel>Reduce Uniform Noise</guilabel> Restoration type applied to a Black and White photograph taken with a Minolta(tm) 700Si camera using Ilford(tm) HP-5 film set at 3200 ISO sensitivity. You see the very prominent film grain on the faces. The original image is (1), the corrected image (2).
</para>
      <para>
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="&path;editor-restoration-preview1.png" format="PNG" />
          </imageobject>
          <textobject>
            <phrase>Reduce Uniform Noise Restoration Preview</phrase>
          </textobject>
        </inlinemediaobject>
      </para>
      <para>
Below, you can see an another Photograph Restoration example using <guilabel>Reduce Texturing</guilabel> Restoration type applied to an old color photograph acquire with a digital flat scanner. You see the very prominent artifacts resulting of scanner light on plastic photograph paper. The original image is (1), the corrected image (2).
</para>
      <para>
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="&path;editor-restoration-preview2.png" format="PNG" />
          </imageobject>
          <textobject>
            <phrase>Reduce Texturing Restoration Preview</phrase>
          </textobject>
        </inlinemediaobject>
      </para>
    </sect4>
  </sect3>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
