Additional pixbuf loader documentation
authorColin Clark <colin.clark@cclark.uk>
Thu, 16 Nov 2017 10:07:31 +0000 (10:07 +0000)
committerColin Clark <colin.clark@cclark.uk>
Thu, 16 Nov 2017 10:07:31 +0000 (10:07 +0000)
Also update web/help files

README.md
doc/docbook/GuideReferencePixbufLoaders.xml
web/help/GuideMainWindowFolderPane.html
web/help/GuideMainWindowMenus.html
web/help/GuideOptionsBehavior.html
web/help/GuideOptionsImage.html
web/help/GuideReferencePixbufLoaders.html
web/installing.html

index 05128c2..bb3698f 100644 (file)
--- a/README.md
+++ b/README.md
@@ -204,6 +204,14 @@ And either the ChangeLog file or [Geeqie ChangeLog](http://geeqie.org/cgi-bin/gi
         enabled by default
         disable with configure option: --disable-lua
 
+    librsvg2-common
+        for displaying .svg images
+
+    libwmf0.2-7-gtk
+        for displaying .wmf images
+
+    (see also "Additional pixbuf loaders" in the References section of the Help file)
+
     awk
         when running Geeqie, to use the geo-decode function
 
index 79e891d..6c6a646 100644 (file)
@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="utf-8"?>\r
 <section id="GuideReferencePixbufLoaders">\r
   <title id="titleGuideReferencePixbufLoaders">Additional pixbuf loaders</title>\r
-  <para>\r
-    Geeqie is limited to displaying files for which there are existing pixbuf loaders. In addition to the standard ones included with most distributions, the following loaders may also work.\r
-    <para />\r
-    However, you are required to compile and install them yourself.\r
-  </para>\r
+  <para>Geeqie can display files for which there are existing pixbuf loaders. In addition to the standard ones included with most distributions, the following loaders may also be available to you.</para>\r
+  <para>However, in some cases you are required to compile and install them yourself.</para>\r
+  <section id="svg">\r
+    <title>svg</title>\r
+    <para>librsvg2-common</para>\r
+  </section>\r
+  <section id="wmf">\r
+    <title>wmf</title>\r
+    <para>libwmf0.2-7-gtk</para>\r
+  </section>\r
   <section id="webp">\r
     <title>webp</title>\r
     <para>\r
index 3a9702d..59b0d67 100644 (file)
@@ -860,31 +860,42 @@ dd.answer div.label { float: left; }
 <td class="td-colsep td-rowsep"></td>
 <td class="td-colsep td-rowsep">Copy path</td>
 <td class="td-rowsep">
-              <span class="para">Copy sjkhsdlfjhvfljhDelete file or folder</span>
+              <span class="para">
+                Copy selected item-path(s) to clipboard
+                <a name="-noteref-ref1"></a><sup><a class="footnote" href="#ref1">1</a></sup>
+                . Each data item copied will be enclosed in quotes.
+              </span>
             </td>
 </tr>
 <tr class="tr-shade">
 <td class="td-colsep td-rowsep"></td>
+<td class="td-colsep td-rowsep">Copy path unquoted</td>
+<td class="td-rowsep">
+              <span class="para">Copy selected item-path(s) to clipboard. The data will not be enclosed in quotes.</span>
+            </td>
+</tr>
+<tr>
+<td class="td-colsep td-rowsep"></td>
 <td class="td-colsep td-rowsep">View as list</td>
 <td class="td-rowsep">
               <span class="para">Switches to list tree mode of the folder pane.</span>
             </td>
 </tr>
-<tr>
+<tr class="tr-shade">
 <td class="td-colsep td-rowsep"></td>
 <td class="td-colsep td-rowsep">View as tree</td>
 <td class="td-rowsep">
               <span class="para">Switches to tree mode of the folder pane.</span>
             </td>
 </tr>
-<tr class="tr-shade">
+<tr>
 <td class="td-colsep td-rowsep"></td>
 <td class="td-colsep td-rowsep">Show hiden files</td>
 <td class="td-rowsep">
               <span class="para">Switches to list tree mode of the folder pane.</span>
             </td>
 </tr>
-<tr>
+<tr class="tr-shade">
 <td class="td-colsep">
               <span class="guiicon">
                 <span class="inlinegraphic"><img src="view-refresh.png"></span>
@@ -915,6 +926,11 @@ dd.answer div.label { float: left; }
     </p>
 <p class="para block"></p>
 </div>
+<div class="footnotes"><div class="footnote">
+<a name="ref1"></a><span class="footnote-number"><a class="footnote-ref" href="#-noteref-ref1">1</a></span>
+                  The clipboard used is selected
+                  <a class="link" href="GuideOptionsBehavior.html#Behaviour" title="Behavior">here.</a>
+                </div></div>
 </div></div>
 <div class="navbar navbar-bottom"><table class="navbar"><tr>
 <td class="navbar-prev"><a class="navbar-prev" href="GuideMainWindowFilePane.html" title="File Pane">File Pane</a></td>
index ae46803..3a0e4fa 100644 (file)
@@ -711,7 +711,17 @@ dd.answer div.label { float: left; }
           <span class="menuchoice"><span class="guimenu">Copy path</span></span>
         </dt>
 <dd>
-          <p class="para block block-first">Copy selected item path to clipboard.</p>
+          <p class="para block block-first">
+            Copy selected item-path(s) to clipboard
+            <a name="-noteref-ref1"></a><sup><a class="footnote" href="#ref1">1</a></sup>
+            . Each data item copied will be enclosed in quotes.
+          </p>
+        </dd>
+<dt class="term">
+          <span class="menuchoice"><span class="guimenu">Copy path unquoted</span></span>
+        </dt>
+<dd>
+          <p class="para block block-first">Copy selected item-path(s) to clipboard. The data will not be enclosed in quotes.</p>
         </dd>
 <dt class="term">
           <span class="menuchoice"><span class="guimenu">Show marks</span> <span class="shortcut">(
@@ -1362,6 +1372,11 @@ dd.answer div.label { float: left; }
       descibes how to modify the keyboard shortcuts used in the main menu.
     </p>
 </div>
+<div class="footnotes"><div class="footnote">
+<a name="ref1"></a><span class="footnote-number"><a class="footnote-ref" href="#-noteref-ref1">1</a></span>
+              The clipboard used is selected
+              <a class="link" href="GuideOptionsBehavior.html#Behaviour" title="Behavior">here.</a>
+            </div></div>
 </div></div>
 <div class="navbar navbar-bottom"><table class="navbar"><tr>
 <td class="navbar-prev"><a class="navbar-prev" href="GuideMainWindowNavigation.html" title="Navigation">Navigation</a></td>
index 196dda4..0f5c786 100644 (file)
@@ -585,6 +585,28 @@ dd.answer div.label { float: left; }
 <dd>
           <p class="para block block-first">This is the width and height of the icon generated from image and displayed when doing drag and drop actions. High resolution screens may require to increase this number.</p>
         </dd>
+<dt class="term">
+          <span class="guilabel">Copy path clipboard selection</span>
+        </dt>
+<dd>
+          <p class="para block block-first">
+            This option determines which clipboard selection is used for the "Copy path" menu item. The exact method of the paste operation will depend on the operating system, but in general will be:
+            <div class="block list variablelist"><dl class="variablelist">
+<dt class="term dt-first">
+                  <span class="guilabel">PRIMARY</span>
+                </dt>
+<dd>
+                  <p class="para block block-first">Paste using mouse middle-click, or shift-insert.</p>
+                </dd>
+<dt class="term">
+                  <span class="guilabel">CLIPBOARD</span>
+                </dt>
+<dd>
+                  <p class="para block block-first">Paste using mouse right-click and select paste, or control-v.</p>
+                </dd>
+</dl></div>
+          </p>
+        </dd>
 </dl></div>
 </div>
 <div class="division section">
index b16ffd5..13ab9d3 100644 (file)
@@ -462,10 +462,13 @@ dd.answer div.label { float: left; }
 <span class="label">11.2.1. </span><a class="xref" href="GuideOptionsImage.html#Zoom" title="Zoom">Zoom</a>
 </li>
 <li>
-<span class="label">11.2.2. </span><a class="xref" href="GuideOptionsImage.html#Appearance" title="Appearance">Appearance</a>
+<span class="label">11.2.2. </span><a class="xref" href="GuideOptionsImage.html#FitImageToWindow" title="Fit Image To Window">Fit Image To Window</a>
 </li>
 <li>
-<span class="label">11.2.3. </span><a class="xref" href="GuideOptionsImage.html#Convenience" title="Convenience">Convenience</a>
+<span class="label">11.2.3. </span><a class="xref" href="GuideOptionsImage.html#Appearance" title="Appearance">Appearance</a>
+</li>
+<li>
+<span class="label">11.2.4. </span><a class="xref" href="GuideOptionsImage.html#Convenience" title="Convenience">Convenience</a>
 </li>
 </ul></div>
 <div class="division section">
@@ -524,35 +527,40 @@ dd.answer div.label { float: left; }
           </p>
         </dd>
 <dt class="term">
-          <span class="guilabel">Allow enlargement of image for zoom to fit</span>
+          <span class="guilabel">Zoom increment</span>
+        </dt>
+<dd>
+          <p class="para block block-first">Adjusts the step size when zooming in or out on an image. This value corresponds to the percentage of the original image.</p>
+        </dd>
+</dl></div>
+</div>
+<div class="division section">
+<a name="FitImageToWindow"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.2.2. </span>Fit Image To Window</span></h2></div>
+<div class="block list variablelist"><dl class="variablelist">
+<dt class="term dt-first">
+          <span class="guilabel">Allow enlargement of image (max. size in %)</span>
         </dt>
 <dd>
           <p class="para block block-first">
             Enable this to allow Geeqie to increase the image size for images that are smaller than the current view area when the zoom is set to
             <span class="emphasis">Fit image to window</span>
-            . The value in the adjoining spin box sets the maximum size permitted in percent i.e. 100% is full-size.
+            . This value sets the maximum expansion permitted in percent i.e. 100% is full-size.
           </p>
         </dd>
 <dt class="term">
-          <span class="guilabel">Limit image size when autofitting</span>
+          <span class="guilabel">Virtual window size (% of actual window)</span>
         </dt>
 <dd>
           <p class="para block block-first">
-            This percentage will affect the size of the image when
+            This value will set the virtual size of the window when
             <span class="emphasis">Fit image to window</span>
-            is set. Instead of using 100% of the window, it will use the specified percentage. It allows one to keep a border around the image (values lower than 100%) or to auto zoom the image (values greater than 100%). It affects fullscreen mode too.
+            is set. Instead of using the actual size of the window, the specified percentage of the window will be used. It allows one to keep a border around the image (values lower than 100%) or to auto zoom the image (values greater than 100%). It affects fullscreen mode too.
           </p>
         </dd>
-<dt class="term">
-          <span class="guilabel">Zoom increment</span>
-        </dt>
-<dd>
-          <p class="para block block-first">Adjusts the step size when zooming in or out on an image. This value corresponds to the percentage of the original image.</p>
-        </dd>
 </dl></div>
 </div>
 <div class="division section">
-<a name="Appearance"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.2.2. </span>Appearance</span></h2></div>
+<a name="Appearance"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.2.3. </span>Appearance</span></h2></div>
 <div class="block list variablelist"><dl class="variablelist">
 <dt class="term dt-first">
           <span class="guilabel">Custom border color</span>
@@ -570,7 +578,7 @@ dd.answer div.label { float: left; }
           <div class="admonition block note block-indent"><div class="note-inner">
             <p class="para block block-first">
               You may use the
-              <span class="emphasis">Limit image size when autofitting</span>
+              <span class="emphasis">Virtual window size</span>
               (see above) option to keep a border around the image in fullscreen mode.
             </p>
           </div></div>
@@ -586,7 +594,7 @@ dd.answer div.label { float: left; }
 </dl></div>
 </div>
 <div class="division section">
-<a name="Convenience"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.2.3. </span>Convenience</span></h2></div>
+<a name="Convenience"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.2.4. </span>Convenience</span></h2></div>
 <div class="block list variablelist"><dl class="variablelist">
 <dt class="term dt-first">
           <span class="guilabel">Auto rotate proofs using EXIF information</span>
index 1f6d0fa..8ad4b47 100644 (file)
@@ -458,46 +458,57 @@ dd.answer div.label { float: left; }
 <li class="linktrail linktrail-first"><a class="linktrail" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a></li>
 <li class="linktrail linktrail-last"><a class="linktrail" href="GuideReference.html" title="Reference">Reference</a></li>
 </ul>
-<p class="para block block-first">
-    Geeqie is limited to displaying files for which there are existing pixbuf loaders. In addition to the standard ones included with most distributions, the following loaders may also work.
-    <p class="para block block-first"></p>
-    However, you are required to compile and install them yourself.
-  </p>
+<p class="para block block-first">Geeqie can display files for which there are existing pixbuf loaders. In addition to the standard ones included with most distributions, the following loaders may also be available to you.</p>
+<p class="para block">However, in some cases you are required to compile and install them yourself.</p>
 <div class="autotoc"><ul>
 <li>
-<span class="label">13.10.1. </span><a class="xref" href="GuideReferencePixbufLoaders.html#webp" title="webp">webp</a>
+<span class="label">13.10.1. </span><a class="xref" href="GuideReferencePixbufLoaders.html#svg" title="svg">svg</a>
+</li>
+<li>
+<span class="label">13.10.2. </span><a class="xref" href="GuideReferencePixbufLoaders.html#wmf" title="wmf">wmf</a>
+</li>
+<li>
+<span class="label">13.10.3. </span><a class="xref" href="GuideReferencePixbufLoaders.html#webp" title="webp">webp</a>
 </li>
 <li>
-<span class="label">13.10.2. </span><a class="xref" href="GuideReferencePixbufLoaders.html#xcf" title="xcf">xcf</a>
+<span class="label">13.10.4. </span><a class="xref" href="GuideReferencePixbufLoaders.html#xcf" title="xcf">xcf</a>
 </li>
 <li>
-<span class="label">13.10.3. </span><a class="xref" href="GuideReferencePixbufLoaders.html#psd" title="psd">psd</a>
+<span class="label">13.10.5. </span><a class="xref" href="GuideReferencePixbufLoaders.html#psd" title="psd">psd</a>
 </li>
 <li>
-<span class="label">13.10.4. </span><a class="xref" href="GuideReferencePixbufLoaders.html#jp2" title="JP2/JPC/JPX/J2K/JPF">JP2/JPC/JPX/J2K/JPF</a>
+<span class="label">13.10.6. </span><a class="xref" href="GuideReferencePixbufLoaders.html#jp2" title="JP2/JPC/JPX/J2K/JPF">JP2/JPC/JPX/J2K/JPF</a>
 </li>
 </ul></div>
 <div class="division section">
-<a name="webp"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">13.10.1. </span>webp</span></h2></div>
+<a name="svg"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">13.10.1. </span>svg</span></h2></div>
+<p class="para block block-first">librsvg2-common</p>
+</div>
+<div class="division section">
+<a name="wmf"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">13.10.2. </span>wmf</span></h2></div>
+<p class="para block block-first">libwmf0.2-7-gtk</p>
+</div>
+<div class="division section">
+<a name="webp"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">13.10.3. </span>webp</span></h2></div>
 <p class="para block block-first">
       <div dir="ltr" class=" block programlisting block-indent block-first"><pre class="programlisting">https://github.com/aruiz/webp-pixbuf-loader</pre></div>
     </p>
 <p class="para block"></p>
 </div>
 <div class="division section">
-<a name="xcf"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">13.10.2. </span>xcf</span></h2></div>
+<a name="xcf"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">13.10.4. </span>xcf</span></h2></div>
 <p class="para block block-first">
       <div dir="ltr" class=" block programlisting block-indent block-first"><pre class="programlisting">https://gitorious.org/xcf-pixbuf-loader/mainline?p=xcf-pixbuf-loader:mainline.git;a=summary</pre></div>
     </p>
 </div>
 <div class="division section">
-<a name="psd"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">13.10.3. </span>psd</span></h2></div>
+<a name="psd"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">13.10.5. </span>psd</span></h2></div>
 <p class="para block block-first">
       <div dir="ltr" class=" block programlisting block-indent block-first"><pre class="programlisting">https://cgit.sukimashita.com/gdk-pixbuf-psd.git/</pre></div>
     </p>
 </div>
 <div class="division section">
-<a name="jp2"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">13.10.4. </span>JP2/JPC/JPX/J2K/JPF</span></h2></div>
+<a name="jp2"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">13.10.6. </span>JP2/JPC/JPX/J2K/JPF</span></h2></div>
 <p class="para block block-first">If your distribution has the libpixbufloader-jasper.so loader, these file formats will also be displayed.</p>
 </div>
 </div></div>
index 6150dfb..e059fbc 100644 (file)
           support for lua scripting\r
           enabled by default\r
           disable with configure option: --disable-lua\r
-          \r
+\r
+          librsvg2-common\r
+          for displaying .svg images\r
+\r
+          libwmf0.2-7-gtk\r
+          for displaying .wmf images\r
+\r
+          (see also "Additional pixbuf loaders" in the References section of the Help file)\r
+\r
           awk\r
           when running Geeqie, to use the geo-decode function\r
           \r