Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
apps:ristretto:preferences [2012/01/08 10:01] – stephanapps:ristretto:preferences [2024/12/11 23:44] (current) – kevinbowen
Line 1: Line 1:
-====== Preferences ======+~~NOTOC~~ 
 +{{ :apps:ristretto.png?nolink|}} 
 +====== Ristretto - Preferences ======
 The behaviour and looks of Ristretto can be modified, mostly through options displayed in the Preferences Dialog.  The behaviour and looks of Ristretto can be modified, mostly through options displayed in the Preferences Dialog. 
 ===== Preferences Dialog ===== ===== Preferences Dialog =====
-The Preferences dialog allows a user to configure different aspects of Ristretto. These options are grouped under the following tabs. +The Preferences dialog allows a user to configure different aspects of Ristretto.
  
-==== Display ==== +These options are grouped under the following tabs: 
-<figure "Display preferences"> +  * **[[#display|Display]]** 
-{{ :apps:ristretto:preferences:display.png?nolink& |}}+  * **[[#fullscreen|Fullscreen]]** 
 +  * **[[#slideshow|Slideshow]]** 
 +  * **[[#control|Control]]** 
 +  * **[[#behaviour|Behaviour]]** 
 +  * **[[#Reporting Bugs|Advanced]]** 
 + 
 +The preferences dialog can be opened through {gui>Menu>Edit>Preferences} 
 + 
 +---- 
 + 
 +===== Display ===== 
 + 
 +<figure "Ristretto Display Preferences"> 
 +{{:apps:ristretto:display.png?600|Ristretto Display Preferences Window}}
 </figure> </figure>
-=== Override background color === 
-Did you notice how the background-color around the image was the same as the rest of the window? It was themed by Gtk+, when you enable this option, the theme-color is overridden by whatever you set here. Most people like it black, but there is no limitation to the colors you can pick.  
  
-=== Merge toolbars === +? Override background color 
-By default, Ristretto comes with two toolbars, one containing the file-operations, and one for navigating the opened images. If you want to reduce the amount of space used for the different buttons, you can enable this option and the two toolbars merge into one. +! Did you notice how the background-color around the image was the same as the rest of the window? It was themed by Gtk+. When you enable this option, the theme-color is overridden by whatever you set here. Most people like it black; but, there is no limitation to the colors you can pick. 
  
-=== Hide Thumbnailbar when fullscreen === +? Limit Quality 
-If the Ristretto window is fullscreen, you can choose to automatically hide the thumbnailbar. Even though the thumbnailbar is normally visible. This option overrides the ''Control+t'' shortcut for toggleing the visibility of the thumbnailbar. +! With this option set, the memory-usage of Ristretto is limited because it will only render the images at the screen-dimensions instead of the maximum quality.
  
-==== Slideshow ==== +[[|Back To Top]] 
-<figure "Slideshow preferences"> +---- 
-{{ :apps:ristretto:preferences:slideshow.png?nolink& |}}+ 
 +===== Fullscreen ===== 
 + 
 +<figure "Ristretto Fullscreen Preferences"> 
 +{{:apps:ristretto:fullscreen.png?600|Ristretto Fullscreen Preferences Window}}
 </figure> </figure>
  
-=== Timeout === +? Hide Thumbnailbar when fullscreen 
-When showing a slideshow of images, the value of this slider determines how long Ristretto will show each image. +! If the Ristretto window is fullscreen, you can choose to automatically hide the thumbnailbar. Even though the thumbnailbar is normally visible. This option overrides the {key>Ctrl+T} shortcut for toggleing the visibility of the thumbnailbar. 
  
-==== Control ==== +? Clock 
-<figure "Control preferences"> +! When this option is enabled, a clock is visible when Ristretto is in fullscreen mode. 
-{{ :apps:ristretto:preferences:control.png?nolink& |}}+ 
 +[[|Back To Top]] 
 +---- 
 + 
 + 
 +===== Slideshow ===== 
 + 
 +<figure "Ristretto Slideshow Preferences"> 
 +{{:apps:ristretto:slideshow.png?600|Ristretto Slideshow Preferences Window}}
 </figure> </figure>
  
-=== Invert zoom direction === +? Timeout 
-By default, Ristretto zooms in when you turn the scroll-wheel forward, and zooms out when you turn the scroll-wheel backward. For touch-pads, this can be awkward, because a two-finger scroll is more of a pushing and pulling action. With this option set, turning the scroll-wheel forward will zoom out (pushing the image away) and turning the scroll-wheel backward will zoom in (pulling the image closer). +! When showing a slideshow of images, the value of this slider determines how long Ristretto will show each image. 
  
-==== Behaviour ==== +[[|Back To Top]] 
-<figure "Behaviour preferences"> +---- 
-{{ :apps:ristretto:preferences:behaviour.png?nolink& |}}+ 
 + 
 +===== Control ===== 
 + 
 +<figure "Ristretto Control Preferences"> 
 +{{:apps:ristretto:control.png?600|Ristretto Control Preferences Window}}
 </figure> </figure>
-=== Maximize window on startup when opening an image === 
-This option will automatically maximize the main window whenever Ristretto is launched with a file argument. 
  
-=== Wrap around images === +? Invert zoom direction 
-With this option set, Ristretto will wrap around images. When pressing Next on the last image, or Previous on the first image, it will jump to the Last or First image respectively.+! By default, Ristretto zooms in when you turn the scroll-wheel forward, and zooms out when you turn the scroll-wheel backward. For touch-pads, this can be awkward, because a two-finger scroll is more of a pushing and pulling action. With this option set, turning the scroll-wheel forward will zoom out (pushing the image away) and turning the scroll-wheel backward will zoom in (pulling the image closer). 
  
-=== Choose Desktop === +[[|Back To Top]] 
-Choose which desktop you are using, this determines the way ristretto configures the desktop wallpaper. Currently, GNOME and Xfce are supported.+----
  
  
-===== Advanced options =====+===== Behaviour =====
  
 +<figure "Ristretto Behaviour Preferences">
 +{{:apps:ristretto:behaviour.png?600|Ristretto Behaviour Preferences Window}}
 +</figure>
 +
 +? Maximize window on startup when opening an image
 +! This option will automatically maximize the main window whenever Ristretto is launched with a file argument.
 +
 +? Wrap around images
 +! With this option set, Ristretto will wrap around images. When pressing Next on the last image, or Previous on the first image, it will jump to the Last or First image respectively.
 +
 +? Choose Desktop
 +! Choose which desktop you are using, this determines the way Ristretto configures the desktop wallpaper. Currently, GNOME and Xfce are supported.
 +
 +[[|Back To Top]]
 +----
 +
 +===== Advanced Options =====
 +==== Printing ====
 +
 +As of version 0.13.0, Ristretto allows you to print an image. The settings for printing are treated separately, in the file ''~/.config/ristretto/print-settings''. Carry out a printing operation to the end (you can print in a file), and Ristretto will fill in the configuration file with the values set in the print dialog.
 ==== Don't use Thunar to show the file-properties dialog ==== ==== Don't use Thunar to show the file-properties dialog ====
 By default, Ristretto will ask thunar to pop-up the file-properties dialog. This way, you'll have the advantage of all of thunar's plugins that extend it's file-properties dialog beyond it's native functionality. Aswell as a consistent look-and-feel throughout the xfce desktop. By default, Ristretto will ask thunar to pop-up the file-properties dialog. This way, you'll have the advantage of all of thunar's plugins that extend it's file-properties dialog beyond it's native functionality. Aswell as a consistent look-and-feel throughout the xfce desktop.
Line 54: Line 102:
 However, there are some cases where you want Ristretto not to use Thunar, but go for the build-in dialog all the times. This can be the case when you have Thunar installed, but don't use it. Launching the file-properties dialog from Ristretto will then cause Thunar to be launched, making it a pretty expensive dialog. However, there are some cases where you want Ristretto not to use Thunar, but go for the build-in dialog all the times. This can be the case when you have Thunar installed, but don't use it. Launching the file-properties dialog from Ristretto will then cause Thunar to be launched, making it a pretty expensive dialog.
  
-Being a somewhat advanced feature, this option is not exposed through the preferences-dialog, and can only be enabled through the xfconf command-line utility xfconf-query. This can be done as followed: +Being a somewhat advanced feature, this option is not exposed through the preferences-dialog, and can only be enabled through the [[xfce:xfconf:|xfconf]] command-line utility [[xfce:xfconf:xfconf-query|xfconf-query]]. This can be done as follows: 
 <code> <code>
 $ xfconf-query -c ristretto -p /window/use-thunar-properties -n -t bool -s false $ xfconf-query -c ristretto -p /window/use-thunar-properties -n -t bool -s false
 </code> </code>
  
-<figure "Internal file properties dialog"> +The internal file-properties dialog will look like this: 
-{{ :apps:ristretto:properties-dialog.png?nolink& |}}+ 
 +<figure "Ristretto Internal File Properties Dialog"> 
 +{{:apps:ristretto:properties-dialog.png|Ristretto Internal File Properties Dialog Window}}
 </figure> </figure>
 +
 +[[|Back to Top]]
 +----
 +[[:apps:ristretto:start:|Return to Ristretto Main Documentation Page]]