Short: Datatype picture viewer for directory tools Uploader: thomas-rapp@web.de (Thomas Rapp) Author: thomas-rapp@web.de (Thomas Rapp) Type: gfx/show Version: 1.4 New since Version 1.3: ====================== - Bug fixed: PicShow crashed when loading next picture after screen close. - New function: invert background color. - Arexx commands PUBSCREEN, BACKGROUND and INVERTBG take effect at once. Introduction ============ This program is meant to be configured as picture viewer in directory tools like DirOpus or DosControl. It shows the doubleclicked picture in a borderless window on the specified custom screen. The remarkable about this program is that it reads the whole directory the picture is in and you can then choose other pictures out of this directory from a menu or by pressing the cursor keys. Installation ============ Copy the PicShow executable somewhere where your directory tool can find it. A good place is the C directory. Configuration ============= Call PicShow as a Shell program with the following parameters: FILE The picture to show first. You can specify a directory here. In this case the directory is read first and then the topmost picture is shown. PUBSCREEN/K The pubscreen where to open the window. Default is the default pubscreen (usually Workbench). P=PATTERN/K Only picture files that match this name pattern are shown in the list. FLASH/S Flashes the screen (displays beep) after the directory read is complete. DONTCHECK/S Files are not checked if they are pictures before they are inserted into the list. This does speed up the directory read a lot, but files that are no pictures are shown in the list, too. You should use the PATTERN parameter to avoid this. DELAY/N/K Enable slide show: every n/10 seconds the next picture is shown (DELAY=20 means every 2 seconds a new picture). SCREEN/S Open a new screen for PicShow BG=BACKGROUND/K Background color for the new screen. Format is six hexadecimal numbers: rrggbb rr = amount or read color (00 - ff) gg = amount of green color (00 - ff) bb = amount of blue color (00 - ff) Default is 000000 (black). PORT /K Name of the Arexx port. Default is PICSHOW. If PicShow is started from the Workbench all of the above can be entered as tooltypes, either in the program icon or in the picture icon that is activated first. Tooltypes in the picture icon overide those in the program icon. Picture icons can be activated by shift-click or by specifying PicShow as default tool. Usage ===== When the window showing a picture is open you can do this: o Quit PicShow - double click into the window or - press the ESC key or - press Q o Show the next picture - press the cursor down key or - press the cursor right key or - press the cursor down or right keys on the numeric keypad or - press space bar or - press return o Show the previous picture - press the cursor up key or - press the cursor left key or - press the cursor up or left keys on the numeric keypad or - press backspace (the <- key above return) o Show some infos about the current picture - keep the mouse pointer inside the window and don't move it for some time o If the picture is too large to fit into the screen - grab the picture with the left mouse button and move it around. o Choose a picture from the list - press the right mouse button and hold it down. The list can scroll up and down if there are more files than fit into one page. Just move the mouse pointer over the arrow(s). o Read a new directory - Press F1 o Swap display from Workbench to PicShow's own screen and back - Press F10 o Invert the background color of PicShow's own screen (e.g. from black to white and vice versa) - Press F9 Arexx port ========== The following commands can be sent to the Arexx port: QUIT Exit PicShow. NEXT Show next picture. PREV Show previous picture. MENU Open the picture list. SCREEN Toggle screen / Workbench. SCREEN Open or close the screen as desired. PUBSCREEN Set the pubscreen name to a new value. FILE Show the named picture and read the new directory. REQ Open the file requester. FLASH Enable/Disable beep as desired. DONTCHECK Enable/Disable file checking as desired. DELAY Set the delay time to a new value. 0 = OFF. BACKGROUND Set the background color to a new value. PATTERN Choose a new file name pattern. Must be set before FILE or REQ. INVERTBG Invert background color of PicShow screen. Future Ideas ============ - configurable key bindings - scale pictures to fit into the screen - configurable screen mode and depth - palette requester for the background color - save configuration