Addl fix #521: zoom increment is not multiplicative
[geeqie.git] / doc / docbook / GuideOptionsImage.xml
index a9286d0..9f2a028 100644 (file)
                   <para>High quality results, moderately fast.</para>\r
                 </listitem>\r
               </varlistentry>\r
-              <varlistentry>\r
-                <term>\r
-                  <guilabel>Hyper</guilabel>\r
-                </term>\r
-                <listitem>\r
-                  <para>Slowest scaler, sometimes gives better results than bilinear.</para>\r
-                </listitem>\r
-              </varlistentry>\r
             </variablelist>\r
           </para>\r
         </listitem>\r
       </varlistentry>\r
       <varlistentry>\r
         <term>\r
-          <guilabel>Allow enlargement of image for zoom to fit</guilabel>\r
-        </term>\r
-        <listitem>\r
-          <para>\r
-            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\r
-            <emphasis>Fit image to window</emphasis>\r
-            .\r
-          </para>\r
-        </listitem>\r
-      </varlistentry>\r
-      <varlistentry>\r
-        <term>\r
-          <guilabel>Limit image size when autofitting</guilabel>\r
+          <guilabel>Zoom increment</guilabel>\r
         </term>\r
         <listitem>\r
-          <para>\r
-            This percentage will affect the size of the image when\r
-            <emphasis>Fit image to window</emphasis>\r
-            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.\r
-          </para>\r
+          <para>Adjusts the step size when zooming in or out on an image.</para>\r
         </listitem>\r
       </varlistentry>\r
       <varlistentry>\r
         <term>\r
-          <guilabel>Zoom increment</guilabel>\r
+          <guilabel>Zoom style</guilabel>\r
         </term>\r
         <listitem>\r
-          <para>Adjusts the step size when zooming in or out on an image. This value corresponds to the percentage of the original image.</para>\r
+          <para>Selects whether the zoom step size is applied as a geometric (n * step) or arithmetic (n + step) factor.</para>\r
         </listitem>\r
       </varlistentry>\r
     </variablelist>\r
   </section>\r
-  <section id="Whennewimageisselected">\r
-    <title>When new image is selected</title>\r
-    <para>This controls the behavior of the zoom and scroll settings when changing the displayed image.</para>\r
+  <section id="FitImageToWindow">\r
+    <title>Fit Image To Window</title>\r
     <variablelist>\r
       <varlistentry>\r
         <term>\r
-          <guilabel>Zoom to original size</guilabel>\r
-        </term>\r
-        <listitem>\r
-          <para>The new image is set to it's original size.</para>\r
-        </listitem>\r
-      </varlistentry>\r
-      <varlistentry>\r
-        <term>\r
-          <guilabel>Fit image to window</guilabel>\r
+          <guilabel>Allow enlargement of image (max. size in %)</guilabel>\r
         </term>\r
         <listitem>\r
-          <para>The new image's zoom is changed so that the image will fit within the current view area.</para>\r
+          <para>\r
+            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\r
+            <emphasis>Fit image to window</emphasis>\r
+            . This value sets the maximum expansion permitted in percent i.e. 100% is full-size.\r
+          </para>\r
         </listitem>\r
       </varlistentry>\r
       <varlistentry>\r
         <term>\r
-          <guilabel>Leave zoom at previous setting</guilabel>\r
+          <guilabel>Virtual window size (% of actual window)</guilabel>\r
         </term>\r
         <listitem>\r
-          <para>The zoom setting is unchanged, the new image will be scaled the same as the previous image.</para>\r
+          <para>\r
+            This value will set the virtual size of the window when\r
+            <emphasis>Fit image to window</emphasis>\r
+            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.\r
+          </para>\r
         </listitem>\r
       </varlistentry>\r
     </variablelist>\r
+  </section>\r
+  <section id="TileSize">\r
+    <title>Tile Size</title>\r
     <variablelist>\r
       <varlistentry>\r
         <term>\r
-          <guilabel>Scroll to top left corner</guilabel>\r
-        </term>\r
-        <listitem>\r
-          <para>The new image is displayed from top left corner.</para>\r
-        </listitem>\r
-      </varlistentry>\r
-      <varlistentry>\r
-        <term>\r
-          <guilabel>Scroll to image center</guilabel>\r
-        </term>\r
-        <listitem>\r
-          <para>The new image is centered</para>\r
-        </listitem>\r
-      </varlistentry>\r
-      <varlistentry>\r
-        <term>\r
-          <guilabel>Keep the region from previous iamge</guilabel>\r
+          <guilabel>Tile size in pixels</guilabel>\r
         </term>\r
         <listitem>\r
-          <para>The new image is positioned as the previous one, whenever possible.</para>\r
+          <para>\r
+            This option is only available when GPU acceleration is not selected. It sets the size in pixels that large images are split into during rendering. Setting a larger value will reduce the tiling effect seen as the image is displayed, but will also slightly increase the delay until the first part of the image is seen.\r
+          </para>\r
         </listitem>\r
       </varlistentry>\r
     </variablelist>\r
           <note>\r
             <para>\r
               You may use the\r
-              <emphasis>Limit image size when autofitting</emphasis>\r
+              <emphasis>Virtual window size</emphasis>\r
               (see above) option to keep a border around the image in fullscreen mode.\r
             </para>\r
           </note>\r
         </listitem>\r
       </varlistentry>\r
     </variablelist>\r
-  </section>\r
-  <section id="Convenience">\r
-    <title>Convenience</title>\r
     <variablelist>\r
       <varlistentry>\r
         <term>\r
-          <guilabel>Auto rotate image using EXIF information</guilabel>\r
+          <guilabel>Alpha channel color 1/2</guilabel>\r
         </term>\r
         <listitem>\r
-          <para>Auto rotates images based on metadata stored in images that have Exif data.</para>\r
+          <para>These two colors define the checkerboard background used when images with an alpha channel are displayed.</para>\r
         </listitem>\r
       </varlistentry>\r
+    </variablelist>\r
+  </section>\r
+  <section id="Convenience">\r
+    <title>Convenience</title>\r
+    <variablelist>\r
       <varlistentry>\r
         <term>\r
           <guilabel>Auto rotate proofs using EXIF information</guilabel>\r
         </term>\r
         <listitem>\r
-          <para>TBD</para>\r
+          <para>Auto rotate images on print proof sheet.</para>\r
         </listitem>\r
       </varlistentry>\r
     </variablelist>\r