Git commit a91d2359445eafa102ab16bc643706d4daaed4c2 by Gilles Caulier. Committed on 23/08/2016 at 11:59. Pushed by cgilles into branch 'master'.
polish M +10 -5 digikam/bqm-mainwindow.docbook M +83 -80 digikam/bqm-rawconverter.docbook M +7 -26 digikam/index.docbook http://commits.kde.org/digikam-doc/a91d2359445eafa102ab16bc643706d4daaed4c2 diff --git a/digikam/bqm-mainwindow.docbook b/digikam/bqm-mainwindow.docbook index caadd85..14f9012 100644 --- a/digikam/bqm-mainwindow.docbook +++ b/digikam/bqm-mainwindow.docbook @@ -1,10 +1,15 @@ -<sect2 id="bqm-mainwindow"> <title>The Batch Queue Manager Window</title> +<sect1 id="bqm-intro"> <title>Introduction to Batch Queue Manager</title> +<anchor id="bqm.anchor"/> - <para> - TODO - </para> + <sect2 id="bqm-mainwindow"> <title>The Batch Queue Manager Window</title> -</sect2> + <para> + TODO + </para> + + </sect2> + +</sect1> <!-- Local Variables: diff --git a/digikam/bqm-rawconverter.docbook b/digikam/bqm-rawconverter.docbook index db7b657..6e9bad0 100644 --- a/digikam/bqm-rawconverter.docbook +++ b/digikam/bqm-rawconverter.docbook @@ -1,83 +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> - -<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> +<sect1 id="bqm-rawconverter"> <title>Batch RAW Workflow</title> + + <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> + + <sect3 id="using-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> + +</sect1> <!-- Local Variables: diff --git a/digikam/index.docbook b/digikam/index.docbook index c5ad937..5643eba 100644 --- a/digikam/index.docbook +++ b/digikam/index.docbook @@ -99,31 +99,22 @@ <chapter id="introduction"> <title>Introduction</title> &doc-intro-background; - &doc-intro-firstrun; - &doc-intro-fileformats; - &doc-intro-camerasupport; - &doc-intro-pluginsupport; - </chapter> +</chapter> <!-- *********************************************************************** --> <chapter id="using-digikam"> <title>Using &digikam;</title> &doc-using-mainwindow; - &doc-using-lighttable; - &doc-using-sidebar; - &doc-using-dam; - &doc-using-camera; - &doc-using-setup; </chapter> @@ -132,28 +123,18 @@ <chapter id="image-editor"> <title>The Image Editor</title> - &doc-editor-using; - &doc-editor-photoediting; - &doc-editor-colormanagement; + &doc-editor-using; + &doc-editor-photoediting; + &doc-editor-colormanagement; </chapter> <!-- ******** BQM ********************************************************** --> -<chapter id="batch-queue-manager"> <title>The Batch Queue Manager</title> - - <sect1 id="bqm-intro"> <title>Introduction to Batch Queue Manager</title> - <anchor id="bqm.anchor"/> - - &doc-bqm-mainwindow; - - </sect1> - - <sect1 id="bqm-workflow"> <title>Batch Photographic Workflow</title> - - &doc-bqm-rawconverter; +<chapter id="batch-queue-manager"> <title>The Batch Queue Manager</title> - </sect1> + &doc-bqm-mainwindow; + &doc-bqm-rawconverter; </chapter>
