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               <varlistentry>\r
  41                 <term>\r
  42                   <guilabel>Hyper</guilabel>\r
  43                 </term>\r
  44                 <listitem>\r
  45                   <para>Slowest scaler, sometimes gives better results than bilinear.</para>\r
  46                 </listitem>\r
  47               </varlistentry>\r
  48             </variablelist>\r
  49           </para>\r
  50         </listitem>\r
  51       </varlistentry>\r
  52       <varlistentry>\r
  53         <term>\r
  54           <guilabel>Use GPU acceleration via Clutter library</guilabel>\r
  55         </term>\r
  56         <listitem>\r
  57           <para>Use alternate renderer. Geeqie must be compiled with the --enable-gpu-accel option.</para>\r
  58         </listitem>\r
  59       </varlistentry>\r
  60       <varlistentry>\r
  61         <term>\r
  62           <guilabel>Two pass zooming</guilabel>\r
  63         </term>\r
  64         <listitem>\r
  65           <para>\r
  66             Enables Geeqie to first display a scaled image using the\r
  67             <emphasis>Nearest</emphasis>\r
  68             zoom quality. After image decoding is complete, the image is scaled again using the selected\r
  69             <emphasis>Zoom Quality</emphasis>\r
  70             method. This allows faster display of an image as it is decoded from the source file.\r
  71           </para>\r
  72         </listitem>\r
  73       </varlistentry>\r
  74       <varlistentry>\r
  75         <term>\r
  76           <guilabel>Allow enlargement of image for zoom to fit</guilabel>\r
  77         </term>\r
  78         <listitem>\r
  79           <para>\r
  80             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
  81             <emphasis>Fit image to window</emphasis>\r
  82             .\r
  83           </para>\r
  84         </listitem>\r
  85       </varlistentry>\r
  86       <varlistentry>\r
  87         <term>\r
  88           <guilabel>Limit image size when autofitting</guilabel>\r
  89         </term>\r
  90         <listitem>\r
  91           <para>\r
  92             This percentage will affect the size of the image when\r
  93             <emphasis>Fit image to window</emphasis>\r
  94             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
  95           </para>\r
  96         </listitem>\r
  97       </varlistentry>\r
  98       <varlistentry>\r
  99         <term>\r
 100           <guilabel>Zoom increment</guilabel>\r
 101         </term>\r
 102         <listitem>\r
 103           <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
 104         </listitem>\r
 105       </varlistentry>\r
 106     </variablelist>\r
 107   </section>\r
 108   <section id="Appearance">\r
 109     <title>Appearance</title>\r
 110     <variablelist>\r
 111       <varlistentry>\r
 112         <term>\r
 113           <guilabel>Custom border color</guilabel>\r
 114         </term>\r
 115         <listitem>\r
 116           <para>Enable this to draw the image background (the area around the image) in the specified color.</para>\r
 117         </listitem>\r
 118       </varlistentry>\r
 119     </variablelist>\r
 120     <variablelist>\r
 121       <varlistentry>\r
 122         <term>\r
 123           <guilabel>Border color</guilabel>\r
 124         </term>\r
 125         <listitem>\r
 126           <para>Use this color chooser to define the color to use as image background.</para>\r
 127           <note>\r
 128             <para>\r
 129               You may use the\r
 130               <emphasis>Limit image size when autofitting</emphasis>\r
 131               (see above) option to keep a border around the image in fullscreen mode.\r
 132             </para>\r
 133           </note>\r
 134         </listitem>\r
 135       </varlistentry>\r
 136     </variablelist>\r
 137     <variablelist>\r
 138       <varlistentry>\r
 139         <term>\r
 140           <guilabel>Alpha channel color 1/2</guilabel>\r
 141         </term>\r
 142         <listitem>\r
 143           <para>These two colors define the checkerboard background used when images with an alpha channel are displayed.</para>\r
 144         </listitem>\r
 145       </varlistentry>\r
 146     </variablelist>\r
 147   </section>\r
 148   <section id="Convenience">\r
 149     <title>Convenience</title>\r
 150     <variablelist>\r
 151       <varlistentry>\r
 152         <term>\r
 153           <guilabel>Auto rotate proofs using EXIF information</guilabel>\r
 154         </term>\r
 155         <listitem>\r
 156           <para>Auto rotate images on print proof sheet.</para>\r
 157         </listitem>\r
 158       </varlistentry>\r
 159     </variablelist>\r
 160   </section>\r
 161 </section>\r