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.
829 lines
26 KiB
829 lines
26 KiB
<?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 >></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>
|