

 I n d e V i e w  -  Independend Presentation Viewer



            p r e s e n t a t i o n s

                   b e y o n d

              l i m i t a t i o n s




Content
-------
  A) How to build IndeView
  B) How to use IndeView as part of your own program
  C) How to contact the developers



A) How to build IndeView
------------------------

   0. IndeView is a QT program, see http://www.trolltech.com

   1. Start  qmake

   2. Start  make  (for Linux)
         or  nmake (for Windows)

   3. Find the IndeView binary in the bin/ directory

   4. If you find an error, we would be glad to receive your
      patch so we can include the bugfix into the IndeView
      distribution, please mail to: developers@indeview.org



B) How to use IndeView as part of your own program
--------------------------------------------------

  1. In the core/ directory you find these files:

            indeview_enums.h
            indeview_slide.h
            indeview_slide.cpp
            indeview_slides.h
            indeview_slides.cpp
            indeview_widget.h
            indeview_widget.cpp

     That's all you need to get an IndeViewWidget
     into your own application: this widget
     will allow you to view your presentation
     in an embedded window - without starting the
     IndeView viewer application.

  2. Import the files into your project.

  3. Get your IndeViewWidget, e.g. like this:

        #include "core/indeview_widget.h"

        IndeViewWidget* getIVW( const QString& runFile,
                                QWidget *parent )
        {
          IndeViewSlides* theSlides =
            new IndeViewSlides( runFile );
          if( theSlides->structureOK() )
            return new IndeViewWidget( theSlides,
                                       true,
                                       parent,
                                       "my_IVW" );
          delete theSlides;
          return 0;
        }

     Add this widget to your layout and make use of the
     slot methods and const-functions declared in file
     indeview_widget.h.

     NOTE: Your IndeViewWidget will take care for
           deleting the slides due to the parameter
           "true" used in the code shown above.

     If you want to change the slide set for your
     existing IndeViewWidget the following method
     might be of use:

        bool changePresentation( IndeViewWidget& widget,
                                 const QString& runFile )
        {
          IndeViewSlides* theNewSlides =
            new IndeViewSlides( runFile );
          const bool bOK = theNewSlides->structureOK();
          if( bOK )
            widget.setSlides( theNewSlides, true );
          else
            delete theNewSlides;
          return bOK;
        }

     HINT: In case you want to implement a slide picker
           these IndeViewWidget methods might be of use.

           -->  QStringList slideNames()
           -->  int curSlideIdx()
           -->  void gotoPage( int slideIdx )


     Happy coding!
     Feel free to tell us about your success...



C) How to contact the developers
--------------------------------

   Please send any bug reports (preferably together with
   your bug fixing patch ;-)) to us.


              mailto:developers@indeview.org


   Also note:


                   If you like IndeView
     please consider sending a little picture postcard
              of your town / your village to

                Michael & Karl-Heinz Zimmer
                      Butzengasse 15
                      54343 Foehren
                         Germany

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