CyberPiPView
         © 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 CGFX
 - cybergraphics v3
 - cv64/3d gfx-board
REQUIREMENTS P96
 - p96 with *cgxvideo emulation*
 - piv (or cv64/3d if supported)


DESCRIPTION
 CyberPiPView is another picture viewer with usage of the
 datatypes. This program uses the videolayer feature of a 
 cv64/3d (you need p96 and a cgxvideo emulation to use
 CyberPiPView in conjuction with a PIV) 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).
 DELAY/N/K:	Turns slide show mode on, each picture is shown for DELAY 
		seconds.


 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, COLORKEY and DELAY are available 
 from wb, too.

 The window
 ----------
 You can resize a picture using the sizegadget. Clicking on the closegadget
 terminates CyberPiPView. Pressing the lmb starts displaying the next picture
 in the list (if there's one:).

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 ...
 - Downscaling isn't supported by the ViRGE chip, you might get trash
   at a certain picture size. 
 - stripes at the bottom / right border (hardware bug?).
 - When using hi-resolutions you may see flickering stripes, to avoid
   this turn-off (default) the COLORKEY option. Unfortunely deactivating 
   COLORKEY doesn't always help because of the high bandwidth which is
   required. Using CyberPiPView on screens >=15 bit doesn't make much
   sense at all, use CyberView by M.Scheler instead!
 - 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),
	added DELAY option. 
 1.2	removed some enforcer hits
 1.3	now works with p96 picture.dt (forgot to get a new
	bitmap pointer after remapping).
 1.4	now works with p96 cgxvideo emulation, filerequester
	remembers last path, changed handling of window

SPECIAL THANKS GO TO
 Frank Mariak for his help and reworking the cgfx autodocs and 
 includes ;)
 R. Reiswig for his suggestions.
 Emiliano Esposito for his bug report.

 and to all others who sent me mails ...


AUTHOR

Please send bug reports and ideas to:

 Stephan Rupprecht
 Apfeldweg 1
 D44359 Dortmund
 Germany

 Send emails to

 stephan.rupprecht@metronet.de