doc/docbook/GuideOptionsImage.xml

   1 <?xml version="1.0" encoding="utf-8"?>\r
   2 <section id="GuideOptionsImage">\r
   3   <title>Image Options</title>\r
   4   <para>This section describes the options presented under the Image Tab of the preferences dialog.</para>\r
   5   <section id="Zoom">\r
   6     <title>Zoom</title>\r
   7     <variablelist>\r
   8       <varlistentry>\r
   9         <term>\r
  10           <guilabel>Quality</guilabel>\r
  11         </term>\r
  12         <listitem>\r
  13           <para>\r
  14             Selects the method used to scale the size of an image:\r
  15             <variablelist>\r
  16               <varlistentry>\r
  17                 <term>\r
  18                   <guilabel>Nearest</guilabel>\r
  19                 </term>\r
  20                 <listitem>\r
  21                   <para>Fastest scaler, but results in poor image quality.</para>\r
  22                 </listitem>\r
  23               </varlistentry>\r
  24               <varlistentry>\r
  25                 <term>\r
  26                   <guilabel>Tiles</guilabel>\r
  27                 </term>\r
  28                 <listitem>\r
  29                   <para>Results are somewhat close to bilinear, with better speed.</para>\r
  30                 </listitem>\r
  31               </varlistentry>\r
  32               <varlistentry>\r
  33                 <term>\r
  34                   <guilabel>Bilinear</guilabel>\r
  35                 </term>\r
  36                 <listitem>\r
  37                   <para>High quality results, moderately fast.</para>\r
  38                 </listitem>\r
  39               </varlistentry>\r
  40             </variablelist>\r
  41           </para>\r
  42         </listitem>\r
  43       </varlistentry>\r
  44       <varlistentry>\r
  45         <term>\r
  46           <guilabel>Use GPU acceleration via Clutter library</guilabel>\r
  47         </term>\r
  48         <listitem>\r
  49           <para>Use alternate renderer. Geeqie must be compiled with the --enable-gpu-accel option.</para>\r
  50         </listitem>\r
  51       </varlistentry>\r
  52       <varlistentry>\r
  53         <term>\r
  54           <guilabel>Two pass zooming</guilabel>\r
  55         </term>\r
  56         <listitem>\r
  57           <para>\r
  58             Enables Geeqie to first display a scaled image using the\r
  59             <emphasis>Nearest</emphasis>\r
  60             zoom quality. After image decoding is complete, the image is scaled again using the selected\r
  61             <emphasis>Zoom Quality</emphasis>\r
  62             method. This allows faster display of an image as it is decoded from the source file.\r
  63           </para>\r
  64         </listitem>\r
  65       </varlistentry>\r
  66       <varlistentry>\r
  67         <term>\r
  68           <guilabel>Zoom increment</guilabel>\r
  69         </term>\r
  70         <listitem>\r
  71           <para>Adjusts the step size when zooming in or out on an image.</para>\r
  72         </listitem>\r
  73       </varlistentry>\r
  74       <varlistentry>\r
  75         <term>\r
  76           <guilabel>Zoom style</guilabel>\r
  77         </term>\r
  78         <listitem>\r
  79           <para>Selects whether the zoom step size is applied as a geometric (n * step) or arithmetic (n + step) factor.</para>\r
  80         </listitem>\r
  81       </varlistentry>\r
  82     </variablelist>\r
  83   </section>\r
  84   <section id="FitImageToWindow">\r
  85     <title>Fit Image To Window</title>\r
  86     <variablelist>\r
  87       <varlistentry>\r
  88         <term>\r
  89           <guilabel>Allow enlargement of image (max. size in %)</guilabel>\r
  90         </term>\r
  91         <listitem>\r
  92           <para>\r
  93             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
  94             <emphasis>Fit image to window</emphasis>\r
  95             . This value sets the maximum expansion permitted in percent i.e. 100% is full-size.\r
  96           </para>\r
  97         </listitem>\r
  98       </varlistentry>\r
  99       <varlistentry>\r
 100         <term>\r
 101           <guilabel>Virtual window size (% of actual window)</guilabel>\r
 102         </term>\r
 103         <listitem>\r
 104           <para>\r
 105             This value will set the virtual size of the window when\r
 106             <emphasis>Fit image to window</emphasis>\r
 107             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
 108           </para>\r
 109         </listitem>\r
 110       </varlistentry>\r
 111     </variablelist>\r
 112   </section>\r
 113   <section id="TileSize">\r
 114     <title>Tile Size</title>\r
 115     <variablelist>\r
 116       <varlistentry>\r
 117         <term>\r
 118           <guilabel>Tile size in pixels</guilabel>\r
 119         </term>\r
 120         <listitem>\r
 121           <para>\r
 122             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
 123           </para>\r
 124         </listitem>\r
 125       </varlistentry>\r
 126     </variablelist>\r
 127   </section>\r
 128   <section id="Appearance">\r
 129     <title>Appearance</title>\r
 130     <variablelist>\r
 131       <varlistentry>\r
 132         <term>\r
 133           <guilabel>Custom border color</guilabel>\r
 134         </term>\r
 135         <listitem>\r
 136           <para>Enable this to draw the image background (the area around the image) in the specified color.</para>\r
 137         </listitem>\r
 138       </varlistentry>\r
 139     </variablelist>\r
 140     <variablelist>\r
 141       <varlistentry>\r
 142         <term>\r
 143           <guilabel>Border color</guilabel>\r
 144         </term>\r
 145         <listitem>\r
 146           <para>Use this color chooser to define the color to use as image background.</para>\r
 147           <note>\r
 148             <para>\r
 149               You may use the\r
 150               <emphasis>Virtual window size</emphasis>\r
 151               (see above) option to keep a border around the image in fullscreen mode.\r
 152             </para>\r
 153           </note>\r
 154         </listitem>\r
 155       </varlistentry>\r
 156     </variablelist>\r
 157     <variablelist>\r
 158       <varlistentry>\r
 159         <term>\r
 160           <guilabel>Alpha channel color 1/2</guilabel>\r
 161         </term>\r
 162         <listitem>\r
 163           <para>These two colors define the checkerboard background used when images with an alpha channel are displayed.</para>\r
 164         </listitem>\r
 165       </varlistentry>\r
 166     </variablelist>\r
 167   </section>\r
 168   <section id="Convenience">\r
 169     <title>Convenience</title>\r
 170     <variablelist>\r
 171       <varlistentry>\r
 172         <term>\r
 173           <guilabel>Auto rotate proofs using EXIF information</guilabel>\r
 174         </term>\r
 175         <listitem>\r
 176           <para>Auto rotate images on print proof sheet.</para>\r
 177         </listitem>\r
 178       </varlistentry>\r
 179     </variablelist>\r
 180   </section>\r
 181 </section>\r