diff options
Diffstat (limited to 'doc/kview/index.docbook')
| -rw-r--r-- | doc/kview/index.docbook | 835 |
1 files changed, 835 insertions, 0 deletions
diff --git a/doc/kview/index.docbook b/doc/kview/index.docbook new file mode 100644 index 00000000..e1ddbbdf --- /dev/null +++ b/doc/kview/index.docbook @@ -0,0 +1,835 @@ +<?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 "kdegraphics"> + <!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>kdegraphics</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 >></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 +kdelibs/kimgio.</para> + +</sect1> + +</appendix> + +&documentation.index; +</book> +<!-- +Local Variables: +mode: sgml +sgml-minimize-attributes: nil +sgml-general-insert-case: lower +End: +--> |