[digikam-doc] digikam: add new chapter about bqm + some description about Batch Raw Conversion

[Gilles Caulier]

Git commit c956dffcb25453ea0a6abab0f5380cbbe4881aa8 by Gilles Caulier.
Committed on 22/08/2016 at 14:11.
Pushed by cgilles into branch 'master'.

add new chapter about bqm + some description about Batch Raw Conversion

A  +86   -0    digikam/bqm-rawconverter.docbook
M  +18   -0    digikam/index.docbook

http://commits.kde.org/digikam-doc/c956dffcb25453ea0a6abab0f5380cbbe4881aa8

diff --git a/digikam/bqm-rawconverter.docbook b/digikam/bqm-rawconverter.docbook
new file mode 100644
index 0000000..bfec296
--- /dev/null
+++ b/digikam/bqm-rawconverter.docbook
@@ -0,0 +1,86 @@
+<sect2> <title>Raw Image Convertion</title>
+    
+<sect3><title>Introduction to Raw Converter</title>
+
+<para>
+With the Batch Queue Manager, you can import/convert your images stored in
+<emphasis>RAW format</emphasis> to a target formats as (<guilabel>JPEG</guilabel>,
+<guilabel>TIFF</guilabel>, or <guilabel>PNG</guilabel>).
+</para>
+
+<para>There are ome considerations before your convert, and even before you shoot
+in raw format. RAW image file formats keep the original information of the exposure
+supposedly without loss (when compressed, they use reversible, lossless compressions
+algorithms). Many photographers prefer to take their picture in RAW mode because
+the camera's built-in conversion program is often of lesser quality than what
+you can achieve with digital image processing. The whitebalance of the digital
+camera is registered but not applied to the image. Some CMOS CCD's create four
+types of color filter data: RGBG, Red, Green, Blue and another Green mask for
+contrast enhancement. This tool can take this into account.
+</para>
+
+<para>
+The conversion is actually based on <command>libraw</command>. Don't expect to produce the same images
+as software provided by the camera vendor but sometimes libraw gives better results.
+</para>
+
+<sect3 id="using-plugin-rawconverter">
+<title>Using Raw Converter</title>
+
+<para>
+Select the RAW files to convert and load them to a dedicate batch queue.
+</para>
+
+<para>
+In Batch Queue Manager settings view, you can adjust the available check and value boxes
+to optimize the RAW conversion process. The first checkbox indicates to use the camera 
+settings for white balance.
+The essential parameters like brightness, and red/blue amplifier may be adjusted.
+If the result is not quite optimal, don't worry, it is always possible to fine-tune
+the image later on.
+</para>
+
+<para>
+A <guilabel>Four color RGBG</guilabel> conversion can be selected to use contrast
+information. (If your camera works in RGB mode, the RGBG setting has no effect).
+</para>
+
+<para>You must choose one output formats to save the conversion result by placing the
+target file format convertion tool. The file name will stay the same by default, only the extension changes.
+<guilabel>JPEG</guilabel> uses the lossy algorithm and produces the smallest output
+file size. In opposite the tagged image format (<guilabel>TIFF</guilabel>) preserves all information of
+your image while using lossless LZW compression.
+</para>
+
+<tip><para>
+If you intend to work a lot on your images or if it is likely that you have to
+reuse it later on, then don't use <guilabel>JPEG</guilabel> format because it
+allows a limited number of operations before it deterioates visibly.
+<guilabel>TIFF</guilabel> and <guilabel>PNG</guilabel> are better suited to keep
+the original data.
+</para></tip>
+
+<note><para>
+If you choose <guilabel>JPEG</guilabel>, or <guilabel>TIFF</guilabel>, or <guilabel>PNG</guilabel> as the <guilabel>Save Format</guilabel> then the meta-data included in RAW file will be included in the target
+files as Exif information.
+</para></note>
+
+<para>
+When you have finished to setup the queue, click the <guibutton>Process</guibutton> button to start the
+conversion. If you want abort image conversion, press the <guibutton>Abort</guibutton>
+button.
+</para>
+
+<!-- TODO : add a screenshot of BQM RAW conversion in action -->
+
+</sect3>
+
+</sect2>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
diff --git a/digikam/index.docbook b/digikam/index.docbook
index 49cd8d8..e7e2d9b 100644
--- a/digikam/index.docbook
+++ b/digikam/index.docbook
@@ -2387,6 +2387,24 @@ Fun stuff
 
 </chapter>
 
+<!-- ******** BQM ********************************************************** -->
+
+<chapter id="batch-queue-manager">     <title>The Batch Queue Manager</title>
+
+ <sect1 id="using-bqm">        <title>Introduction to Batch Queue Manager</title>
+      <anchor id="bqm.anchor"/>
+
+        <sect2 id="bqm-window"> <title>The Batch Queue Manager Window</title>
+            <para>
+                TODO
+            </para>
+
+        </sect2>
+
+    </sect1>
+
+</chapter>
+
 <!-- ******** MISC TOOLS *************************************************** -->
 
 &doc-tool-acquireimages;