1GWENVIEW(1) Image viewer for KDE GWENVIEW(1)
2
6 Gwenview - An image viewer for KDE
7
9 gwenview [options] [file or folder]
10
12 Gwenview is an image viewer for KDE. It features a folder tree window
13 and a file list window to provide easy navigation of your file hierar‐
14 chy. Gwenview uses docked windows, so you can alter its layout any way
15 you wish. You can also browse your images in full-screen mode, or
16 embedded within Konqueror using the Gwenview Image Browser View and
17 Kpart.
18 Image loading is handled by the Qt library, so Gwenview supports all
20 image formats your Qt installation supports. Gwenview correctly dis‐
21 plays images with an alpha channel.
22 Gwenview supports the displaying and editing of EXIF comments, if the
24 necessary JPEG kfile-plugin is installed. This comes as part of the
25 kdegraphics package. Lossless JPEG transforms are also supported.
26
28 Arguments:
29 file or folder
30 An initial image file, or a folder containing images.
31 Gwenview options:
33 -f Start in Full Screen mode.
34 Generic options:
36 --help Show help about options.
37 --help-qt
39 Show Qt specific options.
40 --help-kde
42 Show KDE specific options.
43 --help-all
45 Show all options.
46 --author
48 Show author information.
49 -v, --version
51 Show version information.
52 --license
54 Show license information.
55 -- End of options.
57 Qt options:
59 --display displayname
60 Use the X-server display 'displayname'.
61 --session sessionId
63 Restore the application for the given 'sessionId'.
64 --cmap Causes the application to install a private color map on an
66 8-bit display.
67 --ncols count
69 Limits the number of colors allocated in the color cube on an
70 8-bit display, if the application is using the QApplica‐
71 tion::ManyColor color specification.
72 --nograb
74 Tells Qt to never grab the mouse or the keyboard.
75 --dograb
77 Running under a debugger can cause an implicit -nograb, use
78 -dograb to override.
79 --sync Switches to synchronous mode for debugging.
81 --fn, --font fontname
83 Defines the application font.
84 --bg, --background color
86 Sets the default background color and an application palette
87 (light and dark shades are calculated).
88 --fg, --foreground color
90 Sets the default foreground color.
91 --btn, --button color
93 Sets the default button color.
94 --name name
96 Sets the application name.
97 --title title
99 Sets the application title (caption).
100 --visual TrueColor
102 Forces the application to use a TrueColor visual on an 8-bit
103 display.
104 --inputstyle inputstyle
106 Sets XIM (X Input Method) input style. Possible values are
107 onthespot, overthespot, offthespot and root.
108 --im XIM server
110 Set XIM server.
111 --noxim
113 Disable XIM.
114 --reverse
116 Mirrors the whole layout of widgets.
117 KDE options:
119 --caption caption
120 Use 'caption' as name in the titlebar.
121 --icon icon
123 Use 'icon' as the application icon.
124 --miniicon icon
126 Use 'icon' as the icon in the titlebar.
127 --config filename
129 Use alternative configuration file.
130 --dcopserver server
132 Use the DCOP Server specified by 'server'.
133 --nocrashhandler
135 Disable crash handler, to get core dumps.
136 --waitforwm
138 Waits for a WM_NET compatible windowmanager.
139 --style style
141 Sets the application GUI style.
142 --geometry geometry
144 Sets the client geometry of the main widget.
145
147 Browse and View modes
148 By default, Gwenview opens in Browse mode, with the docked windows
149 (showing directory structure and contents) displayed. Starting Gwenview
150 with a directory as an argument also begins in Browse mode. Starting
151 with an image as an argument, however, opens Gwenview in View mode,
152 with these docked windows hidden to give full space to the image
153 itself.
154 Once Gwenview is started, the user can toggle between Browse and View
156 modes by clicking the Browse button on the Main Toolbar. The same
157 option can be found in the View menu. Ctrl-Return will toggle these
158 modes as well.
159 Whereas normally, in Browse mode, single-clicking on an image thumbnail
161 or listing is sufficient for Gwenview to display it, users also have
162 the option of double-clicking, which displays the image and switches
163 Gwenview to View mode.
164 Docked windows
166 The Gwenview interface is composed of a number of smaller docked win‐
167 dows. Manipulating these windows can be difficult at first. To focus a
168 particular window in the Gwenview interface, simply click within it.
169 Each docked window has a small grip bar along the top, with a
171 dock/undock button resembling an arrow at its right end, as well as a
172 close button resembling the letter X.
173 Clicking the close button on a docked window will remove it from the
175 interface. To bring back a window, select it from the Window menu.
176 To resize docked windows, click on the border between the windows, and
178 drag. To re-arrange the docked windows, click on a window's grip bar
179 along its top, and drag the window over to the desired position rela‐
180 tive to the other docked windows. While dragging, a small box outline
181 should appear that indicates the new position that the window will
182 take, when you release the mouse and end the drag. If you wish to stack
183 two windows, and use tabs to choose between them, drag the window to
184 the very center of the other window with which you wish to stack.
185 To undock a window, either click the dock/undock button in its top
187 right corner, or double-click on the window's grip bar. Double-clicking
188 again, or clicking on the dock/undock button, should return the window
189 to its original position. Otherwise, you can dock an undocked window
190 by dragging its grip bar back to a point within the general interface,
191 just as if you were rearranging an already docked window.
192 The file view window cannot be undocked or moved, but by moving other
194 windows around, it can itself be shifted about.
195 While dragging a window, press the Escape key to cancel the operation.
197 To reset the docked windows to the default Gwenview layout, use the
198 Reset option in the Window menu.
199 Mouse operations
201 Browsing a directory of images can be done several ways, including
202 mouse gestures. Hold down the left mouse button over an image, then
203 click the right button to go to the next image. Hold down the right
204 button, then click the left button to load the previous image.
205 Clicking the right mouse button on an image brings up a context menu.
207 Clicking the middle mouse button will toggle the auto zoom on/off.
209 Double-clicking on an image toggles Full Screen mode.
211 Holding down the left mouse button on an image allows you to scroll the
213 image. By default, you can also scroll up and down an image by using
214 the mouse wheel. However, this can be configured to browse the images
215 in the current directory instead.
216 The mouse wheel, used while holding down the Shift key, will zoom the
218 image in and out.
219 The mouse wheel, used while holding down the Control or Alt keys, will
221 scroll the image horizontally.
222 Keybindings
224 Gwenview comes with a range of keyboard shortcuts, all of which can be
225 viewed and remapped by selecting "Configure Shortcuts" in the Settings
226 menu. Note that in the Files and Folders windows, all the normal KDE
227 shortcuts are functional, unless otherwise remapped.
228 A few of the most useful default bindings are:
230 Ctrl-Shift-F Toggles Full Screen mode.
232 Escape Stop, exit from Full Screen mode.
233 Home Displays the first image in the directory.
235 End Displays the last image in the directory.
236 Space Displays the next image in the directory.
238 Backspace Displays the previous image in the directory.
239
241 The Gwenview homepage can be found at http://gwenview.sourceforge.net.
242 A mailing list is also available at http://lists.source‐
244 forge.net/lists/listinfo/gwenview-general.
245
247 To report a bug, please visit http://bugs.kde.org.
248
250 Gwenview was written by Aurelien Gateau <aurelien.gateau@free.fr>.
251 This manual page was written by Christopher Martin <chrsm‐
253 rtn@debian.org> for Debian GNU/Linux, but may be used by others.
254 Permission is granted to copy, distribute and/or modify this document
256 under the terms of the GNU General Public License, Version 2, any later
257 version published by the Free Software Foundation.
258K Desktop Environment January 2005 GWENVIEW(1)