


---------->  This README text is available in English only.  <----------
             Please see the doc/HTML/index.html for details
             and some information given in other languages.





 IndeView  --  Independent Presentation Viewer
 =============================================
 IndeView web pages:   http://www.indeview.org



 /---------------------------------------------------------------------\
 |                                                                     |
 |   The IndeView program program displays presentations created       |
 |   from an OpenOffice.org-/StarOffice Impress presentation or        |
 |   from a KOffice KPresenter presentation without requring the       |
 |   respective office suite to be installed.                          |
 |                                                                     |
 |   Currently available for Windows and Linux the viewer may also     |
 |   autostart from CD on Windows if the user has not disabled this.   |
 |                                                                     |
 \---------------------------------------------------------------------/



Contents
--------
 1. Legal stuff
 2. Project description
 3. Available documentation
 4. Current limitations
 5. How to compile IndeView
 6. Your feedback


1. Legal stuff
--------------
 Copyright (C) 2003..2004 Michael & Karl-Heinz Zimmer.
 All rights reserved.

 The IndeView program, IndeViewExport StarBasic-MAKRO,
 and kpr2iv.sh shell script are distributed under the terms
 of the "GNU Lesser General Public License"
 (also known as: GNU-LGPL) revision 2.1, as of february 1999,
 as published by the Free Software Foundation and appearing
 in the file LICENSE included in the packaging of this file.

 This software is provided AS IS with NO WARRANTY OF ANY KIND,
 INCLUDING THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS
 FOR A PARTICULAR PURPOSE.

 See http://www.indeview.org for further information.

 Contact info@indeview.org if any conditions of this
 licensing are not clear to you.


2. Project description
----------------------
 We started the IndeView project aiming at creating a full-featured
 presentation viewer which can be run stand-alone from a CD containing
 both the viewer and the presentation data.

 To achieve this we created a statically linked version of the viewer
 which can easily be added to your CD (see next section to learn how
 to do that).

 The simple idea is to use bitmap files instead of Impress files: so
 we get best image quality at the target system - no matter how badly
 the fonts are mis-installed there and without the need of having
 OpenOffice/StarOffice installed at the target machine.

 Each slide is represented by several bitmap files: one file for
 each screen resolution supported.

 At presentation time you may press a 'z' (or a 'Z', resp.) to zoom
 into  your picture (or zoom out of it, resp.): zooming is done by
 loading a file of another resolution, so you have highest possible
 quality.
 This zoom feature is especially usefull in case your beamer is not
 adjusted propperly and you want to have a slightly smaller picture:
 just move it around on the screen using your keyboard's  arrow keys.

 Besides from zooming/panning you might want to use the [L] key to
 get a list of all of your slides: select the desired slide using the
 mouse or the [Up],[Down] keys of your keyboard and press [Enter]
 (or click the [OK] button, resp.) to jump to this slide.

 The presentation may be ended by pressing the [Q] key.

 For a help screen explaining all available keys just press the [F1]
 key during presentation.


3. Available documentation
--------------------------
 Besides from the sources, there is some documentation available
 that you should look at before using IndeView or IndeViewExport.bas
 or kpr2iv.sh:

 doc/html/index.html    - manual in English
 doc/html/index_es.html - manual in Espagnol
 doc/html/index_de.html - manual in German


4. Current limitations
----------------------
a) As of yet IndeView is not able to perform slide transition effects
   nor can it play sounds during slide transition or at slide stand
   time.  Planned features are listed in doc/html/state_de.html.

b) On Windows you have to click onto the first image to make the
   viewer obtain the keyboard focus: Note that this click will
   go to the next slide if you use the left mouse button, so you
   might want to use the right button instead to avoid this.
   Once the viewer has got the keyboard focus you may use the keyboard
   to switch between the images.
   In case you speak C++ you might want to consider helping us by
   figuring out this focus issue and dropping us a note how we could
   make the viewer instantly get the keyboard focus on windows,
   please send your mail to developers@indeview.org - thank you.  :-)


5. How to compile IndeView
--------------------------

   In case you want to compile IndeView yourself (e.g. to make it
   run on a not yet supported platform) please find the sources
   in directory Viewer/

   Note that IndeView is a Qt program, so without having the Qt
   library (and its header files) installed there is no chance to
   compile IndeView.

   Before starting *please* read file Viewer/READ_BEFORE_HACKING.

   Good luck - and tell us about your results if you like.


6. Your feedback
----------------
 Please consider sending
 a little picture postcard to   Michael & Karl-Heinz Zimmer
                                Butzengasse 15
                                54343 Föhren
                                Germany

 Your feedback will be very much appreciated:
 we will be glad about receiving a visual representation
 of where on earth you are living using our IndeView.
