Git commit b3b4e5bdceca2f2a2e00e112382b80fcd26b7bf3 by Gilles Caulier. Committed on 22/08/2016 at 14:10. Pushed by cgilles into branch 'master'.
remove obsolete handbooks D +0 -62 colorimages.docbook D +0 -52 convertimages.docbook D +0 -68 effectimages.docbook D +0 -59 filterimages.docbook M +0 -30 index.docbook D +- -- raw_converter_batch.png D +- -- raw_converter_single.png D +0 -152 rawconverter.docbook D +0 -49 recompressimages.docbook http://commits.kde.org/kipi-plugins-doc/b3b4e5bdceca2f2a2e00e112382b80fcd26b7bf3 diff --git a/colorimages.docbook b/colorimages.docbook deleted file mode 100644 index 92ec1cb..0000000 --- a/colorimages.docbook +++ /dev/null @@ -1,62 +0,0 @@ -<chapter id="colorimages"> -<chapterinfo> - -<authorgroup> - <author> - <firstname>Gilles</firstname><surname>Caulier</surname> - <affiliation><address><email>caulier dot gilles at gmail dot com</email></address></affiliation> - </author> -</authorgroup> - -<abstract> -<para> -The Kipi Color Images plugin is a tool to change or improve the images' color rendering. -</para> -</abstract> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Kipi</keyword> -</keywordset> -</chapterinfo> - -<title>Color Images</title> - -<para> - -This plugin can be used for batch colors enhancement of images in an Album. - It uses the <command>convert</command> program from the -<application>ImageMagick</application> package. A plugin effect - preview (partial or full) is available. - Ten color filter types are available: - -</para> - -<itemizedlist> -<listitem><para><guilabel>Decrease Contrast</guilabel>: reduces the image contrast.</para></listitem> -<listitem><para><guilabel>Depth</guilabel>: changes the color depth of the image.</para></listitem> -<listitem><para><guilabel>Equalize</guilabel>: performs histogram equalization to the image.</para></listitem> -<listitem><para><guilabel>Fuzz</guilabel>: merges colors within a distance are considered equal.</para></listitem> -<listitem><para><guilabel>Gray scales</guilabel>: converts colors images to gray scales image.</para></listitem> -<listitem><para><guilabel>Increase Contrast</guilabel>: enhances the image contrast.</para></listitem> -<listitem><para><guilabel>Monochrome</guilabel>: transforms the image to black and white.</para></listitem> -<listitem><para><guilabel>Negate</guilabel>: replaces every pixel with its complementary color.</para></listitem> -<listitem><para><guilabel>Normalize</guilabel>: transforms image to span the full range of color values.</para></listitem> -<listitem><para><guilabel>Segment</guilabel>: segments an image by analyzing the histograms of the color components.</para></listitem> -<listitem><para><guilabel>Trim</guilabel>: trims an image (fuzz reverse technic).</para></listitem> -</itemizedlist> - -<para> -<ulink url="http://digikamplugins.free.fr/ImagesGallerySamples/MultipleAlbums/ColorImages/index.html";> -You can see some samples built with this plugin at this &URL;.</ulink></para> - -</chapter> - -<!-- -Local Variables: -mode: sgml -sgml-omittag: nil -sgml-shorttag: t -End: ---> - diff --git a/convertimages.docbook b/convertimages.docbook deleted file mode 100644 index b39bfdc..0000000 --- a/convertimages.docbook +++ /dev/null @@ -1,52 +0,0 @@ -<chapter id="convertimages"> -<chapterinfo> - -<authorgroup> - <author> - <firstname>Gilles</firstname><surname>Caulier</surname> - <affiliation><address><email>caulier dot gilles at gmail dot com</email></address></affiliation> - </author> -</authorgroup> - -<abstract> -<para> -The Kipi Convert Images plugin is a tool to convert an image file format to another. -</para> -</abstract> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Kipi</keyword> -</keywordset> -</chapterinfo> - -<title>Convert Images</title> - -<para> - -This plugin can be used for batch conversion of images in an Album. -It uses the <command>convert</command> program from the -<application>ImageMagick</application> package. The following image file formats -are supported: -</para> - -<itemizedlist> -<listitem><para>JPEG</para></listitem> -<listitem><para>PNG</para></listitem> -<listitem><para>PPM</para></listitem> -<listitem><para>BMP</para></listitem> -<listitem><para>TIFF</para></listitem> -<listitem><para>TGA</para></listitem> -<listitem><para>EPS</para></listitem> -</itemizedlist> - -</chapter> - -<!-- -Local Variables: -mode: sgml -sgml-omittag: nil -sgml-shorttag: t -End: ---> - diff --git a/effectimages.docbook b/effectimages.docbook deleted file mode 100644 index ea21468..0000000 --- a/effectimages.docbook +++ /dev/null @@ -1,68 +0,0 @@ -<chapter id="effectimages"> -<chapterinfo> - -<authorgroup> - <author> - <firstname>Gilles</firstname><surname>Caulier</surname> - <affiliation><address><email>caulier dot gilles at gmail dot com</email></address></affiliation> - </author> -</authorgroup> - -<abstract> -<para> -The Kipi Effect Images plugin is a tool for to add a special effect to the images. -</para> -</abstract> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Kipi</keyword> -</keywordset> -</chapterinfo> - -<title>Effect Images</title> - -<para> - -This plugin can be used for batch FX transforming images in an Album. - It uses the <command>convert</command> program from the - <application>ImageMagick</application> package. An image effect - preview (partial or full) is also available. - Eleven FX filter types have been implemented: -</para> - -<itemizedlist> -<listitem><para><guilabel>Adaptive threshold</guilabel>: perform local adaptive - thresholding.</para></listitem> -<listitem><para><guilabel>Charcoal</guilabel>: simulate a charcoal drawing.</para></listitem> -<listitem><para><guilabel>Detect edges</guilabel>: detect edges within an image.</para></listitem> -<listitem><para><guilabel>Emboss</guilabel>: returns a grayscale image with a - three-dimensional effect.</para></listitem> -<listitem><para><guilabel>Implode</guilabel>: implode image pixels about the center.</para></listitem> -<listitem><para><guilabel>Paint</guilabel>: applies a special effect filter that - simulates an oil painting.</para></listitem> -<listitem><para><guilabel>Shade light</guilabel>: shines a distant light on an image - to create a three-dimensional effect.</para></listitem> -<listitem><para><guilabel>Solarize</guilabel>: negate all pixels above the threshold level.</para></listitem> -<listitem><para><guilabel>Spread</guilabel>: this is a special effects method that -randomly displaces each pixel in a block defined by the radius parameter.</para></listitem> -<listitem><para><guilabel>Swirl</guilabel>: swirls the pixels about the center of the image.</para></listitem> -<listitem><para><guilabel>Wave</guilabel>: creates a ripple effect in the image - by shifting the pixels vertically along a sine wave.</para></listitem> -</itemizedlist> - -<para> -<ulink url="http://digikamplugins.free.fr/ImagesGallerySamples/MultipleAlbums/EffectImages/index.html";> -You can see some samples built with this plugin at this &URL;</ulink> -</para> - -</chapter> - -<!-- -Local Variables: -mode: sgml -sgml-omittag: nil -sgml-shorttag: t -End: ---> - diff --git a/filterimages.docbook b/filterimages.docbook deleted file mode 100644 index a9cfced..0000000 --- a/filterimages.docbook +++ /dev/null @@ -1,59 +0,0 @@ -<chapter id="filterimages"> -<chapterinfo> - -<authorgroup> - <author> - <firstname>Gilles</firstname><surname>Caulier</surname> - <affiliation><address><email>caulier dot gilles at gmail dot com</email></address></affiliation> - </author> -</authorgroup> - -<abstract> -<para> -The Kipi Filter Images plugin is a tool for to apply a digital filter to the images. -</para> -</abstract> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Kipi</keyword> -</keywordset> -</chapterinfo> - -<title>Filter Images</title> - -<para> -This plugin can be used for batch filter images in an Album. - It uses the <command>convert</command> program from the - <application>ImageMagick</application> package. An image effect - preview (partial or full) is available. - Nine filter types have been implemented: -</para> - -<itemizedlist> -<listitem><para><guilabel>Add noise</guilabel>: add noise in an image.</para></listitem> -<listitem><para><guilabel>Antialias</guilabel>: remove pixel aliasing.</para></listitem> -<listitem><para><guilabel>Blur</guilabel>: blur the image with a Gaussian operator.</para></listitem> -<listitem><para><guilabel>Despeckle</guilabel>: reduce the speckles within an image.</para></listitem> -<listitem><para><guilabel>Enhance</guilabel>: apply a digital filter to enhance a noisy image.</para></listitem> -<listitem><para><guilabel>Median</guilabel>: apply a median filter to an image.</para></listitem> -<listitem><para><guilabel>Noise reduction</guilabel>: reduce noise in an image.</para></listitem> -<listitem><para><guilabel>Sharpen</guilabel>: sharpen the image with a Gaussian operator.</para></listitem> -<listitem><para><guilabel>Unsharp</guilabel>: sharpen the image with an unsharp mask operator.</para></listitem> -</itemizedlist> - -<para> -<ulink url="http://digikamplugins.free.fr/ImagesGallerySamples/MultipleAlbums/FilterImages/index.html";> -You can see some samples building with this plugin at this &URL;</ulink> -</para> - -</chapter> - -<!-- -Local Variables: -mode: sgml -sgml-omittag: nil -sgml-shorttag: t -End: ---> - diff --git a/index.docbook b/index.docbook index 99d9ece..4bac61f 100644 --- a/index.docbook +++ b/index.docbook @@ -4,15 +4,9 @@ <!ENTITY package "extragear-graphics"> <!ENTITY % addindex "IGNORE"> <!ENTITY % English "INCLUDE" > <!-- change language only here --> - <!ENTITY doc-colorimages SYSTEM "colorimages.docbook"> - <!ENTITY doc-convertimages SYSTEM "convertimages.docbook"> - <!ENTITY doc-effectimages SYSTEM "effectimages.docbook"> - <!ENTITY doc-filterimages SYSTEM "filterimages.docbook"> <!ENTITY doc-flickrexport SYSTEM "flickrexport.docbook"> <!ENTITY doc-imagesgallery SYSTEM "imagesgallery.docbook"> <!ENTITY doc-printwizard SYSTEM "printwizard.docbook"> - <!ENTITY doc-rawconverter SYSTEM "rawconverter.docbook"> - <!ENTITY doc-recompressimages SYSTEM "recompressimages.docbook"> <!ENTITY doc-resizeimages SYSTEM "resizeimages.docbook"> <!ENTITY doc-sendimages SYSTEM "sendimages.docbook"> ]> @@ -75,18 +69,6 @@ The plugins available in this handbook are: <itemizedlist> <listitem> -<para><link linkend="colorimages">Color Images plugin</link></para> -</listitem> -<listitem> -<para><link linkend="convertimages">Convert Images plugin</link></para> -</listitem> -<listitem> -<para><link linkend="effectimages">Effect Images plugin</link></para> -</listitem> -<listitem> -<para><link linkend="filterimages">Filter Images plugin</link></para> -</listitem> -<listitem> <para><link linkend="flickrexport">Remote Flickr Export plugin</link></para> </listitem> <listitem> @@ -96,12 +78,6 @@ The plugins available in this handbook are: <para><link linkend="printwizard">Print Wizard plugin</link></para> </listitem> <listitem> -<para><link linkend="rawconverter">Raw Converter plugin</link></para> -</listitem> -<listitem> -<para><link linkend="recompressimages">Recompress Images plugin</link></para> -</listitem> -<listitem> <para><link linkend="resizeimages">Resize Images plugin</link></para> </listitem> <listitem> @@ -117,15 +93,9 @@ please contact the Kipi team mailing list at <email>[email protected]</email>. </chapter> -&doc-colorimages; -&doc-convertimages; -&doc-effectimages; -&doc-filterimages; &doc-flickrexport; &doc-imagesgallery; &doc-printwizard; -&doc-rawconverter; -&doc-recompressimages; &doc-resizeimages; &doc-sendimages; diff --git a/raw_converter_batch.png b/raw_converter_batch.png deleted file mode 100644 index ca6e4d9..0000000 Binary files a/raw_converter_batch.png and /dev/null differ diff --git a/raw_converter_single.png b/raw_converter_single.png deleted file mode 100644 index 2eda213..0000000 Binary files a/raw_converter_single.png and /dev/null differ diff --git a/rawconverter.docbook b/rawconverter.docbook deleted file mode 100644 index d2daafe..0000000 --- a/rawconverter.docbook +++ /dev/null @@ -1,152 +0,0 @@ -<chapter id="rawconverter"> -<chapterinfo> - -<authorgroup> - <author> - <firstname>Gilles</firstname><surname>Caulier</surname> - <affiliation><address><email>caulier dot gilles at gmail dot com</email></address></affiliation> - </author> - - <author> - <firstname>Gerhard</firstname><surname>Kulzer</surname> - <affiliation><address><email>gerhard_at_kulzer.net</email></address></affiliation> - </author> -</authorgroup> - -<abstract> -<para> -The Kipi <quote>Raw Image Converter</quote> plugin is a conversion tool for raw format images. -</para> -</abstract> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Kipi</keyword> -</keywordset> -</chapterinfo> - -<title>Raw Image Converter</title> - -<para> -With this Kipi-plugin you can import/convert your images stored in -<emphasis>RAW format</emphasis> to three formats (<guilabel>JPEG</guilabel>, -<guilabel>TIFF</guilabel>, <guilabel>PPM</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. The plugin can take this into account. -</para> - -<para> -The conversion is actually based on Dave Coffin's command line tool -<command>dcraw</command> (Dave: <quote>Don't expect dcraw to produce the same images -as software provided by the camera vendor. Sometimes dcraw gives better results!</quote>). -</para> - -<sect1 id="using-plugin-rawconversiondialog"> -<title>Single Conversion Dialog</title> - -<para> -Select the RAW file to convert and open the plugin from the host application. -The <emphasis>Raw Image Converter</emphasis> window in single mode will appear. -Click on <guilabel>Preview</guilabel> to show the effect of your settings taking shape. -</para> - -<para> -Now you can adjust the available check and value boxes to optimize the 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>If you're happy with the preview, choose one of three output formats to save -the conversion result. The file name will stay the same, only the extension changes. -<guilabel>JPEG</guilabel> uses the lossy algorithm and produces the smallest output -file size. -</para> - -<para> -The tagged image format (<guilabel>TIFF</guilabel>) preserves all information of -your image while using lossless LZW compression. -</para> - -<para> -The Portable PixMap format (<guilabel>PPM</guilabel>) produces the largest output -file and contains most data. -</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>PPM</guilabel> are better suited to keep -the original data. -</para></tip> - -<note><para> -If you choose <guilabel>JPEG</guilabel> as the <guilabel>Save Format</guilabel> -then the meta-data included in RAW file will be included in the <guilabel>JPEG</guilabel> -files as Exif information. -</para></note> - -<para> -When you have finished click the <guibutton>Process</guibutton> button to start the -conversion. If you want abort image conversion, press the <guibutton>Abort</guibutton> -button. -</para> - -<figure id="rawconverter-dialog-single"> - <title>The RAW Converter Dialog in Single Mode</title> - <mediaobject><imageobject> - <imagedata srccredit="The RAW Converter Dialog in Single Mode" fileref="raw_converter_single.png"/> - </imageobject></mediaobject> -</figure> - -</sect1> - -<sect1 id="using-plugin-rawbatchdialog"> -<title>Batch Conversion Dialog</title> - -<para> -The batch mode converter allows you to convert several images in one go. Use this -mode when you're are sure of the best settings, ⪚ try it out in single conversion mode first. -</para> - -<para> -The available setting are mostly identical to the single mode dialog. Here you have -the additional option to overwrite existing files (which you might have created in -an earlier try). The preview option is not available here. A progress bar indicates -the conversion status. -</para> - -<figure id="rawconverter-batch-dialog"> - <title>The Batch RAW Converter Dialog</title> - <mediaobject><imageobject> - <imagedata srccredit="The Batch RAW Converter Dialog" fileref="raw_converter_batch.png"/> - </imageobject></mediaobject> -</figure> - -</sect1> - -</chapter> - -<!-- -Local Variables: -mode: sgml -sgml-omittag: nil -sgml-shorttag: t -End: ---> diff --git a/recompressimages.docbook b/recompressimages.docbook deleted file mode 100644 index 3f7f6a2..0000000 --- a/recompressimages.docbook +++ /dev/null @@ -1,49 +0,0 @@ -<chapter id="recompressimages"> -<chapterinfo> - -<authorgroup> - <author> - <firstname>Gilles</firstname><surname>Caulier</surname> - <affiliation><address><email>caulier dot gilles at gmail dot com</email></address></affiliation> - </author> -</authorgroup> - -<abstract> -<para> -The Kipi recompress images plugin is a tool for recompressing the image files. -</para> -</abstract> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Kipi</keyword> -</keywordset> -</chapterinfo> - -<title>Recompress Images</title> - -<para> - -This plugin can be used to batch recompress images in an Album. It uses the -<command>convert</command> program from the <application>ImageMagick</application> -package. The image file formats supported are: - -</para> - -<itemizedlist> -<listitem><para>JPEG</para></listitem> -<listitem><para>PNG</para></listitem> -<listitem><para>TIFF</para></listitem> -<listitem><para>TGA</para></listitem> -</itemizedlist> - -</chapter> - -<!-- -Local Variables: -mode: sgml -sgml-omittag: nil -sgml-shorttag: t -End: ---> -
