ShowIFF - a comfortable IFF picture viewer for CLI and Workbench ---------------------------------------------------------------- Version 2.24, 14-Jan-91 This program and iff.library by: Christian A. Weber, Bruggerweg 2, CH-8037 Zürich, SWITZERLAND Any suggestions or bug reports are welcome, e-mail to: UUCP: {uunet|pyramid|rutgers}!cbmvax!cbmehq!cbmswi!mighty!chris INTERNET: cbmehq!cbmswi!mighty!chris@cbmvax.commodore.com BIX: chw THIS PROGRAM IS IN THE PUBLIC DOMAIN. IT MAY BE FREELY DISTRUBUTED, COPIED AND USED FOR COMMERCIAL OR NON-COMMERCIAL PURPOSES. YOU ARE ALLOWED TO MAKE CHANGES TO THE SHOWIFF.* FILES AS LONG AS YOU CLEARLY MARK THE CHANGES. DISCLAIMER THIS SOFTWARE IS PROVIDED "AS IS". NO REPRESENTATIONS OR WARRANTIES ARE MADE WITH RESPECT TO THE ACCURACY, RELIABILITY, PERFORMANCE, CURRENTNESS, OR OPERATION OF THIS SOFTWARE, AND ALL USE IS AT YOUR OWN RISK. YOU ALREADY KNEW THAT, DIDN'T YOU. THE AUTHOR ASSUMES NO RESPONSIBILITY OR LIABILITY WHATSOEVER WITH RESPECT TO YOUR USE OR INABILITY TO USE OF THIS SOFTWARE. *** FEATURES -------- - All known formats of IFF pictures (including Overscan, HAM, Halfbrite, S-HAM) are supported. If a picture is larger than the screen, you may use the mouse to scroll around (If you have enough CHIP memory...) - Runs from both Workbench and CLI, creates an AppIcon under Kickstart 2.x - Uses double-buffering for best results if enough CHIP RAM is available - Can be used for demonstrations and slide-shows, see below - Powerful command option, for copying, deleting or archiving pictures REQUIREMENTS ------------ ShowIFF requires the arp.library and, of course, the iff.library. These two files should be located in the LIBS: directory. WORKBENCH USAGE --------------- Under Kickstart 1.3: Select all pictures you wish to view while pressing the SHIFT key, then double-click the ShowIFF icon. You can also set the picture's default tool to 'ShowIFF' using WorkBench's 'Info' feature. If you wish to display all the pictures in a drawer, select the drawer, and while depressing the SHIFT key, double-click the ShowIFF icon. This works even with disk icons! If a drawer or disk contains another drawer, the pictures in that drawer will also be displayed. Under Kickstart 2.x: Under Kickstart 2.x you have an additional possibility, which you may prefer once you are familiar with Kickstart 2.x: You can put ShowIFF in your WBStartup drawer. When you boot your Amiga, ShowIFF is automatically started and creates an "AppIcon". This icon looks like any other icon, and you can freely chose it's name and it's position (see below). But this icon has an interesting feature: You can view a picture by simply dragging the icon of that picture on ShowIFF's AppIcon. This works for drawers and disks too, of course. If you wish to remove the ShowIFF AppIcon, simply start ShowIFF again. Tool Types: ShowIFF understands several tool types. You can edit them using the "Show Information" or "Info" commands from the Workbench menu. Here's a list of the recognized tool types: ICONXPOS Specifies the x coordinate of ShowIFF's AppIcon. This works only under Kickstart 2.x and above. Example: ICONXPOS=620 ICONYPOS Specifies the y coordinate of ShowIFF's AppIcon. This works only under Kickstart 2.x and above. Example: ICONYPOS=120 ICONNAME Specifies the name of ShowIFF's AppIcon (Only Kickstart 2.x). Example: ICONNAME=IFF Viewer OPTIONS Here you can specify several options, in the same format as if you would enter them from CLI. Works under 1.3 too. Example: OPTIONS=ALL DELAY 5 NOOVERSCAN LOOP CLI USAGE --------- The template is: Patterns/...,ALL/s,L=LOOP/s,D=DELAY/k,NB=NOBREAK/s,NO=NOOVERSCAN/s,COMMAND/k ShowIFF [files or patterns] [ALL] [LOOP] [DELAY delay] [NOBREAK] [NOOVERSCAN] [COMMAND "Command %s args"] Example: ShowIFF Lo-Res/Pic* Hi-Res/foo RAM:#? ALL DELAY 7 files can be any number of file names, directories or disk names. All of the ARP wildcards can be used. (?,*,#?,...) ALL if this keyword is specified, pictures in sub-directories will also be displayed. LOOP if specified, repeatedly displays the pictures, which is useful for creating slide-shows or presentations. DELAY seconds specifies the delay between two pictures in seconds. If not specified, the delay is infinity. Note that you can always go to the next picture by pressing the left mouse button. NOBREAK disables the breaking features described below. Together with the LOOP keyword, a neverending and un-stoppable slideshow can be created. NOOVERSCAN display all pictures in the size of the Workbench screen, and never in overscan. This is useful if you want to see every pixel of a picture. NOOVERSCAN is automatically activated if the picture is too large to fit on an overscan screen. In this case you can use the mouse to scroll around. COMMAND cmd %s command to execute whenever the user presses the 'C' key while the picture is displayed. Examples: - You have a large collection of pictures and want to copy the best of them to to another disk. To do this, type ShowIFF * ALL COMMAND "Copy %s to DF1:" and hit the 'C' key on every picture you want to copy. - You want to delete the pictures you don't like. Type ShowIFF * COMMAND "Delete %s" ALL and hit 'C' on each picture you want to delete. The special parameter "%s" is automatically converted to the actual file name. KEYS AND MOUSE-BUTTONS ---------------------- While a picture is displayed, you can press the following keys: LEFT MOUSE BUTTON Display the next picture. If there are no more pictures to show, ShowIFF closes its window and terminates. If in AppIcon mode, ShowIFF closes its window and waits for new pictures. RIGHT MOUSE BUTTON Abort immediately Ctrl-C (if the ShowIFF window or the CLI window is active) Abort immediately Ctrl-E (if the ShowIFF window or the CLI window is active) If you started ShowIFF from Workbench, ore enabled the "ALL" option from CLI, pressing Ctrl-E will skip all pictures in the current sub-directory, and return to the parent-directory (like in the CLI "Dir" command). 'C' key If you specified a command using the COMMAND keyword, this command is executed. If no command was given, nothing happens. MOVE THE MOUSE If the actual picture is larger than the screen, the visible portion will scroll according to your mouse movement. Note: HAM pictures may have color distortions on the left side. This is a hardware limitation of the HAM mode, and not a bug in ShowIFF.