@DATABASE PicView @MASTER PicView.guide @AUTHOR Holger Papajewski @AUTHOR Chris J. Cote (GuideFile) @WORDWRAP @SMARTWRAP @INDEX INDEX @$VER: PicView.Guide V2.5 @NODE "Main" "PicView V2.02" @{CODE}@{jcenter} @{b}PicView V2.02@{ub} PicView is Copyright ©1995-96 Holger Papajewski All rights reserved. @{"   Introduction   " link "Introduction"} @{"   Requirements   " link "Requirements"} @{"   Installation   " link "Installation"} @{"     Starting     " link "Starting"} @{"   Preferences  " link "Prefs"} @{"      Using      " link "Using"} @{" ARexx " link "ARexx"} @{" Copyright notice " link "Copyright"} @{" Registration " link "Register"} @{"      Author      " link "Author"} @{" Acknowledgments " link "Acknowledgments"} @{" History " link "History"} @{" INDEX " link "INDEX"} @{par}@{b}NOTE:@{ub} This guide was designed using the features of MultiView V.40+. If you're @{i}not@{ui} using OS3.1+, you may not get all of the Enhancements. @ENDNODE -------------------------------------------------------------------------- @NODE "Acknowledgments" "Acknowledgments" @{par}@{CODE} @{b}Acknowledgments@{ub} @{u}Thanks to:@{uu} Stefan Stuntz for the development of the @{"MUI" Link "MUI"} object library. Without it, PicView wouldn't exist. Raph Schmidt Barfly ASM development system. Eric Totel For MUIBilder, which was used to create PicView's GUI. Jochen Wiedmann For FlexCat. Jörg Stumpf Ideas and critiques. Nico Schmidt Assistance with programing some ASM routines. Volker Schmidt Martin Steigerwald Maik Solf Beta Testing. Anders Drejer Dansk translation. Jan-Tore Eliassen Norwegian translation. Phillippe Bovier French translation. Marco Musso Italian translation. Oleg Khimich Russian translation. And to all users, for their letters and invaluable advice... @ENDNODE -------------------------------------------------------------------------- @NODE "Introduction" "Introduction" @{par} @{b}Introduction@{ub} @{par} @{par}If you have a large collection of pictures scattered all over your Hard Drive, and they have cryptic names like "0003px.jpg", you should take a look at PicView. @{par} @{par}With PicView, you can easily create a catalog of all your pictures. PicView will load pictures of any format (provided you have the corresponding DataType) and render small images (ThumbNails) from them. These ThumbNails are displayed in a list and from there you can either show the pictures, set up a SlideShow with ARexx or get some info on them, such as the path, name, or resolution. @{par} @{par}Furthermore, you can delete, move or rename pictures using PicView. PicView is also a powerful catalog tool for all your images. You can classify pictures into a maximum of 255 different groups. And pictures can belong to a max of 4 groups. @{par} @{par}More on "Groups" later. @ENDNODE -------------------------------------------------------------------------- @NODE "Requirements" "Requirements" @{par} @{b}Requirements@{ub} @{par} @{par}PicView requires WorkBench V3.0 because it loads all pictures using the datatypes.library. In addition it requires MUI V3.3+ from Stefan Stuntz to layout the user interface. @{par} @{par}Of course you should also have some memory and hard disk space for PicView. @{par} @{par}And last but not least, you need an @{b}AMIGA@{ub}. @ENDNODE -------------------------------------------------------------------------- @NODE "Starting" "Starting" @{par} @{b}Starting@{ub} @{par} @{par}From WorkBench, you can launch PicView by double-clicking on its icon. Starting PicView from the shell is also possible. You will have to enter in a catalog name. @ENDNODE -------------------------------------------------------------------------- @NODE "Using" "Using" @{par} @{b}Using@{ub} @{par} @{par}First things first. Select a picture with either the "ADD" gadget or add an entire directory "Add Dir" in the pull-down menus. A progress indicator will inform you of the number of image(s) selected, elapsed time and remaining time. Then you can select a ThumbNail and either view the image by double-clicking on it, or just getting some info on it by highlighting it. @{par} @{par}You can also "Multi-Select" ThumbNails by using the dragbox or the shift key. @{par} @{par} @{b}The PicView menu@{ub} @{par}@{CODE} @{b}Project Picture List ARexx@{ub} @{"About... " Link "About" } @{"Add " Link "Add" } @{"Select All " Link "ListSelAll" } @{"Start Script " Link "ExeARexx" } @{"About MUI... " Link "AbMUI" } @{"Add Dir " Link "AddDir"} @{"Select... " Link "ListSelect" } @{"­­­­­­­­­­­­­­­­" Link "" } @{"­­­­­­­­­­­­­­­­­" Link "" } @{"Remove " Link "Delete"} @{"­­­­­­­­­­­­­­" Link "" } @{"New " Link "New" } @{"­­­­­­­­­­­­­­­­­­­­­­" Link "" } @{"Show All " Link "ListShowAll"} @{"Open " Link "Load" } @{"Edit " Link "Edit" } @{"Show... " Link "ListShow" } @{"Save " Link "Save" } @{"­­­­­­­­­­­­­­­­­­­­­­" Link "" } @{"­­­­­­­­­­­­­­" Link "" } @{"Save Select " Link "SaveSel"} @{"Show " Link "Show" } @{"Sort " Link "ListSort" } @{"Save as IFF " Link "SaveIFF"} @{"Info " Link "Info" } @{"­­­­­­­­­­­­­­­­­" Link "" } @{"Prefs " Link "Prefs" } @{"Prefs MUI " Link "MUIPref"} @{"­­­­­­­­­­­­­­­­­" Link "" } @{"Quit " Link "Quit" } @ENDNODE -------------------------------------------------------------------------- @NODE "About" "About..." @{par} @{b}About...@{ub} @{par} @{par}Version information, author's address, and copyrights. Also displays user information (Registered users only). @ENDNODE -------------------------------------------------------------------------- @NODE "AbMUI" "About MUI..." @{par} @{b}About MUI...@{ub} @{par} @{par}The MUI logo will appear and version information will be displayed on MUI. You can also Register or Update MUI from here. @ENDNODE -------------------------------------------------------------------------- @NODE "New" "New" @{par} @{b}New@{ub} @{par} @{par}The current catalog will be cleared after a confirmation request. Now you can create another catalog. @ENDNODE -------------------------------------------------------------------------- @NODE "Load" "Open" @{par} @{b}Open@{ub} @{par} @{par}Open a new Catalog (whatever.pv) into PicView from the file requester. @{par} @{par}PicView will load all the ThumbNails and settings ie. size and color mode etc. Any group settings will also loaded from this file. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "Save" "Save" @{par} @{b}Save@{ub} @{par} @{par}Use the file requester to select a directory and file name under which you wish to save the catalog. Usually with a .pv extension. @{par} @{par}The ThumbNail size, color mode and any group information will been also saved. @{par} @{par}The loading and saving can be interrupted by pressing the 'Abort' button. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "SaveSel" "Save Select" @{par} @{b}Save Select@{ub} @{par} @{par}This function works the same as the @{"Save" Link "Save"} function, but only the selected pictures will be saved into the file. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "SaveIFF" "Save as IFF" @{par} @{b}Save as IFF@{ub} @{par} @{par}You can save all the ThumbNails as picture(s). In other words, you can save off all the ThumbNails in a catalog as an IFF picture. What you get is an INDEX of all the ThumbNails. Useful for BBS's or anyone with a serious pile of pictures... @{par} @{par}The window that appears will allow you to enter a file name, (ie. Party00.idx) and the screen mode and size of the picture. You can enable or disable the printing of the picture names below the ThumbNails. @{par} @{par}If the catalog is bigger than ie. 640X400 HiresLace, than more picture files will be created and the names will be appended. (So, if you started with Party00.idx, the next file will be called Party01.idx and so on...) @{par} @{par}The options in this requester are also saved with the preferences. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "Quit" "Quit" @{par} @{b}Quit@{ub} @{par} @{par}Quit PicView. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "Add" "Add" @{par} @{b}Add@{ub} @{par} @{par}Select pictures from file requester to place into the catalog. @{par} @{par}You can also use AmigaDOS patterns. If you use a pattern, you will be asked if you only want to search the current directory or if you want to search all subdirectories also. @{par} @{par}If you scan a directory twice, PicView will only include pictures which are not currently in the catalog. PicView uses the name, directory and date to identify a picture. If there is a picture with the same name and path as one already in the catalog, PicView uses the date to determine what to do. The picture will be updated if the date is more recent or ignored if the date is the same. @{par} @{par}You can abort PicView at any time by pressing the almighty 'Abort' button. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "AddDir" "Add Dir" @{par} @{b}Add Dir@{ub} @{par} @{par}Choose the directory, which is searched for any pictures. All pictures that are found (recognized) will be added to the current catalog. You can also scan all subdirectories. @{par} @{par}Use the 'Abort' button to stop scan. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "Delete" "Remove" @{par} @{b}Remove@{ub} @{par} @{par}After a security request, you can either delete the pictures from the hard disk, by pressing the 'Catalog & Disk' button or simply remove the current selected ThumbNail(s) from the catalog. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "Edit" "Edit" @{par} @{b}Edit@{ub} @{par} @{par}This gadget brings up a sub-requester with the following functions: @{par} @{par} @{u}Rename@{uu} @{par} @{par}Enter a new name for a certain picture. Here, you can choose to rename the file in the current catalog or, on the hard drive. (Or wherever the image is stored...) @{par} @{par}You can multi-select for this fuction as well, and you will be asked to rename each file. @{par} @{par} @{u}Comment@{uu} @{par} @{par}Add a comment to the selected pictures in the database or in the database and hard disk. @{par} @{par} @{u}Groups@{uu} @{par} @{par}A window will be opened with a list of all groups. Now you can choose a maximum of 4 groups to which the picture should belong. @{par} @{par} @{u}Move@{uu} @{par} @{par}A requester will prompt you for the new path of the image. Once selected, you will be asked if you want to move the picture's path from the hard drive or simply for the catalogs sake. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "Show" "Show" @{par} @{b}Show@{ub} @{par} @{par}All selected pictures will be displayed. You can switch to the next one by pressing the left mouse button or any key. The "slideshow" can be stoped by pressing the right mouse button or the ESC key. @{par} @{par}The choosen picture viewer from the @{"preferences" Link "Prefs"} will be used. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "Info" "Info" @{par} @{b}Information@{ub} @{par} @{par}The 'Information' window will be opened. Here you can see data for any ThumbNail you select. @{par} @{par}The following information will be displayed: @{par}@{CODE} Path : The path where the picture is located Name : The file name of the picture Comment : The comment for that picture Format : The file format Resolution : Width X height X depth for that picture Screen Mode : The screen mode for display ModeID : The moodeID from screen mode Size : The file size Date : The date from file Time : The time from file Group : All groups to which the picture belongs @{body}The window can be closed by pressing the 'Close' button. @ENDNODE -------------------------------------------------------------------------- @NODE "ListSelAll" "Select All" @{par} @{b}Select All@{ub} @{par} @{par}All pictures in the current catalog will be selected. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "ListSelect" "Select..." @{par} @{b}Select...@{ub} @{par} @{par}A window will be opened to enter a pattern string for selection. @{par} @{par}All entries will be AND-associated. This means, that all entries have to match when selecting a certain picture. @{par} @{par}If there is no input to an entry it will be ignored. @{par} @{par}Input is not case-sensitive ('Amiga' = 'AMIGA'). @{par} @{par} @{u}Path@{uu} @{par} @{par}Give the path of the picture. You can enter a complete path or a AmigaDOS @{par}pattern. @{par} @{par}Example: Pic:Holiday/1995/ - All pictures that are located in this directory @{par} will be selected. @{par} #?Winter#? - All files located in any path called 'Winter' @{par} or 'Winter95' or 'last_winter' etc. will be @{par} selected. @{par} @{u}Name@{uu} @{par} @{par}Give the complete picture name or a pattern. @{par} @{par}Example: At_Sea.iff - For all pictures named 'At_Sea.iff' @{par} Party#?.iff - For all pictures whose names begin with the @{par} word 'Party'. @{par} @{u}Comment@{uu} @{par} @{par}Allows you to select a file(s) based on their comments. AmigaDOS WildCars @{par}supported. @{par} @{par}Example: Holiday 95 - For all pictures with this comment. @{par} Holiday#? - For all pictures with comments that include @{par} 'Holiday'. @{par} @{u}Format@{uu} @{par} @{par}Give the file format to whichever group the picture should belong to. @{par} @{par} @{u}Group@{uu} @{par} @{par}Select the groups to classify a picture. If you select more than one group, all will be OR-associated. That means, that only pictures that belong to a specific group will be selected. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "ListShowAll" "Show All" @{par} @{b}Show All@{ub} @{par} @{par}All pictures will be displayed into the list again. @{par} @{par}Read also @{"Show..." Link "ListShow"} @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "ListShow" "Show..." @{par} @{b}Show...@{ub} @{par} @{par}A requester will be opened asking you to specify a Path/Name/Comment or Format for file selection. Any pictures that don't match this given pattern will be hidden. @{par} @{par}The Format entries match any you have already loaded from the @{"Select..." Link "ListSelect"} function. @{par} @{par}To display all pictures again use the @{"Show All" Link "ListShowAll"} function. @ENDNODE -------------------------------------------------------------------------- @NODE "ListSort" "Sort" @{par}@{CODE} @{b}Sort@{ub} A window will be opened to enter the sortimg order for filenames. Example: Order in List Sort -------------------------------------------------------------------- Path Sorts based on Path @{b}THEN@{ub} the name etc... Name Sorts entries based on Name. Date Sorts based on Date. Newest/Oldest Comment Sorts based on Comment entries. Group Sorts by Group entries. Size Sorts by Size. Format Sorts by Format. ModeID Care to guess..? @ENDNODE -------------------------------------------------------------------------- @NODE "ExeARexx" "Start Script" @{par} @{b}Start Script@{ub} @{par} @{par}Chooses an ARexx script from file request and executes it. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "Copyright" "Copyright" @{par} @{b}Copyright@{ub} @{par} @{par}This software is subject to the "Standart Amiga FD-Software Copyright Note". It is @{"SHAREWARE as defined in paragraph 4s" Link "AFD-COPYRIGHT/Main" 0}. @{par} @{par}To use PicView without restrictions, you have to @{"register" Link "Register"}. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "Register" "Registration" @{par} @{b}Registration@{ub} @{par} @{par}With the unregistered version of PicView, you can't save or load the preferences. To do this you will need a key file. @{par} @{par}If you want to register PicView, please send the completed @{"order form" SYSTEM "ed OrderForm" 0} and either DM 30,- or US$ 20,- to the following address: @{par} @{par} Holger Papajewski @{par} Johann-Mühlpfort-Str.2d @{par} 39288 Burg @{par} GERMANY @{par} @{par}After this you will get the latest version of PicView and a key file registered to your name. With this key file you can use PicView without any restrictions. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "Author" "Author" @{par} @{b}The Author@{ub} @{par} @{par}PicView was written by Holger Papajewski. @{par} @{par}If you have any questions, remarks, suggestions or bug reports please let me know. You can contact me at the following addresses: @{par}@{CODE} InterNet: papa@ami.boerde.de Snail Mail: Holger Papajewski Johann-Mühlpfort-Str.2d 39288 Burg GERMANY Home Page: http://www.home.pages.de/~papa/ @{par} @{b}The Guide@{ub} @{par}The Guide was re-written by Chris @{bpen 7}J@{bp1en 0}e@{b}@{apen 3}S@{apen 9}@{ub}t@{bpen 11}@{apen 15}E@{bpen 0}@{apen 11}r@{ub}@{apen 1} Cote. If you have any comments about this Guide (Hey, ya never know...) I just @{i}LOVE@{ui} getting E-Mail... @{par}InterNet: w4gs@unb.ca @{par}Snail Mail: P.O. Box 1236 Stn. A Fredericton, NB. Canada E3B 5C8 @{par}(Yes, I really @{b}do@{ub} know Trevor Morris) @ENDNODE @NODE "Installation" "Installation" @{par} @{b}Installation@{ub} @{par} @{par}Please install PicView by using the supplied installation script for Commodore's installer program. You can choose the directory for the program and documentation. The locale files will also be installed. @ENDNODE -------------------------------------------------------------------------- @NODE "Prefs" "Preferences" @{par} @{b}Preferences@{ub} @{par} @{par}You can access the preferences window from the 'Project' menu. Here you can setup PicView however you like. @{par} @{par}When you save the options from preferneces, the options for 'Save as IFF' will be also saved. @{par} @{par}The preferences window is split up into 6 groups. @{par} @{par} @{" Misc " Link "PrefsMisc"} @{" Image " Link "PrefsImage"} @{" File " Link "PrefsFile"} @{" Viewer " Link "PrefsViewer"} @{" Groups " Link "PrefsGroups"} @{" ARexx " Link "PrefsARexx"} @ENDNODE -------------------------------------------------------------------------- @NODE "MUIPref" "MUI Prefs" @{par} @{b}MUI Preferences@{ub} @{par} @{par}This option will allow you to alter MUI's settings for PicView's GUI. @ENDNODE -------------------------------------------------------------------------- @NODE "PrefsMisc" "Prefs/Misc" @{par} Here, you can setup PicView's general options. @{par} @{par} @{b}Button Bar@{ub} @{par} @{par}Switch the button bar at the right on or off. @{par} @{par} @{b}Show Name@{ub} @{par} @{par}Enable or disable the displaying of the picture name below the ThumbNail. @{par} @{par} @{b}Security@{ub} @{par} @{par}Here you can enable some additional safety checks befor some actions are @{par}performed ie. Deleting or moving files from disk. @{par} @{par} @{b}Info Text Format@{ub} @{par} @{par}Here you can setup what sort of information you want to be displayed under the ThumbNail list. There are some defined presets... @{par} @{par} %P - Path @{par} %N - Name @{par} %C - Comment @{par} %F - File Format of the picture @{par} %w - Width @{par} %h - Height @{par} %d - Depth @{par} %s - File Size @{par} %W - Weekday @{par} %D - Date @{par} %T - Time @{par} %m - Screen Mode ID @{par} %M - Screen Mode Text @{par} @{par}You can insert some text between each preset. @{par} @{par}Example: %N Format: %F Resolution: %wX%hxX%d @{par} @{par}Output: Amiga.iff Format: ILBM Resolution: 640X512X8 @{par} Park.jpg Format: JFIF Resolution: 640X480X24 @{par} @{par}Presets can easily be entered into the rquester by clicking on the gadget next to the string requester. Double-click on any preset to enter it into the input line. @{par} @{par} @{b}Log File@{ub} @{par} @{par}While adding new pictures you can re-direct all error messages into a log file. All actions will be recorded into this file. This is very useful if you want to insert a large number of pictures, from a CD for instance. If a picture is too large and you run out of RAM, PicView will interrupt the process with a request. This request is disabled while using the log file option. The error will be recorded into the logfile, skip that image and @{i}try@{ui} to continue depending on the RAM situation. @{par} @{par} @{b}Log Name@{ub} @{par} @{par}Enter the path and name for the log file. Default is T:PicView.log @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "PrefsImage" "Prefs/Image" @{par}Here you setup the ThumbNails, the whole point to the this thing. @{par} @{b}Color@{ub} @{par}Switches between gray and color mode. @{par} @{b}Max Gray@{ub} @{par}Enter the number of colors to use for gray. This should ideally match your screen settings, ie. 16 colors. Default is 32. @{par} @{b}Width & Height@{ub} @{par}Give the dimensions of the ThumbNail(s) in pixels. Default is 60 by 80 pixels. @{par} @{b}Space@{ub} @{par}Give the space in pixels between each ThumbNails. Default is 4. @{par} @{b}Differ@{ub} @{par}Because PicView will maintain the aspect ratio of an image, PicView may have difficulty scaling certain images. Without a `Differ' option, you could occasionally get ThumbNails with small stripes through them. This option helps to correct the problem. The differ value tells PicView how many pixels can be added in all directions to make the ThumbNails fit into the given ThumbNail size. Default is 12. @{par} @{b}Dithering@{ub} @{par}Choose the algorithm for dithering the ThumbNails. Default is None. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "PrefsFile" "Prefs/File" @{par}Here, you can set up catalog file options. @{par} @{b}Default File@{ub} @{par} @{par}Sets which file should be loaded at program startup. Enter the directory and name of the file here. @{par} @{par} @{b}Use XPK@{ub} @{par}PicView can store the data into a XPK compressed file. Here, you can enable or disable this option. You can also choose method and efficiency for packing. @{par} @{par}This option is only available if you have the XPK library installed. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "PrefsViewer" "Prefs/Viewer" @{par}PicView can use any Viewer for selected images. @{par} @{par}Using the datatypes.library, PicView recognize every new picture format that is loaded. The best thing to do is to leave this at default `Internal', and PicView will automatically set up an entry in the list. Then, you can select each format, ie. JFIG, GIF, ILBM and select external viewers for each of these. Default is Internal Screen. @{par} @{par}To choose an external viewer, select the picture format in the list. Now choose the prefered viewer with the button below the list. @{par}@{CODE} These viewer modes are available: * Internal Screen: PicView will open its own screen to view the picture. * Internal Window: A window will be opened on the current PicView screen to display the picture. If the picture is bigger than the screen, it will be scaled. * External: If you prefer an external viewer better than the built in viewers, you can select another. Now you can enter the command line for it into the string gadget. Use "%s" where the filename should be substituted. Example: SYS:Utilities/Multiview "%s" SCREEN @{body}Use the "%s" in quotes, because there are problems with filenames that have spaces in the file name. @ENDNODE -------------------------------------------------------------------------- @NODE "PrefsGroups" "Prefs/Groups" @{par}With PicView you can categorise your pictures into 255 different groups. Every picture can belong to a maximum of 4 groups. Here, you can define or change the group's names. @{par} @{par}To create a new group, press the 'Add' button and enter the name into the input line. @{par} @{par}Selecting a group in the list and pressing the 'Remove' button will delete this group. @{par} @{par}If you want to rename a group, select it in the list and change the name in the input line. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "PrefsARexx" "Prefs/ARexx" @{par}PicView has an ARexx port. ADDRESS "PICVIEW.1" For scripts you use frequently, you can add them to the ARexx menu. These will be saved with you your Prefs. @{par} @{par}To add an Arexx script, press the 'Add' button and select the script in the file requester. @{par} @{par}To remove one, select it in the list and press the 'Remove' button. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "ARexx" "ARexx" @{CODE} @{b}ARexx Commant List@{ub} @{" ABOUT " Link "RexxAbout"} - Opens the about requester @{" ADDPIC " Link "RexxAddPic"} - Add new picture to the current catalog @{" COMMENTPIC " Link "RexxCommentPic"} - Comments a picture @{" GETENTRIES " Link "RexxGetEntries"} - Get number of catalog pictures @{" GETNEXTSELECT " Link "RexxGetNext"} - Get handle to next selected picture @{" GETPICDATA " Link "RexxGetPicData"} - Get some info on picture @{" MOVEPIC " Link "RexxMovePic"} - Moves a picture @{" NEWPROJECT " Link "RexxNewProject"} - Clears current catalog @{" OPENPROJECT " Link "RexxOpenProject"} - Opens a new catalog @{" REMOVEPIC " Link "RexxRemovePic"} - Removes a picture @{" RENAMEPIC " Link "RexxRenamePic"} - Renames a picture @{" SAVEPROJECT " Link "RexxSaveProject"} - Saves the current catalog @{" SAVEASIFF " Link "RexxSaveIFF"} - Saves the current catalog as IFF picture @{" SELECTLIST " Link "RexxSelectList"} - Selects some pictures @{" SHOWLIST " Link "RexxShowList"} - Shows only certain ThumbNails @{" SHOWPIC " Link "RexxShowPic"} - Shows a picture @{b}ARexx-Scripts@{ub} @{par}SlideShow.rexx - Shows all select pictures @{par}TestExists.rexx - Removes none existing pictures from current catalog @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "RexxCommentPic" "COMMENTPIC" @{par} @{b} Comments a picture@{ub} @{par} @{par} Command Options Function @{par} -------------------------------------------------------------------- @{par} COMMENTPIC HANDLE/A/N a number between 0 and GETENTRIES -1 @{par} COMMENT/A new comment for the picture @{par} DISK/S comment also on hard disk @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "RexxMovePic" "MOVEPIC" @{par} @{b} Moves a picture@{ub} @{par} @{par} Command Options Function @{par} -------------------------------------------------------------------- @{par} MOVEPIC HANDLE/A/N a number between 0 and GETENTRIES -1 @{par} PATH/A new path for the picture @{par} DISK/S move also on hard disk @{par} FORCE/S no security request @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "RexxRenamePic" "RENAMEPIC" @{par} @{b} Renames a picture@{ub} @{par} @{par} Command Options Function @{par} -------------------------------------------------------------------- @{par} RENAMEPIC HANDLE/A/N a number between 0 and GETENTRIES -1 @{par} NAME/A new name for the picture @{par} DISK/S rename also on hard disk @{par} FORCE/S no security request @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "RexxRemovePic" "REMOVEPIC" @{par} @{b} Removes a picture@{ub} @{par} @{par} Command Options Function @{par} -------------------------------------------------------------------- @{par} REMOVEPIC HANDLE/A/N a number between 0 and GETENTRIES -1 @{par} DISK/S remove also on hard disk @{par} FORCE/S no security request @ENDNODE -------------------------------------------------------------------------- @NODE "RexxShowPic" "SHOWPIC" @{par} @{b} Shows a picture@{ub} @{par} @{par} Command Options Function @{par} -------------------------------------------------------------------- @{par} SHOWPIC HANDLE/A/N a number between 0 and GETENTRIES -1 @{par} TIMEOUT/K/N time in seconds, which the picture should be @{par} displayed @ENDNODE -------------------------------------------------------------------------- @NODE "RexxGetNext" "GETNEXTSELECT" @{par} @{b} Get the handle of the next selected picture@{ub} @{par} @{par} Command Options Function @{par} ------------------------------------------------------------------------ @{par} GETNEXTSELECT returns the handle of the next selected picture @{par} if no next, a -1 will be returned @{par} START/S get handle of the first selected picture @{par} @{par} Function: /* show path and name of all selected pictures */ @{par} options results @{par} address PICVIEW.1 @{par} @{par} getnextselect start @{par} do while result ~= -1 @{par} getpicdata result FILE @{par} say result @{par} getnextselect @{par} end @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "RexxGetPicData" "GETPICDATA" @{CODE} @{b} Get info on a picture@{ub} @{par} Command Options Function ----------------------------------------------------------------------- GETPICDATA HANDLE/A/N a number between 0 and GETENTRIES -1 DATA/M a list with some key words separated by a blank * NAME - Name * PATH - Path * FILE - Path and Name * COMMENT - Comment * WEEKDAY - Creation weekday * DATE - Creation date * TIME - Creation time * WIDTH - Width * HEIGHT - Height * DEPTH - Depth * SIZE - File size * FORMAT - File format * MODEID - Screen mode id * MODETEXT - Display screen mode text from display database @{par}If there are more than one key words, the results will be separated by a blank. @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "RexxGetEntries" "GETENTRIES" @{par} @{b} Get number of catalog pictures@{ub} @{par} @{par} Command Options Function @{par} --------------------------------------------------------------------------- @{par} GETENTRIES (None) Get the total number of pictures in current catalog @{par} SELECTED/S Get only the number of selected pictures @ENDNODE -------------------------------------------------------------------------- @NODE "RexxAddPic" "ADDPIC" @{CODE} @{b} Add picture(s) to the current catalog@{ub} @{par} Command Options Function ------------------------------------------------------------------------- ADDPIC FILE/A Complete path and name of the picture to add, or a pattern ie. "Pic:Amiga.iff" "Pic:#?.iff" ALL/S If FILE is a pattern, all pictures match that pattern will be added If FILE is only a directory, all pictures will be added. Subdirectories will be also processed @ENDNODE -------------------------------------------------------------------------- @NODE "RexxAbout" "ABOUT" @{par} @{b} Opens the about window@{ub} @{par} @{par} Command Options Function @{par} ---------------------------------------------- @{par} ABOUT (None) Opens the about window @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "RexxNewProject" "NEWPROJECT" @{par} @{b} Clears the current catalog@{ub} @{par} @{par} Command Options Function @{par} -------------------------------------------------- @{par} NEWPROJECT (None) Clears the current catalog @{par} FORCE/S Without security request @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "RexxOpenProject" "OPENPROJECT" @{par} @{b} Loads a new catalog@{ub} @{par} @{par} Command Options Function @{par} ------------------------------------ @{par} OPENPROJECT FILE/A File to load @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "RexxSaveProject" "SAVEPROJECT" @{par} @{b} Saves the current catalog@{ub} @{par} @{par} Command Options Function @{par} --------------------------------------------------- @{par} SAVEPROJECT FILE/A File to save @{par} SELECTED/S Save only selected pictures @{par} @ENDNODE -------------------------------------------------------------------------- @NODE "RexxSelectList" "SELECTLIST" @{CODE} @{b} Select pictures from a catalog@{ub} Command Options Function ------------------------------------------------------------------- SELECTLIST NAME/K Complete name or pattern (example "#?.iff", "Amiga.iff") PATH/K Complete path or pattern (example "Pic:Clipart/#?", "Work:Pictures") COMMENT/K Complete comment or pattern FORMAT/K File format(s) of picture, separated by '|' (example "ILBM", "GIF|JFIF|ILBM") GROUP/K Groups to which the picture should belong, separated by '|' (PIPE symbol) (example "Clipart", "Scan|Clipart") ALL/S All pictures will be selected NONE/S All pictures will be deselected NONE will overwrite all other options. ALL will enable all options. @ENDNODE -------------------------------------------------------------------------- @NODE "RexxShowList" "SHOWLIST" @{CODE} @{b} Show only ThumbNails in a given pattern@{ub} @{par} Command Options Function ------------------------------------------------------------------- SHOWLIST NAME/K Complete name or pattern (example "#?.iff", "Amiga.iff") PATH/K Complete path or pattern (example "Pic:Clipart/#?", "Work:Pictures") COMMENT/K Complete comment or pattern FORMAT/K File format(s) of picture, separated by '|' (example "ILBM", "GIF|JFIF|ILBM") GROUP/K Groups to which the picture should belong, separated by '|' (example "Clipart", "Scan|Clipart") ALL/S All pictures will be selected ALL will enable all options. @ENDNODE -------------------------------------------------------------------------- @NODE "RexxSaveIFF" "SAVEASIFF" @{CODE} @{b} Save catalog as IFF picture@{ub} Command Options Function ------------------------------------------------------------------- SAVEASIFF FILE/A Path and name for picture(s) WIDTH/K/N Width for the generated picture HEIGHT/K/N Height for the generated picture MODEID/K/N Screen mode id for picture SHOWNAME/S Write picture names below the ThumbNails If WIDTH, HEIGHT or MODEID are not used, the values from the program settings will be used. @ENDNODE -------------------------------------------------------------------------- @index "Index" @NODE Index INDEX @{CODE} @{b}@{apen 2}@{bpen 3} A @{ub}@{apen 1}@{bpen 0} @{"About..." Link "About" } @{"About MUI..." Link "AbMUI"} @{"Acknowledgments" link "Acknowledgments"} @{"Add Dir" Link "AddDir"} @{"Add" Link "Add" } @{"ADDPIC" Link "RexxAddPic"} @{"ARexx" link "ARexx"} @{"Author" Link "Author"} @{b}@{apen 2}@{bpen 3} C @{ub}@{apen 1}@{bpen 0} @{"COMMENTPIC" Link "RexxCommentPic"} @{b}@{apen 2}@{bpen 3} E @{ub}@{apen 1}@{bpen 0} @{"Edit" Link "Edit" } @{b}@{apen 2}@{bpen 3} F @{ub}@{apen 1}@{bpen 0} @{"File" Link "PrefsFile"} @{b}@{apen 2}@{bpen 3} G @{ub}@{apen 1}@{bpen 0} @{"GETENTRIES" Link "RexxGetEntries"} @{"GETNEXTSELECT" Link "RexxGetNext"} @{"GETPICDATA" Link "RexxGetPicData"} @{"Groups" Link "PrefsGroups"} @{b}@{apen 2}@{bpen 3} H @{ub}@{apen 1}@{bpen 0} @{"History" link "History"} @{b}@{apen 2}@{bpen 3} I @{ub}@{apen 1}@{bpen 0} @{"Image" Link "PrefsImage"} @{"Info" Link "Info" } @{b}@{apen 2}@{bpen 3} M @{ub}@{apen 1}@{bpen 0} @{"Misc" Link "PrefsMisc"} @{"MOVEPIC" Link "RexxMovePic"} @{"MUI" Link "MUI"} @{b}@{apen 2}@{bpen 3} N @{ub}@{apen 1}@{bpen 0} @{"New" Link "New" } @{b}@{apen 2}@{bpen 3} O @{ub}@{apen 1}@{bpen 0} @{"Open" Link "Load" } @{b}@{apen 2}@{bpen 3} P @{ub}@{apen 1}@{bpen 0} @{"Preferences" Link "Prefs" } @{b}@{apen 2}@{bpen 3} Q @{ub}@{apen 1}@{bpen 0} @{"Quit" Link "Quit" } @{b}@{apen 2}@{bpen 3} R @{ub}@{apen 1}@{bpen 0} @{"Registration" link "Register"} @{"Remove" Link "Delete"} @{b}@{apen 2}@{bpen 3} S @{ub}@{apen 1}@{bpen 0} @{"Save as IFF" Link "SaveIFF"} @{"Save Select" Link "SaveSel"} @{"Save" Link "Save" } @{"Select All" Link "ListSelAll" } @{"Select..." Link "ListSelect"} @{"Show All" Link "ListShowAll"} @{"Show" Link "Show" } @{"Show..." Link "ListShow"} @{"SHOWLIST" Link "RexxShowList"} @{"SHOWPIC" Link "RexxShowPic"} @{"Sort" Link "ListSort" } @{"Start Script" Link "ExeARexx" } @{b}@{apen 2}@{bpen 3} V @{ub}@{apen 1}@{bpen 0} @{"Viewer" Link "PrefsViewer"} @ENDNODE -------------------------------------------------------------------------- @NODE "MUI" "MUI" @{CODE} @par @{jcenter}This application uses MUI - MagicUserInterface (c) Copyright 1993/94 by Stefan Stuntz @{jleft}@{body}MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. @{par} @{par}MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called "muiXXusr.lha" (XX means the latest version number) on your local bulletin boards or on public domain disks. @{par}@{CODE}@{jcenter} If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY @ENDNODE -------------------------------------------------------------------------- @NODE "History" "History" @{CODE} @{b}The History of PicView@{ub} V1.00 - First public version. V1.10 - Bug while opening the screen on ECS machines was removed. - Picture viewer was revised, should now work with all commodities. V1.20 - 16 color mode added - Makes PicView more useable on all Amigas with ECS ChipSets. V1.21 - Error while saving catalog picture(s) removed. V1.22 - Arguement 'CATALOG' added. - Error while building catalog picture(s) removed. (forgot to wait for blitter) V2.00 - 256 color mode added. - MultiSelect support added. - ARexx port added. - Now supports up to 255 groups. - New internal window viewer. - Separate viewer for every picture format. - XPK support added. - More information is now stored into each catalog. - Comment support for pictures added. - Sort and selection functions added. - Log file added. - Shows picture name below ThumbNail. - Free configurable information line added. - Size of ThumbNails configurable. - Dithering: Ordered, Floyd-Steinberg added. - Now any public screen can be used to run PicView. - Button bar can be switched off. - Remove, rename and comment direct-to-disk support added. V2.01 - Error in pens managment removed (after switching the color mode) - Speed up the rendering of the thumbnails on graphics cards. V2.02 - Color mode works now also with less than 256 color screens. - All graphics operations rewritten for use with CyberGfx & V43 PictDT. - Internal viewers uses now 16 & 24 bit with CyberGfx. - Crash when loading PicView catalogs without xpkmaster.library fixed. - New FILE option for information line added. - Thumbnail disselection added. - Thumbnail selection/disselection works now exactly as like the Workbench. - Bubble help added. - Guide file @{b}@{apen 2}@{bpen 3}VASTLY@{ub}@{apen 1}@{bpen 0} improved. :) - Some other little bug fixes and improvements. Some thinks for the future: - External thumbnail managment for saving memory. - Better Support of MUI 3.x. - Better Support of CyberGfx (16 and 24 bit Thumbnails). - Support of animations. - Creation and presentation of slideshows. @ENDNODE - Phew... :|