ViewPNM 1.32 ============ What is ViewPNM? ~~~~~~~~~~~~~~~~ ViewPNM is an image viewer for PICASSO II gfxboards. It displays PPM (24 Bit), PGM (8 Bit Grey) and PBM (1 Bit) files produced by the picture converter/manipulator tools from the PBM, PBMPLUS and NETPBM libraries (Available on Aminet or sundry CD-Roms). Disclaimer ~~~~~~~~~~ The author cannot be held liable for the suitability or accuracy of this manual and/or the program(s) it describes. Any damage directly or indirectly caused by the use or misuse of this manual and/or the program it describes is the sole responsibility of the user her/him self. Copyright/Distribution ~~~~~~~~~~~~~~~~~~~~~~ ViewPNM, © Copyright 1994 Reinhard Haslbeck. All rights reserved. This program may be freely distributed as long as all documentation and executable(s) remain unchanged and are included with the distribution. Also no profit is to be made by selling this program. You may not charge more than Fred Fish does for a single library disk. Commercial distribution is NOT allowed without written permission from the author. It is allowed for non-commercial BBSs to distribute an archive with only the following files in it to save your users some money when they want to download this program. NOTE: All files listed below MUST be distributed together. None of the files listed below may be distributed on it's own! They may ofcourse be archived with any archiver. ViewPNM - Main Program ViewPNM.info - Icon ViewPNM.doc - Manual ViewPNM.doc.info - Icon IntuiView.prefs.add - add this to 'IntuiView.prefs' IntuiView.prefs.add.info - Icon PBMGUI.config.add - add this to 'PBMGUI.config' PBMGUI.config.info - Icon How to use ~~~~~~~~~~ ViewPNM can be started from Workbench or Shell. If You start it from a Shell the below listed arguments are allowed. Type 'ViewPNM ?' and all available arguments are shown: FILENAME/M,W=WAIT/K/N,M=MODEID/K/N,V=VERBOSE/S: FILENAME: Simply the name of the picture you want to see. If no Filename is entered, a Filerequester will appear. AmigaDos-style pattern-matching is also supported. WAIT: This is the optional duration time a picture will be displayed. Useful for slideshows. MODEID: If You don't want the ScreenModeRequester to appear, You have to set a vailid ScreenModeID for an Picasso 8/15/16/24 Bit Screen. The ID has to be for an 15-,16- or 24Bit Screen if the image is a PPM or a PGM file and for an 8 Bit Screen if the image is a PBM file. Look out for the utility 'VScreenID' which helps by getting the IDs If You choose an ID which nominal sizes are smaller than the picture, the Screen will be an AutoScrolling one if possible. If the pictures dimensions are too big to display, it will be cropped. If the pictures dimensions are smaller than the Screen, it will be displayed centered. VERBOSE: By default no messages are printed out, even errormessages are disabled. If You set VERBOSE, You will get some information about the image, Screen etc. If ViewPNM is started from Workbench, You can set values to the Tooltypes 'WAIT', 'MODEID' and 'VERBOSE', which have the same meaning as they have in Shellstart. Pressing a key or a mousebutton will close the Screen and ViewPNM fetches the next File (in Pattern Matching mode) or pops up the Filerequester again. Press the key or select 'Cancel' in the File/ScreenRequest to abort the program. Requirements ~~~~~~~~~~~~ - An Amiga Computer with a UNSEGMENTED driven PICASSO II pluged in - 'vilintuisup.library' V2.x+ - Amiga OS2.04+ Notes ~~~~~ - ViewPNM has not been tested on 1BM PICASSOs History ~~~~~~~ V1.0 -> V1.1: Now Handles PGM-files. V1.1 -> V1.2: Now Handles PBM-files, added MODEID-Option. V1.2 -> V1.21: fixed Bug by handling very large pics, program now exits if ScreenModeRequest is canceled. V1.21 -> V1.3: Speed improvement by reading the file in blocks of 8 imagelines. Added 8Bit displays for 24Bit images using a fixed palette. Doesn't force Screen dimensions to 4:3 aspect any- more. -Key now quits program. Support for Workbench ToolTypes. Sundry internal changes/enhancements. V1.3 -> V1.31: exit on + is disabled. V1.31-> V1.32: Thanks to Gerhard Muellers 'gerlib', ixemul.library isn't needed anymore. Opens info window when started by icon if tooltype 'VERBOSE' is set. Compiled without '-funroll-loops' for shorter code. Thanks to ~~~~~~~~~ Markus M. Wild for the GCC port Christian Stieber for some GCC hints Ingo Wilken for the NetPBM project Village Tronic Gerhard Mueller for 'Gerlib' author ~~~~~~ Address: Reinhard Haslbeck Spirknerstr. 7 84137 Vilsbiburg GERMANY Phone: +49/(0)8741 8676 , +49/(0)8741 91212 Fax: +49/(0)8741 7140 Internet: haslbeck@informatik.tu-muenchen.de