You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1042 lines
27 KiB
1042 lines
27 KiB
<?xml version="1.0" ?>
|
|
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
|
|
<!ENTITY kappname "&kuickshow;">
|
|
<!ENTITY package "kdegraphics">
|
|
<!ENTITY % addindex "IGNORE">
|
|
<!ENTITY % English "INCLUDE"><!-- change language only here -->
|
|
]>
|
|
|
|
<!-- The language must NOT be changed here. -->
|
|
<book lang="&language;">
|
|
|
|
<bookinfo>
|
|
<title>The &kuickshow; Handbook</title>
|
|
|
|
<authorgroup>
|
|
<author>
|
|
<firstname>Carsten</firstname>
|
|
<surname>Pfeiffer</surname>
|
|
<affiliation>
|
|
<address>&Carsten.Pfeiffer.mail;</address>
|
|
</affiliation>
|
|
</author>
|
|
<!-- TRANS:ROLES_OF_TRANSLATORS -->
|
|
</authorgroup>
|
|
|
|
<copyright>
|
|
<year>2001</year>
|
|
<holder>&Carsten.Pfeiffer;</holder>
|
|
</copyright>
|
|
|
|
<legalnotice>&FDLNotice;</legalnotice>
|
|
|
|
<date>2005-12-29</date>
|
|
<releaseinfo>0.8.7</releaseinfo>
|
|
|
|
<!-- Abstract about this handbook -->
|
|
|
|
<abstract>
|
|
<para>
|
|
&kuickshow; is a comfortable image browser/viewer.
|
|
</para>
|
|
</abstract>
|
|
|
|
<keywordset>
|
|
<keyword>KDE</keyword>
|
|
<keyword>kdegraphics</keyword>
|
|
<keyword>kuickshow</keyword>
|
|
<keyword>image</keyword>
|
|
<keyword>viewer</keyword>
|
|
</keywordset>
|
|
|
|
</bookinfo>
|
|
|
|
<chapter id="introduction">
|
|
<title>Introduction</title>
|
|
|
|
<para>
|
|
&kuickshow; is a comfortable image browser/viewer. It displays a
|
|
filebrowser where you can select images which are then shown.
|
|
</para>
|
|
|
|
<!-- LW: put a nice screenshot here -->
|
|
|
|
<para>The following image formats are supported:</para>
|
|
<itemizedlist>
|
|
<listitem><para>jpg</para>
|
|
</listitem>
|
|
<listitem><para>gif</para>
|
|
</listitem>
|
|
<listitem><para>tiff</para>
|
|
</listitem>
|
|
<listitem><para>png</para>
|
|
</listitem>
|
|
<listitem><para>bmp</para>
|
|
</listitem>
|
|
<listitem><para>psd</para>
|
|
</listitem>
|
|
<listitem><para>xpm</para>
|
|
</listitem>
|
|
<listitem><para>ppm</para>
|
|
</listitem>
|
|
<listitem><para>pgm</para>
|
|
</listitem>
|
|
<listitem><para>pbm</para>
|
|
</listitem>
|
|
<listitem><para>pnm</para>
|
|
</listitem>
|
|
<listitem><para>eim</para>
|
|
</listitem>
|
|
<listitem><para>xcf</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<para>Images can be displayed either in their own window, as large as
|
|
the image, or fullscreen.</para>
|
|
|
|
</chapter>
|
|
|
|
<chapter id="using-kuickshow">
|
|
<title>Using &kuickshow;</title>
|
|
|
|
<para>Using &kuickshow; is very simple. The file browser lists files,
|
|
which you can select with a &LMB; click or the <keycap>Return</keycap>
|
|
key.</para>
|
|
|
|
<screenshot>
|
|
<screeninfo>Here's a screenshot of &kuickshow;</screeninfo>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="screenshot.png" format="PNG"/>
|
|
</imageobject>
|
|
<imageobject>
|
|
<imagedata fileref="screenshot.eps" format="EPS"/>
|
|
</imageobject>
|
|
<textobject>
|
|
<phrase>Screenshot</phrase>
|
|
</textobject>
|
|
</mediaobject>
|
|
</screenshot>
|
|
|
|
|
|
<sect1 id="kuickshow-features">
|
|
<title>More &kuickshow; features</title>
|
|
|
|
<para>The options dialog makes available more possibilities:</para>
|
|
|
|
<itemizedlist>
|
|
<listitem><para>Images can be automatically shrunk to fit onto the
|
|
screen, if they are larger.</para>
|
|
</listitem>
|
|
<listitem><para>You can configure whether images should show up in
|
|
their own window, or always use the same window.</para>
|
|
</listitem>
|
|
<listitem><para>You can set the delay time for a slide show.</para>
|
|
</listitem>
|
|
<listitem><para>You can tell the browser which file types to show.</para>
|
|
</listitem>
|
|
<listitem><para>You can tweak the speed/quality
|
|
ratio</para></listitem>
|
|
</itemizedlist>
|
|
|
|
<para>If you are looking for a certain file, just enter the first few
|
|
characters of it's filename in the browser. A small edit window will
|
|
pop up in the bottom right corner. When a matching file is found, it
|
|
is highlighted. You can leave the edit window by pressing
|
|
<keycap>Return</keycap> or &Esc;.</para>
|
|
|
|
</sect1>
|
|
</chapter>
|
|
|
|
<chapter id="configuration-dialog">
|
|
<title>The <guilabel>&kuickshow; Configuration</guilabel>
|
|
Dialog</title>
|
|
|
|
<para>The <guilabel>&kuickshow; Configuration</guilabel> dialog
|
|
contains 5 tabs. Three of them, <link
|
|
linkend="general-options"><guilabel>General</guilabel></link>, <link
|
|
linkend="modifications-options"><guilabel>Modifications</guilabel></link>
|
|
and <link linkend="slideshow-options"><guilabel>Slideshow</guilabel></link>
|
|
configure the operation of &kuickshow;, and the other two,
|
|
<link linkend="shortcuts-options"><guilabel>Viewer Shortcuts</guilabel></link>
|
|
and <link linkend="shortcuts-options"><guilabel>Browser Shortcuts</guilabel></link>
|
|
allow you to personalize the shortcuts for the
|
|
respective windows.</para>
|
|
|
|
<sect1 id="general-options">
|
|
<title><guilabel>General</guilabel> Options</title>
|
|
|
|
<para>The <guilabel>General</guilabel> contains the options to
|
|
configure and tune &kuickshow;.</para>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Fullscreen mode</guilabel></term>
|
|
<listitem>
|
|
<para>If this is selected, images open in full screen mode. If the
|
|
image is not large enough to fill the screen, the rest of the screen
|
|
is filled with the background color selected below. The default is
|
|
off.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Preload next image</guilabel></term>
|
|
<listitem>
|
|
<para>If this is selected, &kuickshow; will load the next image in the
|
|
folder, while you are looking at the current one. This reduces the
|
|
delay when you select the next image, and is especially useful for
|
|
slide shows.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Remember last folder</guilabel></term>
|
|
<listitem>
|
|
<para>If this is selected, &kuickshow; saves the name of the last folder on exit.
|
|
On next start &kuickshow; will open this folder in the browser window.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Background color:</guilabel></term>
|
|
<listitem>
|
|
<para>Click on the colored bar to select a background color. This is
|
|
used to fill the screen in fullscreen mode, or the window, if you have
|
|
resized it larger than the image.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Show only files with extension:</guilabel></term>
|
|
<listitem>
|
|
<para>You can configure &kuickshow; to only show you some of the file
|
|
types it is capable of.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<variablelist>
|
|
<title><guilabel>Quality/Speed</guilabel></title>
|
|
<varlistentry>
|
|
<term><guilabel>Fast rendering</guilabel></term>
|
|
<listitem><para><!-- LW: Uhm.. help? -->Render things fast.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Dither in HiColor (15/16bit) modes</guilabel></term>
|
|
<listitem><para><!-- LW: Maybe these should be on an advanced tab -->
|
|
<!-- Write an example what this does here -->
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Dither in LowColor (<=8bit) modes</guilabel></term>
|
|
<listitem><para><!-- And here -->
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Use own color palette</guilabel></term>
|
|
<listitem><para><!-- and this one -->
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Fast palette remapping</guilabel></term>
|
|
<listitem>
|
|
<para><!-- and this one -->
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Maximum cache size (MB):</guilabel></term>
|
|
<listitem>
|
|
<para><!-- and another -->
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="modifications-options">
|
|
<title>The <guilabel>Modifications</guilabel> Tab</title>
|
|
|
|
<para>Check <guilabel>Apply default image modifications</guilabel> to open an image
|
|
with these modifications in &kuickshow;.</para>
|
|
|
|
<variablelist>
|
|
<title><guilabel>Scaling</guilabel></title>
|
|
<varlistentry>
|
|
<term><guilabel>Shrink image to screen size, if larger</guilabel></term>
|
|
<listitem>
|
|
<para>If this is selected, large images are displayed in maximized window. The default is
|
|
on.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Shrink image to screen size, if smaler, up to factor:</guilabel></term>
|
|
<listitem>
|
|
<para>If this is selected, &kuickshow; increases the magnification of small images up to
|
|
the selected factor.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<variablelist>
|
|
<title><guilabel>Geometry</guilabel></title>
|
|
<varlistentry>
|
|
<term><guilabel>Flip vertically</guilabel></term>
|
|
<listitem><para>Flips the image vertically.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Flip horizontally</guilabel></term>
|
|
<listitem><para>Flips the image horizontally.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Rotate image</guilabel></term>
|
|
<listitem><para>Rotates the image to 0, 90, 180 or 270 degrees.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<variablelist>
|
|
<title><guilabel>Adjustments</guilabel></title>
|
|
<varlistentry>
|
|
<term><guilabel>Brightness:</guilabel></term>
|
|
<listitem><para>Lightens/darkens the image.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Contrast:</guilabel></term>
|
|
<listitem><para>Adds/Removes contrast.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Gamma:</guilabel></term>
|
|
<listitem><para>More/less gamma.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para>A <guilabel>Preview</guilabel> of the <guilabel>Original</guilabel>
|
|
and <guilabel>Modified</guilabel> image is displayed below this options.</para>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="slideshow-options">
|
|
<title>The <guilabel>Slideshow</guilabel> Tab</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Switch to full-screen</guilabel></term>
|
|
<listitem>
|
|
<para>Indicates if &kuickshow; should switch to full-screen mode
|
|
when starting the slideshow.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Start with current image</guilabel></term>
|
|
<listitem>
|
|
<para>Indicates if the slideshow should start with the first
|
|
image in the folder or with the image which is selected.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Delay between slides:</guilabel></term>
|
|
<listitem>
|
|
<para>The length of time between image changes during the slideshow.
|
|
You can use the slider, type a new value into the field,
|
|
or use the small arrows to increase or decrease the value. The
|
|
default is 3 seconds.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Iterations (0 = infinite):</guilabel></term>
|
|
<listitem>
|
|
<para>The amount of iterations. If set to 0 it will loop untill you
|
|
abort the slideshow. You can use the slider, type a new value into the
|
|
field, or use the small arrows to increase or decrease the value. The
|
|
default is 1.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</sect1>
|
|
|
|
<sect1 id="shortcuts-options">
|
|
<title>The <guimenu>Shortcuts</guimenu> Tabs</title>
|
|
<para>Change the shortcuts for the different modes of &kuickshow;
|
|
in the <guilabel>Viewer Shortcuts</guilabel> and the <guilabel>Browser Shortcuts</guilabel> tabs.</para>
|
|
</sect1>
|
|
|
|
</chapter>
|
|
|
|
<chapter id="menus">
|
|
<title>Menu Reference</title>
|
|
|
|
<sect1 id="file-menu">
|
|
<title>The <guimenu>File</guimenu> Menu</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Open</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Opens a new image</action> in &kuickshow;.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Show Image</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Displays </action> the selected image in a new image
|
|
window.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Show Image in Aktive Window</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Displays </action>the selected image in the active image
|
|
window.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Show Image in Fullscreen Mode</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Displays</action> the selected image in fullscreen mode.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut><keycap>F2</keycap></shortcut>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Start Slideshow</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Starts</action> a slideshow of the images in the folder.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut><keycombo action="simul">&Ctrl;
|
|
<keycap>P</keycap></keycombo></shortcut>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Print Image...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Prints the image</action>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice><shortcut><keycombo action="simul">
|
|
&Ctrl;<keycap>Q</keycap></keycombo></shortcut>
|
|
<guimenu>File</guimenu>
|
|
<guimenuitem>Quit</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Quits</action> &kuickshow;. If you have several
|
|
images windows open, all of them are closed.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="edit-menu">
|
|
<title>The <guimenu>Edit</guimenu> Menu</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut><keycap>F10</keycap></shortcut>
|
|
<guimenu>Edit</guimenu>
|
|
<guimenuitem>New Folder...</guimenuitem></menuchoice>
|
|
</term>
|
|
<listitem>
|
|
<para><action>Create</action> a new folder.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice><shortcut><keycombo action="simul">
|
|
<keycap>&Shift;</keycap><keycap>Delete</keycap></keycombo></shortcut>
|
|
<guimenu>Edit</guimenu>
|
|
<guimenuitem>Delete</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Deletes</action> the current file. You will be asked to confirm the
|
|
action.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut><keycombo action="simul">
|
|
<keycap>&Alt;</keycap><keycap>Return</keycap></keycombo></shortcut>
|
|
<guimenu>Edit</guimenu>
|
|
<guimenuitem>Properties</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Displays</action> the properties of the current image file.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="view-menu">
|
|
<title>The <guimenu>View</guimenu> Menu</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut><keycap>F6</keycap></shortcut>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Short View</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>If this option is selected, only the names of the files and folders will be shown.</para>
|
|
<para>Compare this to detailed view.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut><keycap>F7</keycap></shortcut>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Detailed View</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>If this option is selected, the names, sizes, dates, permissions, file owners and group ownerships are shown.</para>
|
|
<para>Compare this to short view.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut><keycap>F8</keycap></shortcut>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Show Hidden Files</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>This will toggle between revealing and hiding normally hidden files.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut><keycap>F12</keycap></shortcut>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Separate Folders</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Use this option to toggle between a 2 pane view of the file system (one pane for the folders
|
|
and one pane for the files) and a one pane view of the file system with folders and files.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Large Icons</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Display the image files in the folder with large icons.
|
|
This item is only available in <guimenuitem>Short View</guimenuitem> mode.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Small Icons</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Display the image files in the folder with small icons.
|
|
This item is only available in <guimenuitem>Short View</guimenuitem> mode.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Thumbnail Previews</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Display a preview of the images in the folder. This item is only available in <guimenuitem>Short View</guimenuitem> mode.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice><shortcut><keycombo action="simul">
|
|
&Ctrl;<keycap>-</keycap></keycombo></shortcut>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Zoom Out</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Reduces the image size by ten percent</action>. Again
|
|
this refers to the <emphasis>current</emphasis> size of the
|
|
image.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice><shortcut><keycombo action="simul">
|
|
&Ctrl;<keycap>+</keycap></keycombo></shortcut>
|
|
<guimenu>View</guimenu>
|
|
<guimenuitem>Zoom In</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Enlarges the image by ten percent</action>. Notice that
|
|
this refers to the <emphasis>current</emphasis> size of the
|
|
picture.</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="settings-menu">
|
|
<title>The <guimenu>Settings</guimenu> Menu</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>Settings</guimenu>
|
|
<guimenuitem>Configure &kuickshow;...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Opens a dialog for changing some options</action> as
|
|
described in the section <xref linkend="configuration-dialog"/></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="help-menu">
|
|
<title>The <guimenu>Help</guimenu> Menu</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>
|
|
<menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul"><keycap>F1</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenu>Help</guimenu>
|
|
<guimenuitem>&kappname; Handbook</guimenuitem>
|
|
</menuchoice>
|
|
</term>
|
|
<listitem><para><action>Invokes the &kde; Help system</action> starting at the
|
|
&kappname; help pages. (this document).</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>Help</guimenu>
|
|
<guimenuitem>Report Bug...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>Opens the Bug report dialog</action> where you can
|
|
report a bug or request a <quote>wishlist</quote> feature.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>Help</guimenu>
|
|
<guimenuitem>About &kappname;</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>This will display version and author
|
|
information.</action></para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenu>Help</guimenu>
|
|
<guimenuitem>About KDE</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para><action>This displays the &kde; version and other basic
|
|
information.</action></para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
</chapter>
|
|
|
|
<chapter id="commands">
|
|
<title>Command Reference</title>
|
|
|
|
<sect1 id="keybindings">
|
|
<title>The Image Window</title>
|
|
|
|
<para>All the shortcuts are configurable from the <link
|
|
linkend="configuration-dialog">Configuration Dialog</link>.</para>
|
|
|
|
<table>
|
|
<title>Image Window Keyboard Shortcuts</title>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>Key</entry>
|
|
<entry>Action</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry><keycap>Page Down</keycap></entry>
|
|
<entry>Load the next image</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Page Up</keycap></entry>
|
|
<entry>Load the previous image</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Home</keycap></entry>
|
|
<entry>Loads the first image</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>End</keycap></entry>
|
|
<entry>Loads the last image</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>+</keycap></entry>
|
|
<entry>Zooms into the image</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>-</keycap></entry>
|
|
<entry>Zooms out of the image</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>*</keycap></entry>
|
|
<entry>Flips the image horizontally</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>/</keycap></entry>
|
|
<entry>Flips the image vertically</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>7</keycap></entry>
|
|
<entry>Rotates 270° clockwise (which is also 90°
|
|
counter-clockwise)</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>8</keycap></entry>
|
|
<entry>Rotates 90° clockwise</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>9</keycap></entry>
|
|
<entry>Rotates 180° clockwise</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Arrow</keycap> keys</entry>
|
|
<entry>Move the image (or rather, you, the viewer,) if it is larger
|
|
than the screen</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Return</keycap></entry>
|
|
<entry>Toggles between fullscreen and window mode</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Space</keycap></entry>
|
|
<entry>Toggles the display of the browser</entry>
|
|
</row>
|
|
<row>
|
|
<entry>&Esc;</entry>
|
|
<entry>Closes the image window. This will close &kuickshow; entirely,
|
|
if you don't have a browser window open.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>B</keycap>/<keycombo action="simul">&Shift;<keycap>B</keycap></keycombo></entry>
|
|
<entry>Lightens/darkens the image</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>C</keycap>/<keycombo action="simul">&Shift;<keycap>C</keycap></keycombo></entry>
|
|
<entry>Adds/Removes contrast</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>G</keycap>/<keycombo action="simul">&Shift;<keycap>G</keycap></keycombo></entry>
|
|
<entry>More/less <firstterm>gamma</firstterm></entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>O</keycap></entry>
|
|
<entry>Shows the image in original size. This is only useful when you
|
|
have enabled automatic scaling.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Enter</keycap></entry>
|
|
<entry>Redisplays the image with the default settings and
|
|
size.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></entry>
|
|
<entry>Opens the <guilabel>Save As</guilabel> dialog</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Delete</keycap></entry>
|
|
<entry>Deletes the current image. You will be asked to confirm the
|
|
request.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycombo action="simul">&Shift;<keycap>Delete</keycap></keycombo></entry>
|
|
<entry>Deletes the current image without asking for
|
|
confirmation</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycombo action="simul">&Alt;<keycap>Return</keycap></keycombo></entry>
|
|
<entry>Displays the properties of the image</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>F1</keycap></entry>
|
|
<entry>Opens the online help (this file)</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></entry>
|
|
<entry>Quits &kuickshow;</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
|
|
<table>
|
|
<title>Image Window Mouse Usage</title>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>Mouse button</entry>
|
|
<entry>Action</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry><mousebutton>Right</mousebutton> click</entry>
|
|
<entry>Opens the context menu, with several options</entry>
|
|
</row>
|
|
<row>
|
|
<entry><mousebutton>Left</mousebutton> drag</entry>
|
|
<entry>Moves the image, if it doesn't fit in the window.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycombo action="simul">&Shift;<mousebutton>Left</mousebutton>
|
|
</keycombo> drag</entry>
|
|
<entry>Marks a rectangle you can zoom into.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><mousebutton>Left</mousebutton> double click</entry>
|
|
<entry>Closes the current image</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="browser-window">
|
|
<title>The Browser Window</title>
|
|
|
|
<table>
|
|
<title>Browser Window Keybindings</title>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>Keybinding</entry>
|
|
<entry>Action</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry><keycap>Return</keycap></entry>
|
|
<entry>Enters a folder, or opens an image window, depending on the
|
|
item selected.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Page Down</keycap></entry>
|
|
<entry>Advances one page in the list of files</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Page Up</keycap></entry>
|
|
<entry>Moves back up a page in the list of files</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Home</keycap></entry>
|
|
<entry>Selects the first file or folder</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>End</keycap></entry>
|
|
<entry>Selects the last file or folder</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Space</keycap></entry>
|
|
<entry>Toggles showing the browser, if an image window is open</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>any alpha-numeric character</keycap></entry>
|
|
<entry>Opens the edit field used for <quote>completion</quote>. Enter
|
|
the first characters of a filename to search for, and if found, the
|
|
file will be selected.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycombo
|
|
action="simul">&Ctrl;<keycap>G</keycap></keycombo></entry>
|
|
<entry><quote>Go to</quote> — lets you enter a folder to go
|
|
to.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>Delete</keycap></entry>
|
|
<entry>Deletes the current file. You will be asked to confirm the
|
|
action.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycombo
|
|
action="simul">&Shift;<keycap>Delete</keycap></keycombo></entry>
|
|
<entry>Deletes the current file without asking for
|
|
confirmation.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycap>F1</keycap></entry>
|
|
<entry>Opens the online help (this file)</entry>
|
|
</row>
|
|
<row>
|
|
<entry><keycombo
|
|
action="simul">&Ctrl;<keycap>Q</keycap></keycombo></entry>
|
|
<entry>Quits &kuickshow;</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
|
|
<table>
|
|
<title>Browser Window Mouse Usage</title>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>Mouse Usage</entry>
|
|
<entry>Action</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry><mousebutton>Left</mousebutton> click</entry>
|
|
<entry>Enter a folder, or select an image window.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><mousebutton>Right</mousebutton> click</entry>
|
|
<entry>Opens a context menu, with several options.</entry>
|
|
</row>
|
|
<row>
|
|
<entry>Double click</entry>
|
|
<entry>Loads the selected image or enters the selected
|
|
folder</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
|
|
</table>
|
|
|
|
</sect1>
|
|
</chapter>
|
|
|
|
<chapter id="credits">
|
|
|
|
<!-- Include credits for the programmers, documentation writers, and
|
|
contributors here. The license for your software should then be included below
|
|
the credits with a reference to the appropriate license file included in the KDE
|
|
distribution. -->
|
|
|
|
<title>Credits and License</title>
|
|
|
|
<para>
|
|
&kuickshow;
|
|
</para>
|
|
<para>
|
|
Program copyright 1998-2002 &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;
|
|
</para>
|
|
|
|
<para>
|
|
Documentation copyright 2001 &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;
|
|
</para>
|
|
<para>Converted to DocBook &XML; and extended by &Lauri.Watts;
|
|
&Lauri.Watts.mail;</para>
|
|
|
|
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
|
|
|
|
&underFDL; <!-- FDL: do not remove -->
|
|
|
|
&underGPL; <!-- GPL License -->
|
|
|
|
</chapter>
|
|
|
|
<appendix id="installation">
|
|
<title>Installation</title>
|
|
|
|
<sect1 id="getting-kuickshow">
|
|
<title>How to obtain &kuickshow;</title>
|
|
|
|
&install.intro.documentation;
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="requirements">
|
|
<title>Requirements</title>
|
|
|
|
<para>To be written</para>
|
|
<!--
|
|
List any special requirements for your application here. This should include:
|
|
.Libraries or other software that is not included in kdesupport,
|
|
kdelibs, or kdebase.
|
|
.Hardware requirements like amount of RAM, disk space, graphics card
|
|
capabilities, screen resolution, special expansion cards, etc.
|
|
.Operating systems the app will run on. If your app is designed only for a
|
|
specific OS, (you wrote a graphical LILO configurator for example) put this
|
|
information here.
|
|
|
|
|
|
<para>
|
|
In order to successfully use &kuickshow;, you need &kde; 1.1. Foobar.lib is
|
|
required in order to support the advanced &kuickshow; features. &kuickshow; uses
|
|
about 5 megs of memory to run, but this may vary depending on your
|
|
platform and configuration.
|
|
</para>
|
|
|
|
<para>
|
|
All required libraries as well as &kuickshow; itself can be found
|
|
on <ulink url="ftp://ftp.kapp.org">The &kuickshow; home page</ulink>.
|
|
</para>
|
|
-->
|
|
|
|
<!-- For a list of updates, you may refer to the application web site
|
|
or the ChangeLog file, or ...
|
|
<para>
|
|
You can find a list of changes at <ulink
|
|
url="http://apps.kde.org/kapp">http://apps.kde.org/kapp</ulink>.
|
|
</para>-->
|
|
</sect1>
|
|
|
|
<sect1 id="compilation">
|
|
<title>Compilation and Installation</title>
|
|
|
|
&install.compile.documentation;
|
|
|
|
</sect1>
|
|
|
|
</appendix>
|
|
|
|
&documentation.index;
|
|
</book>
|
|
|
|
<!--
|
|
Local Variables:
|
|
mode: sgml
|
|
sgml-minimize-attributes:nil
|
|
sgml-general-insert-case:lower
|
|
sgml-indent-step:0
|
|
sgml-indent-data:nil
|
|
End:
|
|
-->
|
|
|