YAPCDGUI V 0.81 - Yet Another PhotoCD GUI ----------------------------------------- © 1996-97 by Dominik Argast Introduction: ~~~~~~~~~~~~~ YAPCDGUI is just another one of those little GUIs to make the use of the formidable program PhotoCDAGA by Günther Röhrich more comfortable. It is designed to work with PhotoCDAGA 1.2 and handles all its options, except those to convert the pictures from PCD to PPM format. You may ask why I went to the trouble to code yet another GUI for PhotoCDAGA, when there are plenty of them already. The reason is, that none of them suited my personal needs and all had some flaws. So just try out my own version of a GUI for PhotoCDAGA 1.2 and use it if you like it. Well, and if you don't - don't hesitate to throw it in the bin... Legal Stuff: ~~~~~~~~~~~~ This application uses MUI - MagicUserInterface (c) Copyright 1993/94 by Stefan Stuntz 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. 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. 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 YAPCDGUI itself is freeware, Copyright © 1996/97 by Dominik Argast, and may be freely distributed and included in all kind of PD series, e.g. the Aminet series, as long as no fee exceeding the media costs is charged. Not for commercial use. The program is provided 'as is' without warranty of any kind. Use at your own risk. Requirements: ~~~~~~~~~~~~~ YAPCDGUI needs at least AMIGA with AA Chipset MC 68020 or higher OS 3.x CD-ROM Drive MUI V 3.1 by Stefan Stuntz You also need the program PhotoCDAGA 1.2 by Günther Röhrich, which can be found on Aminet. Installation: ~~~~~~~~~~~~~ Just put YAPCDGUI anywhere you want and adjust the tooltypes or the preferences to your configuration. No assigns are required. Usage: ~~~~~~ Thanks to MUI there is virtually nothing to explain, for options of PhotoCDAGA refer to its documentation. In the upper part you can select all options of PhotoCDAGA 1.2, except those to convert the pictures from PCD to PPM format, which are not (yet) supported. The number of the picture to show can be chosen with the slider 'Image', the name of the mapfile (see PhotoCDAGA) is given in 'Basename'. 'Show' shows the selected picture with all options selected in the upper half. 'Show All' shows one picture after the other, starting with the actual number of the slider 'Image'. A window with the button 'Abort' appears in case you want to abort the operation. Although you won't see any reaction when you click on the button, the process will stop when the actual image has been displayed. (I know it's a bug but, but it isn't serious enough to go to the trouble to remove it :-) 'Overview' reads the overview file and displays 16 thumbnails, starting with the actual number of the slider 'Image'. 'Mute' toggles the output window of YAPCDGUI There are following menus: Project: 'About' tells you something about YAPCDGUI and how you can reach me. 'Read' counts the number of pictures of an inserted Photo CD and sets the maximal number of the slider 'Image' accordingly. If an error occurs, the last setting remains. 'Iconify' lets you iconify YAPCDGUI 'Quit' exits from YAPCDGUI Preferences: 'Preferences' opens a window where you can adjust YAPCDGUI to your configuration. If there exists a prefsfile (called s:YAPCDGUI.prefs) the tooltypes will be overridden. By the first call, YAPCDGUI tries to read the number of pictures of an inserted Photo CD. If something goes wrong, it sets the maximal number of pictures to 150. If you insert another Photo CD, get the number of pictures with 'Read'. The location of the program PhotoCDAGA 1.2, the name of your CD drive and several paths are listed in following tooltypes or in the preferences (in brackets follow the built-in presets): Program - The complete path AND name of PhotoCDAGA 1.2 (PhotoCDAGA) Drive - logical name of your CD ROM drive (CD0:) OvFile - Name of the overview file on your Photo CD (Overview.PCD) OvPath - Path of the overview file (Photo_CD/) ImgPath - Path of the images in PCD format (Photo_CD/Images/) ImgBase - Basename of an image (img) Quiet - No output window at start Usually you don't have to alter these presets, except the name of your CD ROM drive and the path of PhotoCDAGA 1.2. Most PhotoCDs store their pictures under the name 'imgXXXX.pcd'. But there are some exceptions where the pictures are called e.g. 'picXXXX.pcd'. You can choose the basename of the images with the tooltypes or in the preferences. Note that this name has nothing to do with the Basename stringgadget for the mapfile mentioned above. Note that YAPCDGUI has no CLI support! Although you can start it from CLI you won't be able to select any settings. :-( The Future of YAPCDGUI: ~~~~~~~~~~~~~~~~~~~~~~~ Following features would be nice and will (or will not) be realised in the next versions: - Command line support - Conversion from PCD to PPM format Suggestions are welcome! Known Bugs: ~~~~~~~~~~~ - the 'abort' window doesn't respond while a picture is shown (although the button is active) Address of the Author: ~~~~~~~~~~~~~~~~~~~~~~ If you want to get in contact with me for suggestions, bug reports, etc., write to Dominik Argast Lothringerstr. 139 CH-4056 Basel Switzerland email: argast@ubaclu.unibas.ch All communications are welcome! Greetings: ~~~~~~~~~~ Thanks to M. Berionne for his helpful suggestions. History: ~~~~~~~~ V 0.81 (26.01.1997) - Corrected a small bug in the iconify routine V 0.8 (19.12.1996) - Menus added, GUI redesigned (again), preferences added, some minor bugs removed, documentation updated - It is now possibe to choose the basename of an image V 0.6 (09.10.1996) - Output window added, GUI redesigned V 0.5 (23.09.1996) - First public release