SciTech SNAP Graphics for Qt Embedded
                       SNAP R11, Qt/E 2.3.6

                       Getting Started Guide


What is this document for?
--------------------------

This text document is intended to be a brief overview to explain how 
to install and use the SciTech SNAP Graphics device drivers with
the Qt Embedded GUI toolkit under Linux. 


System Requirements
-------------------

The SciTech SNAP Graphics device drivers support most modern versions
of Linux with glibc 2.1 or later installed. In order to use the 
SciTech SNAP drivers with Qt Embedded, you will need the following:

 o A copy of Qt Embedded version 2.3.6. Earlier or later versions may
   work, but this patch has only been tested with 2.3.6. Note also
   that future versions of Qt Embedded will include this patch 
   (hopefully 2.3.8 and later).
  
 o A copy of SciTech SNAP Graphics for Linux version 2.0.0-29 or 
   later. The Qt Embedded support for SciTech SNAP Graphics will *not*
   work with versions of the SciTech SNAP Graphics drivers prior to  
   build 29 on Linux.

 o A copy of the SciTech SNAP Graphics SDK R11 release installed and 
   configured on your machine. The Qt Embedded support for SciTech 
   SNAP Graphics will *not* work with earlier versions of the SNAP
   Graphics SDK.

For more complete documentation on installing and using the SciTech
SNAP Graphics SDK, please refer to the online HTML documentation
pages found here:

 http://www.scitechsoft.com/docs/snap_ga

The latest versions of the SciTech SNAP Graphics SDK and device drivers
can be downloaded here:

 http://www.scitechsoft.com/products/product_download.html


Applying the Patch
------------------

To apply the patch to your copy of Qt Embedded 2.3.6, please follow the
steps below:

 1. Change into the root directory where you have Qt Embedded 2.3.6
    installed. Ie:

    cd ~/qt-2.3.6

 2. Apply the patch to the files in your installation using the 
    following command:

    gzip -d < qte-snap-2.3.6.diff.gz | patch -p0 -E

That's all there is to it! If you have a pristine copy of 2.3.6 you 
should have no errors and you are ready to re-configure and build 
your version of Qt Embedded 2.3.6.


Configuring Qt Embedded
-----------------------

Once you have successfully applied the patch to your copy of Qt Embedded
2.3.6, you will need to reconfigure and recompile the libraries to enable
the SciTech SNAP Graphics support. The only option you need to worry about
is to pass the '-accel-snap' option on the command line to configure:

 ./configure -accel-snap

Of course you can add whatever other configuration options you need such
as enabling debugging support, linking shared or static etc. When the
configure process has completed, simply recompile the libraries from 
scratch and you are set! You may want to first do a 'make clean' before
you reconfigure Qt Embedded and recompile.


Running Qt Embedded with SciTech SNAP
-------------------------------------

Once you have successfully rebuilt your copy of Qt Embedded 2.3.6, you can
try running the sample programs or your own programs using the new libraries
that contain the SciTech SNAP support. The biggest difference between
the SciTech SNAP drivers and the regular Qt Embedded drivers is that you do
not need your system to be in a framebuffer console mode. The SciTech SNAP
drivers will work either in a regular hardware text mode console or in a
graphical framebuffer console mode. 

One thing that you can control with the SNAP version is exactly what resolution
and color depth you wish to run your applications in. By default the SciTech
SNAP drivers for Qt Embedded will try to use 1024x768x16, then 800x600x16,
then 640x480x16 and finally 640x480x8, depending on what the underlying
graphics hardware is capable of. If you wish to manually specify the resolution
and color depth to use, you can control that with the QWS_SIZE environment
variable. For instance:

 export QWS_SIZE=1280x1024

will attempt to set the resolution to 1280x1024, but continute to use 16 bis
per pixel for the color depth. Using:

 export QWS_SIZE=960x720x32

will attemp to set the resolution to 960x720 with 32-bits per pixel as the
color depth (how make sure you have first configured 32 bit color depth 
support in Qt Embedded when you compiled it!). That is about it! Everything
else is completely automatic, including the detection of the underlying
graphics hardware and attached monitor. 


---- END OF README.TXT ----