<chapter status="final" id="darkroom_chapter">

  <chapterinfo>
    <keywordset>
      <keyword>darkroom</keyword>
      <keyword>view</keyword>
    </keywordset>
  </chapterinfo>

  <title>Darkroom</title>

  <indexterm>
    <primary>darkroom</primary>
  </indexterm>

  <para>
    The darkroom view is where you develop your image.
  </para>

  <para>
    <screenshot>

      <screeninfo>The darkroom view</screeninfo>

      <graphic fileref="images/darkroom_view.png" scalefit="1" width="80%"></graphic>

    </screenshot>
  </para>

  <sect1 status="final">

    <title>Overview</title>

    <para>
      Darkroom mode is for photographic development of the image that you selected from the
      lighttable. Numerous tools, named modules, are available for processing that image.
    </para>

    <para>
      On the left hand side you have navigation, snapshot, history stack, color picker, tagging,
      image information and mask manager panels, described in <xref linkend="darkroom_panels"/>.
      In the right hand panel you can see the histogram and a list of modules available for
      working with the image. At the bottom of the right hand panel you can enable/disable the
      view of individual modules.
    </para>

    <indexterm>
      <primary>zoom</primary>
    </indexterm>

    <para>
      You can use <emphasis>middle-click</emphasis> to zoom 1:1. A double
      <emphasis>middle-click</emphasis> takes you to 2:1. Alternatively you can zoom in and out
      between 1:1 and fit-to-screen by mouse scrolling. Mouse scrolling while holding the
      control key pressed gives an extended zoom range between 2:1 and 1:10.
    </para>

    <para>
      You normally export multiple images from the lighttable view but you can also export the
      current image directly from the darkroom by using the shortcut
      <emphasis>ctrl-e</emphasis>. Export parameters are then those currently selected in the
      lighttable.
    </para>

  </sect1>

<!-- Darkroom concepts -->

  <xi:include href="concepts/concepts.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>

<!-- Panels -->

  <xi:include href="panels/panels.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>

<!-- Modules -->

  <xi:include href="modules/modules.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>

<!-- Examples -->

  <xi:include href="examples/examples.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>

</chapter>