tdegraphics/doc/kview/index.docbook

<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kview;">
  <!ENTITY package "tdegraphics">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title>The &kview; Handbook</title>

<authorgroup>
<author>
<firstname>Hauke</firstname>
<surname>Hildebrandt</surname>
<affiliation>
<address>&Hauke.Hildebrandt.mail;</address>
</affiliation>
</author>

<othercredit role="developer">
<firstname>Sirtaj</firstname>
<othername>Singh</othername>
<surname>Kang</surname>
<contrib>Developer</contrib>
</othercredit>

<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<affiliation><address>&Lauri.Watts.mail;</address></affiliation>
<contrib>Reviewer</contrib>
</othercredit>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>


<copyright>
<year>2001</year>
<holder>&Hauke.Hildebrandt;</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2006-05-20</date>
<releaseinfo>3.5.2</releaseinfo>

<abstract><para>&kview; is an image viewing program. It is small and fast and
has some simple image processing commands. You can work with many different
graphic file formats and convert your images to them. &kview; is not a
fully-fledged image processor but it is sufficient for many of your everyday
tasks.</para></abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>kview</keyword>
<keyword>tdegraphics</keyword>
<keyword>image</keyword>
<keyword>graphic</keyword>
<keyword>viewer</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>&kview; is an image viewer for the &kde; desktop. You can view
graphics of many different formats such as &PostScript;,
<acronym>TIFF</acronym> &etc; By saving your files in a different
format than the original you can easily convert images to other
graphics formats. In addition, &kview; provides some nice little
features for doing simple image processing, like stretching/shrinking,
rotation and applying effects. You can arrange your images in a little
slideshow.</para>

</chapter>

<chapter id="menus">
<title>Menu Reference</title>

<para>When you start &kview; you see the typical application layout: a
workspace containing your documents (images in this case), a menubar that
provides access to the various commands, a toolbar with shortcut buttons for
some of them and a status bar at the bottom to display status messages. When
you have the loaded an image into &kview;, there is also an additional
context menu available which is displayed by clicking your right mouse
button over the image. Below, all menu entries are explained in the order
that they appear in the menubar.</para>

<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 &kview;. The size of the
&kview; main window and the image after loading are determined by your
settings. If you open several images, only the last one is shown, but all of
them can be accessed using the image list.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Open Recent</guimenuitem>
</menuchoice></term>
<listitem><para><action>Displays a list of recently opened images.</action>
Selecting one from this list reopens the image.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul">
&Ctrl;<keycap>S</keycap></keycombo></shortcut>
<guimenu>File</guimenu>
<guimenuitem>Save</guimenuitem>
</menuchoice></term>
<listitem><para><action>Save the current image</action>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Save As</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the image under a different name</action>. By
choosing a new file format you can convert the image to a different graphics
type.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;
<keycap>P</keycap></keycombo></shortcut>
<guimenu>File</guimenu>
<guimenuitem>Print...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Prints the image</action>. In the standard &kde; print dialog
click the <guibutton>Options &gt;&gt;</guibutton> button, go to the tab <guilabel>Image 
Settings</guilabel>. Select <guilabel>Fit image to page size</guilabel> or
<guilabel>Center image on page</guilabel>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycombo>
&Ctrl;<keycap>W</keycap></keycombo></shortcut>
<guimenu>File</guimenu>
<guimenuitem>Close</guimenuitem>
</menuchoice></term>
<listitem><para><action>Closes the currently displayed
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> &kview;. If you have several &kview;
images 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><keycombo action="simul">&Ctrl;
<keycap>C</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Copy</guimenuitem></menuchoice>
</term>
<listitem>
<para><action>Copies</action> the entire image or the selection to the clipboard.</para> 
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;
<keycap>V</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Paste</guimenuitem></menuchoice>
</term>
<listitem>
<para><action>Paste</action> the contents of the clipboard as a new image (only available, if the clipboard contains a valid image).</para> 
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycap>C</keycap></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Crop</guimenuitem>
</menuchoice></term>
<listitem>
<para>If you have selected any part of the image (by drawing a box around it
using your mouse) you can cut off all the rest around it by using this
option. Your image is effectively reduced to your selection.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycap>F5</keycap></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Reload</guimenuitem>
</menuchoice></term>
<listitem><para><action>Reloads</action> the image to its original state (right
after opening it).</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 image.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycap>V</keycap></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Flip</guimenuitem>
<guimenuitem>Vertical</guimenuitem>
</menuchoice></term>
<listitem><para><action>Flips the image along the
vertical</action>. Mathematically, this does a reflection along the image's
horizontal center line.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycap>H</keycap></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Flip</guimenuitem>
<guimenuitem>Horizontal</guimenuitem>
</menuchoice></term>
<listitem><para><action>Flips the image along the
horizontal</action>. Mathematically, this does a reflection along the image's
vertical center line.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Rotate Counter-Clockwise</guimenuitem>
</menuchoice></term>
<listitem><para><action>Rotates the image by 90° in the counter-clockwise
direction</action>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Rotate Clockwise</guimenuitem>
</menuchoice></term>
<listitem><para><action>Rotates the image by 90° in the clockwise
direction</action>.</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="effects-menu">
<title>The <guimenu>Effects</guimenu> Menu</title>

<para>&kview; provides some functions for simple image processing:</para>

<para>This menu item is only displayed in the menubar, if you choose the 
application plugin effects in &kview;s configure dialog</para>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Effects</guimenu>
<guimenuitem>Gamma Correction...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Adjusts the gamma factor.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Effects</guimenu>
<guimenuitem>Blend Color...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Blends the image to selected color and opacity</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Effects</guimenu>
<guimenuitem>Change Intensity (Brightness)...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Changes the brightness of the image.</action> Enter the
new brightness in percent (with respect to the <emphasis>initial</emphasis>
value).</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="view-menu">
<title>The <guimenu>View</guimenu> Menu</title>

<variablelist>
<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>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Zoom...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens a list to <action>choose the zoom
factor</action>. This value is given in percent and always refers to the
<emphasis>initial</emphasis> size of the picture.</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>
<guimenu>View</guimenu><guimenuitem>Fit Image
to Window</guimenuitem></menuchoice></term>
<listitem><para><action>Maximizes the image size</action>. The image is scaled
to the window size, keeping the aspect
ratio.</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="go-menu">
<title>The <guimenu>Go</guimenu> Menu</title>

<para>This item is only displayed in the menubar, if you choose the 
application plugin presenter in &kview;s configure dialog</para>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Go</guimenu>
<guimenuitem>Image List...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Displays a list of the currently loaded images.</action>
You can flip through the images by either double-clicking on them or using the
<guibutton>Previous</guibutton> and <guibutton>Next</guibutton>
buttons. <guibutton>Shuffle</guibutton> rearranges the images in a random order. 
Pressing
<guibutton>Start Slideshow</guibutton> will start the slideshow with the current
settings for the interval. In addition, you can save and load your image
list using the corresponding buttons.
<guilabel>Slideshow interval:</guilabel> <!--is guilabel correct? -->
Here you can change the interval between the different slides for the slideshow.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycap>S</keycap></shortcut>
<guimenu>Go</guimenu>
<guimenuitem>Start/Stop Slideshow</guimenuitem>
</menuchoice></term>
<listitem><para><action>Starts or stops the
slideshow.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul">
&Alt;<keysym>Left Arrow</keysym></keycombo></shortcut>
<guimenu>Go</guimenu>
<guimenuitem>Previous Image in List</guimenuitem>
</menuchoice></term>
<listitem><para><action>Switches to the previous image in the
list.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul">
&Alt;<keysym>Right Arrow</keysym></keycombo></shortcut>
<guimenu>Go</guimenu>
<guimenuitem>Next Image in List</guimenuitem></menuchoice></term>
<listitem><para><action>Switches to the next item in the
list.</action></para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="tools-menu">
<title>The <guimenu>Tools</guimenu> Menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Scan Image...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens</action> images from your scanner into &kview;.
This menu item is only displayed in the menubar, if you choose the 
application plugin scanner in &kview;s configure dialog
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul">
&Shift;<keysym>Left Arrow</keysym></keycombo></shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>Back</guimenuitem>
</menuchoice></term>
<listitem><para><action>Switches to the previous image in the current
folder.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul">
&Shift;<keysym>Right Arrow</keysym></keycombo></shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>Forward</guimenuitem>
</menuchoice></term>
<listitem><para><action>Switches to the next image in the current
folder.</action></para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings-menu">
<title>The <guimenu>Settings</guimenu> Menu</title>
<para>This menu provides options for configuring &kview;, changing its
appearance, shortcuts and standard behavior.</para>

<variablelist>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul">
&Ctrl;<keycap>M</keycap></keycombo></shortcut>
<guimenu>Settings</guimenu>
<guimenuitem>Show/Hide Menubar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggles the menubar on/off.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guisubmenu>Toolbars</guisubmenu>
<guimenuitem>Main Toolbar (KView)</guimenuitem>
</menuchoice></term>
<term><menuchoice><guimenu>Settings</guimenu>
<guisubmenu>Toolbars</guisubmenu>
<guimenuitem>Extra Toolbar (KView)</guimenuitem>
</menuchoice></term>
<listitem>
<para>Toggles the main toolbar and the extra toolbar on and off
respectively</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show/Hide Statusbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggles the status bar on/off.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show/Hide Scrollbars</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggles the Scrollbars on/off.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;
<keycap>&Shift;</keycap><keycap>F</keycap></keycombo></shortcut>
<guimenu>Settings</guimenu>
<guimenuitem>Fullscreen Mode</guimenuitem></menuchoice>
</term>
<listitem>
<para>This option maximizes the &kview; window and the currently shown image so
you can have a closer look at it. Even the window decorations (titlebar &etc;) are
temporarily removed. Selecting this option once again switches back to normal
mode.</para> 
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Shortcuts...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a dialog for changing the key bindings.</action>
Using this option you can change the standard key shortcut for &kview;'s commands
or create new ones.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Toolbars...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a dialog for configuring the toolbar.</action> You
can add and remove toolbuttons for &kview;'s commands with this
option.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure &kview;...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a dialog for changing some options</action> as
described in the section <xref linkend="kview-options"/></para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="help-menu">
<title>The <guimenu>Help</guimenu> Menu</title>

&help.menu.documentation;

</sect1>
</chapter>

<chapter id="command-line">
<title>Command Line Options</title>

<para>&kview; can be started directly from a terminal like &konsole; or
<application>xterm</application>. Several command line options are
available.</para>

<variablelist>
<varlistentry>
<term><command>kview</command> <option>--help</option></term>
<listitem><para>Lists the command line options (see below).</para></listitem>
</varlistentry>
<varlistentry>
<term><command>kview</command> <option>--help-qt</option></term>
<listitem><para>Shows the options specific to &Qt; (the &GUI;
library that &kde; is based on).</para></listitem>
</varlistentry>
<varlistentry>
<term><command>kview</command> <option>--help-kde</option></term>
<listitem><para>Shows the &kde;-specific options.</para></listitem>
</varlistentry>
<varlistentry>
<term><command>kview</command> <option>--help-all</option></term>
<listitem><para>Displays all command line options.</para></listitem>
</varlistentry>
<varlistentry>
<term><command>kview</command> <option>--author</option></term>
<listitem><para>You want to send your warm wishes and euphoric cheers to
someone? Here they are!</para></listitem>
</varlistentry>
<varlistentry>
<term><command>kview</command> <option>-v</option>,
<option>--version</option></term>
<listitem><para>Displays the version number of &kview; (and that of
&Qt;/&kde;).</para></listitem>
</varlistentry>
<varlistentry>
<term><command>kview</command> <option>--license</option></term>
<listitem><para>Shows under which licenses &kview; is being
published.</para></listitem>
</varlistentry>
</variablelist>
</chapter>

<chapter id="kview-options">
<title>&kview; Options</title>

<sect1 id="kview-options-viewer">
<title><guilabel>Viewer</guilabel></title>

<para>This is the configuration for the part of &kview; that can be reused 
by other applications (meaning that the settings will also affect the &kview; 
part that gets embedded into &konqueror; or other applications).</para>

<screenshot>
<screeninfo>&kview; viewer configuration dialog</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="kview-viewer-configuration.png" format="PNG"/></imageobject>
<textobject><phrase>&kview; viewer configuration dialog</phrase></textobject>
</mediaobject>
</screenshot>

<variablelist>
<title>General configuration options for KViewCanvas</title>
<varlistentry>
<term><guilabel>Use smooth scaling (high quality but
slower)</guilabel></term>
<listitem>
<para>As the option suggests, use a very high quality but relatively slow
method of scaling images.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Keep aspect ratio</guilabel></term>
<listitem>
<para>If this is checked &kview; will always try to keep the aspect
ratio. That means if the width is scaled with a factor x, the height is
scaled with the same factor.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Center image</guilabel></term>
<listitem>
<para>If checked, the opened image will be displayed centered to the &kview;
window.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Background Color</guilabel></term>
<listitem>
<para>Opens a normal &kde; color picker dialog, where you can choose the
background color for the image</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Minimum width:</guilabel></term>
<listitem>
<para>The width of the image shown will not get smaller than the size you
enter here. A value of 10 would cause a 1x1 image to be stretched
horizontally by a factor of 10.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Maximum width:</guilabel></term>
<listitem>
<para>The width of the image shown will not get bigger than the size you
enter here. A value of 100 would cause a 1000x1000 image to be compressed
horizontally  by a factor of 0.1.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Minimum height:</guilabel></term>
<listitem>
<para>The height of the image shown will not get smaller than the size you
enter here. A value of 10 would cause a 1x1 image to be stretched vertically
by a factor of 10. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Maximum height:</guilabel></term>
<listitem>
<para>The height of the image shown will not get bigger than the size you
enter here. A value of 100 would cause a 1000x1000 image to be compressed
vertically by a factor of 0.1. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Choose which blend effects should be used:</guilabel></term>
<listitem>
<para>Every effect selected may be used to create a transition effect
between the images. If you select multiple effects they will be chosen
randomly.
</para>
</listitem>
</varlistentry>
</variablelist>

<variablelist>
<title><guilabel>Chooose and Configure Your Plugins</guilabel></title>
<varlistentry>
<term><guilabel>Browser</guilabel></term>
<listitem>
<para>Here you can enable/disable use of the browser &kview; plugin, which
enables you to browse through all the images in the current folder.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="kview-options-application">
<title><guilabel>Application</guilabel></title>

<para>Here you can set options that are special for the &kview; application
when running stand-alone. What you change in here will not affect other
applications.</para>

<screenshot>
<screeninfo>&kview; application configuration dialog</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="kview-application-configuration.png" format="PNG"/></imageobject>
<textobject><phrase>&kview; application configuration dialog</phrase></textobject>
</mediaobject>
</screenshot>

<variablelist>
<title><guilabel>Application</guilabel></title>
<varlistentry>
<term><guilabel>Resizing</guilabel></term>
<listitem><para>This option determines if the window and/or the image will be
resized after loading a new picture into &kview;. With <guilabel>Only resize
window</guilabel> enabled, the &kview; window will be resized so that it snuggly
fits around the loaded image. Notice that this can reduce the main window almost
to a vertical arrangement of menu entries if you load a small button pixmap (you
can resize the window afterwards in the usual way, of course). If your image is
pretty large (in terms of pixels), sometimes the &kview; window is resized in
such a way that the caption bar completely moves off your screen. Similarly,
<guilabel>Resize image to fit window</guilabel> resizes the image to fit into the &kview;
workspace (keeping its aspect ratio intact). And with <guilabel>Don't
resize anything</guilabel> as your choice, both &kview; and your image keep their
size. With <guilabel>Best fit</guilabel>
&kview; will resize the window to fit the image. The image will never be 
scaled up but if it is too large for the screen the image will be scaled down.
</para></listitem>
</varlistentry>
</variablelist>

<variablelist>
<title><guilabel>Plugins</guilabel></title>
<varlistentry>
<term><guilabel>Effects</guilabel></term>
<listitem>
<para>Provides some image effects (and adds an <guimenu>Effects</guimenu> to
the menubar to give you access to them).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Presenter</guilabel></term>
<listitem>
<para>Creates an image list and enables you to create a slideshow.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Scanner</guilabel></term>
<listitem>
<para>Adds <guimenu>Scan Image...</guimenu> to the <guimenu>Tools</guimenu>
menu to open images from your scanner into &kview;.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

</chapter>

<chapter id="credits">
<title>Credits and License</title>

<para>&kview;</para>

<para>Program copyright 1997-2001 Sirtaj S. Kang
&Sirtaj.Singh.Kang.mail;</para>
<para>KParts integration by &Simon.Hausmann;
<email>shaus@neuro2.med.uni-magdeburg.de</email></para>
<para>Maintainer: Matthias Kretz <email>kretz@kde.org</email></para>
<para>Documentation copyright 2001 &Hauke.Hildebrandt;
&Hauke.Hildebrandt.mail;
</para>

<para>Documentation substantially updated by Burkhard Lück
<email>lueck@hube-lueck.de</email> in 2005 for &kde; 3.5</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL;               <!-- FDL: do not remove -->
&underGPL;        	 <!-- GPL License -->

</chapter>

<appendix id="installation">
<title>Installation</title>

<sect1 id="getting-kview">
<title>How to obtain &kview;</title>

&install.intro.documentation;

&install.compile.documentation;

</sect1>

<sect1 id="requirements">
<title>Requirements</title>

<para>Since &kview; is part of the &kde; desktop you need a working &kde;
installation to use it. However, some additional libraries are needed by &kview;
to use the various graphics file formats. For example, to handle the
<acronym>PNG</acronym> format &kview; needs the corresponding library
libpng. &kview; uses the libraries that are registered by
tdelibs/kimgio.</para>

</sect1>

</appendix>

&documentation.index;
</book>