From c66249b79aa9bfa0924494adcd5345b5b1244b0c Mon Sep 17 00:00:00 2001 From: tpearson Date: Wed, 10 Feb 2010 01:02:50 +0000 Subject: Added old abandoned KDE3 version of gwenview git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/gwenview@1088034 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/Makefile.am | 2 ++ doc/browse_mode.png | Bin 0 -> 134206 bytes doc/dock_grip.png | Bin 0 -> 566 bytes doc/docked_windows.docbook | 70 ++++++++++++++++++++++++++++++++++++++++++ doc/external_tools.docbook | 69 +++++++++++++++++++++++++++++++++++++++++ doc/external_tools_dialog.png | Bin 0 -> 14063 bytes doc/index.docbook | 64 ++++++++++++++++++++++++++++++++++++++ doc/interface.docbook | 50 ++++++++++++++++++++++++++++++ doc/introduction.docbook | 27 ++++++++++++++++ doc/keybindings.docbook | 21 +++++++++++++ doc/mouse.docbook | 41 +++++++++++++++++++++++++ doc/view_mode.png | Bin 0 -> 38274 bytes 12 files changed, 344 insertions(+) create mode 100644 doc/Makefile.am create mode 100644 doc/browse_mode.png create mode 100644 doc/dock_grip.png create mode 100644 doc/docked_windows.docbook create mode 100644 doc/external_tools.docbook create mode 100644 doc/external_tools_dialog.png create mode 100644 doc/index.docbook create mode 100644 doc/interface.docbook create mode 100644 doc/introduction.docbook create mode 100644 doc/keybindings.docbook create mode 100644 doc/mouse.docbook create mode 100644 doc/view_mode.png (limited to 'doc') diff --git a/doc/Makefile.am b/doc/Makefile.am new file mode 100644 index 0000000..26d239d --- /dev/null +++ b/doc/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = en +KDE_DOCS = gwenview diff --git a/doc/browse_mode.png b/doc/browse_mode.png new file mode 100644 index 0000000..48f463b Binary files /dev/null and b/doc/browse_mode.png differ diff --git a/doc/dock_grip.png b/doc/dock_grip.png new file mode 100644 index 0000000..04c090d Binary files /dev/null and b/doc/dock_grip.png differ diff --git a/doc/docked_windows.docbook b/doc/docked_windows.docbook new file mode 100644 index 0000000..b5a14e3 --- /dev/null +++ b/doc/docked_windows.docbook @@ -0,0 +1,70 @@ +Docked windows +The &kappname; interface is composed of a number of smaller docked windows. +Manipulating these windows can be difficult at first. To focus a particular +window in the &kappname; interface, simply click within it. + +Each docked window has a small grip bar along the top. It contains a dock/undock button +resembling an arrow at its right end and a close button resembling the +letter X. It looks like this: + + + Grip bar of a docked window + + + + + + Grip bar of a docked window + + + + + + + Clicking the close button on a docked window will remove it from the interface. +To bring it back, select its name in the Window +menu. + + + To resize docked windows, drag the border between the + windows. + + + + To re-arrange the docked windows, drag a window by its grip bar + over to the desired position. While dragging, a small box + outline will appear to indicate the position the window + will take when you end the drag. + + If you wish to stack two windows and use tabs to choose between them, + drag the window to the very center of the other window with which you wish + to stack. + + + + To undock a window, either click the dock/undock button in its top right corner, or + double-click on the window's grip bar. + Double-clicking again or clicking on the dock/undock button, should return the window to its original + position. + You can also dock an undocked window by dragging its grip bar back to a +point within the general interface, just as if you were rearranging an already +docked window. + + + + The file view window cannot be undocked or moved, but by moving other windows + around, it can itself be shifted about. + + + + While dragging a window, press the Escape key to cancel the operation. To reset + the docked windows to the default &kappname; layout, use + + Window + Reset + . + + + + + diff --git a/doc/external_tools.docbook b/doc/external_tools.docbook new file mode 100644 index 0000000..5e91890 --- /dev/null +++ b/doc/external_tools.docbook @@ -0,0 +1,69 @@ + +External tools + +You can easily extend &kappname; by defining external tools. These tools + are accessible from the contextual popup menu which appears when + right-clicking on a thumbnail or in the image view. Look in the + External Tools entry. + +&kappname; comes with a few predefined external tools, but it's very + easy to add more through the Configure External Tools dialog. You can open + it from SettingsConfigure + External Tools.... + + +Here is how it looks: + + + External tools dialog + + + + + + + + +In this example, I defined an external tool which will call Exiftran to + regenerate the EXIF tags for JPEG images. Here is a more detailed description + of its definition: + + + + The Name: field contains the description of your + tool, has it will appear in the menu. + + + + The Command: field contains the command which + will be run when this tool is invoked. + Click on the little question mark on the right of the field to get a list + of the keywords you can use in this field. These keywords will get + expanded to the image files. + + + + + The button on the right lets you associate an icon with your tool. + + + + + The File Associations group indicates what type of + files this tool can work with. Your tool will only appear in the + External Tools menu if the + selected files are of the correct type. In my example, this tool is only + valid with JPEG images, so I choose Custom:, then + image/jpeg and image/pjpeg. + + + + + + You can find other external tool examples from + &kappname; web site. + + + + + diff --git a/doc/external_tools_dialog.png b/doc/external_tools_dialog.png new file mode 100644 index 0000000..72e6723 Binary files /dev/null and b/doc/external_tools_dialog.png differ diff --git a/doc/index.docbook b/doc/index.docbook new file mode 100644 index 0000000..637b8dc --- /dev/null +++ b/doc/index.docbook @@ -0,0 +1,64 @@ + + + + + + + + + + + +]> + + +Gwenview User Manual + + + + +Aurélien +Gâteau +
aurelien.gateau@free.fr
 + + +ChristopherMartin +
chrsmrtn@debian.org
 + + + + +2005 +Aurélien Gâteau + + + +2005-08-21 +1.2.92 + +&kappname; is an image viewer for KDE. + + +KDE +image +viewer +artist +photo +picture + + +&introduction; +&interface; + +&external_tools; + + +Tips +&mouse; +&keybindings; +&docked_windows; + + + diff --git a/doc/interface.docbook b/doc/interface.docbook new file mode 100644 index 0000000..1d17e0b --- /dev/null +++ b/doc/interface.docbook @@ -0,0 +1,50 @@ + +The interface + +Browse and View modes + +By default, &kappname; opens in Browse mode. + +In this mode you can easily navigate through your files and folders. As + you can see on the screenshot, the preview window shows the current image as + well as any embedded image comment. + + + Browse Mode Screenshot + + + + + + + + +From the Browse mode, + unchecking + + + &Ctrl;Return + + View + Browse + + will put you in View mode, where the image takes all the + space of the window. + + + View Mode Screenshot + + + + + + + +You can start directly in View mode by starting &kappname; with an image + as an argument. + + + + + + diff --git a/doc/introduction.docbook b/doc/introduction.docbook new file mode 100644 index 0000000..9ea1995 --- /dev/null +++ b/doc/introduction.docbook @@ -0,0 +1,27 @@ + +Introduction + + +What is &kappname; + + +&kappname; is a fast and easy to use image viewer for KDE. + + + +It features a folder tree window and a file list window to provide easy +navigation of your file hierarchy. &kappname; uses docked windows, so you can +alter its layout any way you wish. You can also browse your images in +full-screen mode, or embedded within &konqueror; using the Image View and Kpart. + +Image loading is handled by the Qt library, so &kappname; supports all +image formats your Qt installation supports. &kappname; correctly displays images +with an alpha channel as well as animations. + +&kappname; supports the displaying and editing of EXIF comments in JPEG +images. Lossless JPEG transforms such as rotations and mirroring are also supported. + + + + + diff --git a/doc/keybindings.docbook b/doc/keybindings.docbook new file mode 100644 index 0000000..f01b28c --- /dev/null +++ b/doc/keybindings.docbook @@ -0,0 +1,21 @@ + +Key bindings + +&kappname; comes with a range of keyboard shortcuts, all of which can be viewed and remapped by + selecting SettingsConfigure + Shortcuts.... Note that in the Files and Folders windows, +all the normal KDE shortcuts are functional, unless otherwise remapped. + +A few of the most useful default bindings are: + + + Space: Displays the next image in the directory. + Backspace: Displays the previous image in the directory. + &Ctrl;Return: Toggles between Browse and View modes. + &Ctrl; + &Shift;F: Activates Full Screen mode. + Escape: Exits from Full Screen mode. + + + diff --git a/doc/mouse.docbook b/doc/mouse.docbook new file mode 100644 index 0000000..b1f6d62 --- /dev/null +++ b/doc/mouse.docbook @@ -0,0 +1,41 @@ +Using the mouse + +Panning with the mouse + + Holding down the left mouse button on an image allows you to + scroll the image. + The mouse wheel will scroll the image up and + down. + + + + +Zooming with the mouse + + Clicking the middle mouse button will toggle the auto zoom + on/off. + Hold down the Control key, then either use the mouse wheel to + zoom in and out or left click to zoom in and right click to zoom + out. + + The mouse wheel, used while holding down the Alt key, will + scroll the image horizontally. + + + + +Browsing with the mouse + + Double-clicking on an image toggles Browse + mode. + By default, the mouse wheel will scroll the image up and down. But, + this can be configured to browse the images in the current directory + instead. + Hold down the left mouse button over an image, then click the right + button to go to the next image. + Hold down the right button, then click the + left button to load the previous image. + + + + diff --git a/doc/view_mode.png b/doc/view_mode.png new file mode 100644 index 0000000..bff633d Binary files /dev/null and b/doc/view_mode.png differ -- cgit v1.2.1