<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" style="task" id="preferences" xml:lang="en_GB">

  <info>
    <link type="guide" xref="index#tips"/>
    <desc><link xref="preferences#view">Image view</link>, <link xref="preferences#slideshow">slideshow</link> and <link xref="preferences#plugins">plug-ins</link>.</desc>

    <revision pkgversion="3.2" version="0.1" date="2011-09-06" status="final"/>
    <revision pkgversion="3.31.90" version="0.2" date="2019-03-03" status="final"/>
    <credit type="author">
      <name>Tiffany Antopolski</name>
      <email>tiffany@antopolski.com</email>
    </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>

  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>David Lodge</mal:name>
      <mal:email>dave@cirt.net</mal:email>
      <mal:years>2017</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Zander Brown</mal:name>
      <mal:email>zbrown@gnome.org</mal:email>
      <mal:years>2020</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Bruce Cowan</mal:name>
      <mal:email>bruce@bcowan.me.uk</mal:email>
      <mal:years>2020</mal:years>
    </mal:credit>
  </info>

<title>Preferences</title>
<p>This topic explains all of the settings that you can change in the image viewer. Press the menu button in the top-right corner of the window and select <gui style="menuitem">Preferences</gui> to start changing the preferences.</p>

<links type="section"/>

<section id="view">
<title>Image view preferences</title>
<terms>
  <item>
    <title>Image enhancements</title>
    <p>Select <gui>Smooth images when zoomed out</gui> and/or <gui>Smooth images when zoomed in</gui> to enable <em>image smoothing</em>. This makes low-resolution (pixelated) pictures look better by smoothing out jagged edges.</p>
    <p>If you enable <gui>Automatic orientation</gui>, pictures will be automatically rotated according to their <em>Exif metadata</em>. This is information about a picture that is automatically inserted by a digital camera, and can include details on which way up the camera was held when the picture was taken. For example, when automatic orientation is enabled, portrait photos are automatically rotated upright. The rotation is not saved until you <link xref="flip-rotate#rotate">save the rotated image</link>.</p> 
    <p>Automatic orientation does not work with all pictures; only pictures taken using a camera that saves Exif orientation metadata will be rotated.</p>
  </item>
  <item>
    <title>Background</title>
    <p>Here you can select a custom background colour.</p>
  </item>
  <item>
    <title>Transparent parts</title>
     <p>Select one of the following options to determine how the transparent parts of a picture are displayed, if it has any:</p>
    <list>
      <item>
       <p><gui>As check pattern:</gui></p>
       <p>Displays any transparent parts of the image in a check pattern.</p>
      </item>
      <item>
       <p><gui>As custom colour:</gui></p>
       <p>Displays any transparent parts of the image in a solid colour that you specify by clicking on the colour selector button.</p>
      </item>
      <item>
       <p><gui>As background:</gui></p>
       <p>Displays any transparent parts of the image in the <gui>Background</gui> colour, if <gui>As custom colour</gui> under <gui>Background</gui> is ticked. Otherwise, the default background colour is used.</p>
      </item>
    </list>
  </item>
 </terms>
</section>


<section id="slideshow">
<title>Slideshow preferences</title>
<p>To customise slideshow settings:</p>
<list>
 <item>
  <p>Under <gui>Image Zoom</gui> you can select if you would like pictures that are smaller than the screen to be expanded so that they fit the screen.</p>
 </item>
 <item>
  <p>Under <gui>Sequence</gui> you can select how many seconds each picture should be displayed for (between 1 and 100) before the next picture is shown.</p>
 </item>
 <item>
  <p>Tick <gui>Loop sequence</gui> if you want the slideshow to repeat continuously. If unticked, the slideshow will start at the picture you selected, and finish at the last picture in the folder.</p>
 </item>
</list>
</section>


<section id="plugins">
<title>Plug-in preferences</title>

<media type="image" src="figures/plugins-all.png" width="300" style="floatend"/>
<media type="image" src="figures/prefs-plugins.png" width="300" style="floatstart"/>

<p>Here you can tick/untick any additional features you would like to activate or deactivate. The picture on the left shows the plug-ins that are available by default.</p>

<p>You may also wish to install the <link xref="plugins">eog-plugins package</link>, which contains plug-ins providing a number of extra features. After installing it, you will be able to activate <link xref="index#plugins">additional plug-ins</link>, like the ones shown in the picture on the right.</p>
</section>

</page>
