CyberPiPView 1.1
         © 1998 by Stephan Rupprecht
              All rights reserved.
    

COPYRIGHT AND DISCLAIMER
 CyberPiPView is copyrighted 1998 by Stephan Rupprecht. 
 All rights reserved. This program is freeware, so no financial  
 donations required. Redistribution allowed if the package is 
 left unchanged. The author is not responsible for any damage 
 caused by the use or misuse of this documentation and/or the
 program(s) it describes.


REQUIREMENTS (PLEASE READ THIS;)
 - cybergraphics v3 (, pictdt43)
 - cv64/3d gfx-board


DESCRIPTION
 CyberPiPView is another picture viewer with usage of the
 datatypes. This program can do something special similar
 programs can't do, it uses the videolayer feature of a
 cv64/3d (no other Amiga gfx-board has this feature) to
 display pictures in 16bit no matter which resolution the
 current screen has (<=8bit, 15/16/24bit). This means that
 any picture can be shown in up to 65536 colors even if the 
 current screen just has 8 colors. The gfx processors 
 automatically scales the picture to fit on the screen. 
 When the window gets resized, the picture will be scaled, too.


USAGE
 From shell 
 ----------
 FILES/M:	filename(s) or AmigaDOS pattern(s) of the image(s)
                which shall be shown.             
 REQUESTER/S:	pop-up filerequester even when CyberPiPView was started
		with filenames given.
 PUBSCREEN/K:	name of pubscreen to show the pix on (must be a cgfx one).
 COLORKEY/S:	Normally the video layer is the front most part of the screen,
		so if you move a window in front of the layer, the window
		remains in the background. When using the COLORKEY option
		windows can cover the video layer (see also known problems
		section).


 From WB
 ----------
 CyberPiPView can be started ...
 1. As default tool
 2. By multi selection (click on the program icon, then select the
    files to view [hold the shift key down while doing this] and
    finally do a double click to start CyberPiPView).
 3. By a double-click, a requester will pop up then.

 The tooltypes REQUESTER, PUBSCREEN and COLORKEY are available from wb, too.


KNOWN PROBLEMS
 - Sometimes crashes your machine :( according to F.Mariak
 this could be a hardware problem of the virge S3 chip. Actually,
 Frank doesn't have much documentation on it, so if someone has
 a good documentation on it ...
 - Scaling doesn't always work perfect, sometimes you get trash at
 a certain size (hardware bug?).
 - b/w stripes at the bottom (hardware bug?).
 - When using hi-resolutions you may see flickering stripes, to avoid
   this turn-off (default) the COLORKEY option. As a matter of fact
   deactivating COLORKEY doesn't always help 'cause the gfx processor
   is too slow then.
 - Please note that you can't grab the contents of a video layer!
 - Not a bug: Please set the MULTIMEDIAMEM tooltype to YES (cvision3d
   driver)! Otherwise you'll get an "out of memory" error.


HISTORY
 1.0	first public release
 1.1	now checks if a cv64/3d is installed (R. Reiswig),
	didn't close libs when ReadArgs() failed,
	window border no longer covers parts of the pictures,
	added COLORKEY option (see known problems section).


SPECIAL THANKS GO TO
 Frank Mariak for his help and reworking the cgfx autodocs and 
 includes ;)
 R. Reiswig for his suggestion.


AUTHOR

Please send bug reports and ideas to:

 Stephan Rupprecht
 Apfeldweg 1
 D44359 Dortmund
 Germany

 Send emails to

 stephan.rupprecht@metronet.de