diff --git a/doc/index.docbook b/doc/index.docbook
index 609d4c10..3bae5944 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1,442 +1,442 @@
]>
Gwenview User Manual
Aurélien
Gâteau
agateau@kde.org
ChristopherMartin
chrsmrtn@debian.org
Henry
de Valence
hdevalence@gmail.com
2005
Aurélien Gâteau
2008
Henry de Valence
&FDLNotice;
2005-08-21
1.2.92
&kappname; is an image viewer for &kde;.
KDE
image
viewer
artist
photo
picture
Introduction
What is &kappname;
&kappname; is a fast and easy to use image viewer for KDE.
Gwenview features three main modes: Browse, View, and Full Screen. Browse Mode
lets you navigate through your computer showing thumbnails of your images, View
Mode lets you view images one at a time, and Full Screen lets you make quick
slideshows.
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 (transparency) 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.
The interface
Image Operations
Gwenview has a few features which are available in both Browse, View, and
Full Screen view. Gwenview has the capability to do basic alteration of your
images.
Rotate: A rotate operation will rotate the image either to the left
or to the right, depending on whether you do
&Ctrl;R
Edit
Rotate Right
or
&Ctrl;L
Edit
Rotate Left
Edit
Mirror
:
This operation will reflect the image along the vertical
axis, as if you were seeing it in a mirror.
Edit
Flip
:
This operation will reflect the image upside-down (a
reflection along the horizontal axis)
Edit
Resize
:
This operation will allow you to shrink or expand the image. Note that if you
increase the size of an image, it may appear
blurry and/or pixelated.
Edit
Crop
:
This operation lets you discard parts of the image you don't want.
Browse Mode
When in Browse Mode, you can easily navigate through your files and folders.
The preview window shows thumbnails of the images in the current folder, as
well as subfolders.
Browse Mode Screenshot
Moving the mouse over an image shows buttons to rotate the image as well as
a button to enter Fullscreen Mode. Clicking on an image takes you into View
Mode. The sidebar on the left does not appear
by default, but its appearance can be toggled using
F11
View
Sidebar
or using the little arrow on the top of the sidebar splitter. When clicked it
collapses or expands the sidebar. The collapser can overlap the image, but fades
away when the mouse cursor moves out of the sidebar.
The slider at the bottom right allows you to change the size of the image
- thumbnails. You can also filter the images by filename or date using the box on the
+ thumbnails. You can also filter the images by filename, date, tag or rating using the box on the
lower left. The toolbar (left) appears in both Browse mode as well as View
mode and contains the most commonly used actions.
Browse: Switches to Browse Mode.
View: Switches to View Mode.
Full Screen: Switches to Full Screen Mode.
Go to Previous Image: Clicking this icon will go
to the previous image in the folder.
Go to Next Image: Clicking this button will go to
the next image in the folder.
Rotate Left/Right: Same as discussed in
Image Operations
Show Sidebar: Shows the sidebar (left) which
displays information about the current image.
View Mode
View Mode displays one image at a time. At the bottom, there is the
Thumbnail Bar, which allows you to scroll through the images in the current
folder. The Thumbnail Bar can be minimized by clicking on the Thumbnail Bar
button. Clicking again will restore it.
View Mode Screenshot
The slider at the bottom right controls the zoom of the image. The
Zoom to Fit button and the Actual Size
button are next to the zoom slider and are two preset zoom levels. The
Zoom to Fit button zooms the current image to fit the size
of the window, and the Actual Size button zooms the image to
the actual pixel size.
You can start directly in View mode by starting &kappname; from a
context menu like Open With in another program or by launching it from the
command line with an image as an argument.
Full Screen Mode
The Full Screen Mode shows a slideshow of your images. Access Full Screen
Mode by clicking on the button that appears when you move the mouse over the
thumbnails in Browse Mode, by pressing the Full Screen
button on the taskbar, or by
&Ctrl;&Shift;F
View
Full Screen Mode
.
Full Screen Mode Screenshot
The top bar will hide itself automatically; to show it simply move the
mouse to the top of the screen. If the mouse cursor is over the top bar, it
will not autohide. Most of the buttons on the bar are the same as the ones on
the toolbar in Browse or View Modes, except for the Exit Full
Screen Mode button which returns you to the &kappname; window, the
Start/Stop Slideshow button, and the
Configure Full Screen Mode button which shows a
small settings dialog that allows you to easily and quickly configure the
slideshow. The slideshow controls there are:
The Interval slider controls how long &kappname; will show
an image before it move to the next one.
If the Loop checkbox is checked, when the end of the
slideshow is reached, it will continue from the beginning instead of
stopping.
If the Random checkbox is checked, instead of progressing
through the folder alphabetically, images will be shown in random
order.
Also in the top bar is an area that shows you the other images in the
current folder. Clicking on one will display it.
Tips
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
When in Browse mode, clicking an image switches into View mode and
shows that image.
When in Browse mode, scrolling the mouse wheel will scroll up
or down the thumbail view area.
If the Mouse Behavior option in
SettingsConfigure
&kappname;
is set to Browse, scrolling the mouse wheel while in View Mode will
move you through the images in the folder.
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.
&Alt;Up:
Moves to the parent folder of the current folder.
&Ctrl;&Shift;F:
Switches into Full Screen Mode.
&Esc;: Exits from Full Screen
mode.
&Ctrl;M:
Show or hide the menubar.
&Ctrl;B:
Show or hide the Thumbnail bar.
F11
Show or hide the Sidebar.
F6
Make the Location bar editable so that you can directly type in a file path.
You can return to the standard Location Bar by pressing the arrow at the
right.
&Ctrl;R:
Rotate the current image to the right.
&Ctrl;L:
Rotate the current image to the left.
&Ctrl;S:
Save any changes made to the image.
Del
Move the current image to the trash.
&Shift;Del:
Permanently delete the image from the disk. Note that this operation is
irreversible and cannot be undone.
&Ctrl;P:
Print the current image.
&Ctrl;O:
Open an image using the standard file selection dialog.
Credits and Copyright
&kappname; is currently maintained by Aurélien Gâteau
This document was written by Christopher Martin
This document was updated for &kde; 4 by Henry de Valence
&underFDL;
&underGPL;
diff --git a/importer/importerconfigdialog.cpp b/importer/importerconfigdialog.cpp
index 88242d28..5f3b8b80 100644
--- a/importer/importerconfigdialog.cpp
+++ b/importer/importerconfigdialog.cpp
@@ -1,97 +1,100 @@
// vim: set tabstop=4 shiftwidth=4 noexpandtab:
/*
Gwenview: an image viewer
Copyright 2009 Aurélien Gâteau
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Cambridge, MA 02110-1301, USA.
*/
// Self
#include "importerconfigdialog.moc"
// Qt
#include
// KDE
#include
// Local
#include "filenameformater.h"
#include "importerconfig.h"
#include "ui_importerconfigdialog.h"
namespace Gwenview {
static const QString PREVIEW_FILENAME = "PICT0012.JPG";
static const KDateTime PREVIEW_DATETIME = KDateTime(QDate(2009, 10, 25), QTime(17, 51, 18));
struct ImporterConfigDialogPrivate : public Ui_ImporterConfigDialog {
ImporterConfigDialog* q;
void setupHelpText() {
QString helpText = "";
FileNameFormater::HelpMap map = FileNameFormater::helpMap();
FileNameFormater::HelpMap::ConstIterator
it = map.constBegin(),
end = map.constEnd();
for (;it != end; ++it) {
QString keyword = '{' + it.key() + '}';
QString explanation = Qt::escape(it.value());
QString link = QString("%1").arg(keyword);
helpText += "- " + i18nc("%1 is the importer keyword, %2 is keyword explanation", "%1: %2", link, explanation) + "
";
}
helpText += "
";
mRenameFormatHelpLabel->setText(helpText);
QObject::connect(mRenameFormatHelpLabel, SIGNAL(linkActivated(QString)),
q, SLOT(slotHelpLinkActivated(QString)));
}
};
ImporterConfigDialog::ImporterConfigDialog(QWidget* parent)
: KConfigDialog(parent, "Importer Settings", ImporterConfig::self())
, d(new ImporterConfigDialogPrivate) {
d->q = this;
QWidget* widget = new QWidget;
d->setupUi(widget);
setFaceType(KPageDialog::Plain);
+ // Hide help button until there is actual documentation to show
+ showButton(KDialog::Help, false);
+ showButtonSeparator(true);
addPage(widget, QString());
connect(d->kcfg_AutoRenameFormat, SIGNAL(textChanged(QString)),
SLOT(updatePreview()));
d->setupHelpText();
updatePreview();
}
ImporterConfigDialog::~ImporterConfigDialog() {
delete d;
}
void ImporterConfigDialog::slotHelpLinkActivated(const QString& keyword) {
d->kcfg_AutoRenameFormat->insert(keyword);
}
void ImporterConfigDialog::updatePreview() {
FileNameFormater formater(d->kcfg_AutoRenameFormat->text());
d->mPreviewOutputLabel->setText(formater.format(KUrl::fromPath("/" + PREVIEW_FILENAME), PREVIEW_DATETIME));
}
} // namespace
diff --git a/importer/importerconfigdialog.ui b/importer/importerconfigdialog.ui
index ff7b8407..cc47d418 100644
--- a/importer/importerconfigdialog.ui
+++ b/importer/importerconfigdialog.ui
@@ -1,188 +1,163 @@
ImporterConfigDialog
0
0
410
- 300
+ 213
-
Rename documents automatically
-
false
+
+
+ 0
+ 0
+
+
-
- 0
+
+ 24
-
-
-
+
-
+
+
+ Rename Format:
+
+
+ Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter
+
+
+
+ -
+
+
+ -
+
+
+ [Output preview]
+
+
- -
-
-
-
+
-
+
+
+ Preview:
+
+
+ Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter
-
-
-
-
-
- Rename Format:
-
-
- Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter
-
-
- kcfg_AutoRenameFormat
-
-
-
- -
-
-
- -
-
-
- [Output preview]
-
-
-
- -
-
-
- Preview:
-
-
- Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter
-
-
-
- -
-
-
- - {date}: shooting date
+
+
+ -
+
+
+ - {date}: shooting date
- {name}: original file name
-
-
- true
-
-
- Qt::LinksAccessibleByMouse
-
-
-
- -
-
-
- <i>Type text or click the items below to customize the format</i>
-
-
-
- -
-
-
- Qt::Vertical
-
-
- QSizePolicy::Fixed
-
-
-
- 20
- 24
-
-
-
-
- -
-
-
- Qt::Vertical
-
-
- QSizePolicy::Fixed
-
-
-
- 20
- 24
-
-
-
-
-
+
+
+ true
+
+
+ Qt::LinksAccessibleByMouse
+
- -
-
+
-
+
+
+ <i>Type text or click the items below to customize the format</i>
+
+
+
+ -
+
+
+ Qt::Vertical
+
+
+ QSizePolicy::Fixed
+
+
+
+ 20
+ 24
+
+
+
+
+ -
+
- Qt::Horizontal
+ Qt::Vertical
QSizePolicy::Fixed
- 24
- 20
+ 20
+ 24
-
Qt::Vertical
20
- 208
+ 20
KLineEdit
QLineEdit
kcfg_AutoRename
toggled(bool)
widget
setEnabled(bool)
97
23
136
58