Fix #245: Zoom settings on status bar
[geeqie.git] / doc / docbook / GuideMainWindowStatusBar.xml
index 255fc60..d749b37 100644 (file)
     <para>This section displays the dimensions (width x height) and file byte size of the image that is active in the image pane. When the format of the file in the image pane can not be determined the dimensions will show as “(0 x 0)”, in addition “(no read permision)” may appear if the file permissions do not allow reading the contents of the file.</para>\r
     <para />\r
   </section>\r
-  <section id="Zoom">\r
-    <title>Zoom</title>\r
-    <para>This section displays the current zoom ratio. A ratio of 1:1 is the image's original size. When the left number is larger the image is displayed larger than original size, when the right number is larger the image is displayed smaller.</para>\r
-    <para>A tilde (~) appears within the ratio display when the zoom is set to fit the image within the display area. In this zoom mode the ratio is automatically adjusted, and the displayed ratio may not be the actual ratio because the status bar display rounds the actual value to the nearest tenth (0.1).</para>\r
-    <para />\r
-  </section>\r
   <section id="Buttons">\r
     <title>Buttons</title>\r
     <para>Statusbar buttons corresponds to selected menu action.</para>\r
     <para />\r
+    <section id="Zoom">\r
+      <title>Zoom</title>\r
+      <para>The button label displays the current zoom ratio. A ratio of 1:1 is the image's original size. When the left number is larger the image is displayed larger than original size, when the right number is larger the image is displayed smaller.</para>\r
+      <para>A tilde (~) appears within the ratio display when the zoom is set to fit the image within the display area. In this zoom mode the ratio is automatically adjusted, and the displayed ratio may not be the actual ratio because the status bar display rounds the actual value to the nearest tenth (0.1).</para>\r
+      <para />\r
+      <para>Clicking this button permits control of the behavior of the zoom and scroll settings used when changing the displayed image.</para>\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 its original size.</para>\r
+          </listitem>\r
+        </varlistentry>\r
+        <varlistentry>\r
+          <term>\r
+            <guilabel>Fit image to window</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
+          </listitem>\r
+        </varlistentry>\r
+        <varlistentry>\r
+          <term>\r
+            <guilabel>Leave zoom at previous setting</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
+          </listitem>\r
+        </varlistentry>\r
+      </variablelist>\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
+          </term>\r
+          <listitem>\r
+            <para>The new image is positioned as the previous one, whenever possible.</para>\r
+          </listitem>\r
+        </varlistentry>\r
+      </variablelist>\r
+    </section>\r
     <section id="ExifRotate">\r
       <title>Exif rotate</title>\r
       <para>\r
         <guiicon>\r
           <inlinegraphic fileref="gtk-color-picker.png" />\r
         </guiicon>\r
-        Toggles the auto-rotation of images if they have Exif orientation data. \r
+        Toggles the auto-rotation of images if they have Exif orientation data.\r
         Refer also to the\r
         <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>\r
         .\r