Copyright © 1999, 2000, 2001 Steeple Software
The authors are not responsible for any damage caused by the use or misuse of this documentation and/or the program(s) it describes.
This program and its related documentation, utilities and examples are provided "AS-IS" and subject to change without notice; no warranties are made. All use is at your own risk. No liability or responsibility is assumed.
Trademarked names herein are used for the purposes of identification and for the benefit of the trademark holder. No infringement of trademarks is intended. Trademarks remain the property of the trademark holder.
PhotoFolio and its related documentation, utilities, and examples (hereinafter "program", "programs" or "the program") are © Copyright 1999-2001 Steeple Software. All Rights Reserved.
1. Specific third party files from the PhotoFolio distribution may be reproduced and distributed separately under their own licensing arrangements subject to agreement with the third party authors.
2. The program may not be reproduced, modified or sub-licensed in any way.
3. The license to use this copy of the program is extended to the original purchaser only and is not transferable. Upgrades and technical support are available to the original purchaser only.
4. The program and related documentation, utilities, and examples provided by Steeple Software may not be reproduced or distributed, in whole or in part.
5. The licensee shall hold Steeple Software and its management and employees harmless from any and all claims, damages and liabilities resulting from or arising out of the programs use.
6. Steeple Software may terminate this license at any time, with or without cause. This license and the Licensee's rights herein will automatically terminate upon any breach of these terms and conditions. Upon any such termination, the licensee shall destroy all copies of the program and the related documentation, utilities, and examples in its possession.
7. You are not required to accept this License, since you have not signed it. Should you choose not to accept this License, you should return the program to the place of purchase.
1. Except when otherwise stated in writing the copyright holders and/or other parties provide the program "as is" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the program is with you.
2. In no event unless required by applicable law or agreed to in writing will Steeple Software and its management and employees be liable for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the program (including but not limited to the loss of data or data being rendered inaccurate or losses sustained by you or a failure of the program to operate with any other software or hardware), even if you have been advised of the possibility of such damages.
No guarantee of any kind is given that the program described in this document is 100% reliable. You are using this software at your own risk.
PhotoFolio is supposed to be used to view and catalogue images. Even though every effort has been made to make PhotoFolio as compatible as possible, Steeple Software cannot rule out the possibility that PhotoFolio might have bugs that have side effects (possibly harmful) on your system.
Steeple Software hereby rejects any liability or responsibility for these or any other consequences from the use of PhotoFolio whatsoever. This includes, but is not limited to, damage to your equipment, to your data, personal injuries, financial loss or any other kinds of side effects.
PhotoFolio is provided as-is. This means Steeple Software does not guarantee that PhotoFolio is fit for any specific purpose and Steeple Software does not guarantee any bug fixes, updates or help during error recovery.
PhotoFolio 2.2, Copyright &co; 1999, 2000, 2001 Steeple Software, distributed by Schatztruhe
http://mafeking.scouts.org.au/steeplesoftware/photofolio
PhotoFolio is designed for anyone wishing to view, store or catalogue images. It runs on any Commodore-Amiga (020 and above), Draco computer, or Amiga emulator running Kickstart 3.0 or higher.
· Configurable generation of proofs.
· Amiga User Interface Style Guide compliant user interface using MUI.
· Compatible with OS 3.5 and OS 3.9.
· Displaying of images, including scaled image loading and external viewer support.
· Cataloguing of images into owners (255), groups (4) and categories (22).
· Selective display of catalogued proofs, using 3 boolean operations.
· Copying, moving, renaming, deleting and saving of images and proofs.
· Optional gamma correction of proofs.
· Limited PhotoAlbum compatibility (JPEG thumbnails only).
· Any number of windows can be opened at once (limited by system resources).
· Online help.
· Datatype support.
· CyberGraphX support.
· Works with any native Amiga display mode.
· VLab image grabbing support.
· Drag and drop across windows.
· AmigaDOS pattern matching for proof selection.
· English, Spanish, Italian, German, French, Dutch and Czech translations available.
Throughout this document, the word proof is used. A proof is a scaled down representation of an image. Some applications call these thumbnails.
Online help via AmigaGuide is available at all times. Position the mouse over the area of the active window you want help with and press the Help key.
PhotoFolio uses proof.library to create proofs. These are then stored on disk for later use. On average a proof that is about 85 by 85 pixels in size takes up about 2-3k of disk space. This makes the program very efficient when it comes to both speed and storage.
Proofs can be stored in a mirrored directory structure in which case the proof maintains the same name as the original image (linked), or a proof can be stored along with the original image in which case the proof is given a name different to the image´s name (non-linked).
Throughout this document there are visual indicators to assist in locating important information:
This information is intended for experienced users. Inexperienced users can most likely disregard this information.
Important notes about a function of PhotoFolio are contained here.
All software required to run PhotoFolio is included in the PhotoFolio distribution. PhotoFolio requires at minimum the following to run. Newer versions of these libraries and modules may include additional features that are also supported by PhotoFolio.
· A 68020 based Amiga computer running Kickstart 3.0 (revision 39.106) and Workbench 3.0 (revision 29.29)
· MUI version 3.8 (included in archive) Available from http://wuarchive.wustl.edu/aminet/dirs/util_libs.html
· Listtree.mcc version 17.53 (included in archive)
· NList.mcc and NListview.mcc version 19.90 (included on CD-ROM) Available from http://wuarchive.wustl.edu/aminet/dirs/dev_mui.html
· jpeg.library version 6.2 (included in archive) Available from http://www.scouts.org.au/steeplesoftware/en/jpeg.html.
· proof.library version 2.9 (included in archive) Available from http://www.scouts.org.au/steeplesoftware/en/proof.html.
· imageio.library version 3.5 (included in archive) Available from http://www.scouts.org.au/steeplesoftware/en/imageio.html.
· imageprocess.library version 1.0 (included in archive) Available from http://www.scouts.org.au/steeplesoftware/en/imageprocess.html.
· guigfx.library version 16.2 (included in archive) Available from http://www.neoscientists.org/~bifat/binarydistillery/guigfxlib.shtml.
· render.library version 30.0 (included in archive) Available from http://www.neoscientists.org/~bifat/binarydistillery/renderlib.shtml.
To display extended information about images:
· exif.library version 1.0 (included in archive) Available from http://www.scouts.org.au/steeplesoftware/en/exif.html.
If you have a VLab card and want to grab images:
· VLab.mcc version 13.0 (included in archive) Available from http://www.scouts.org.au/steeplesoftware/en/vlab.html.
If you want to use internal viewer support for MysticView.library:
· mysticview.library version 4.2 (included in archive) Available from http://www.neoscientists.org/~bifat/binarydistillery/mysticlib.shtml.
To click on http and email links in the about window:
· openurl.library version 3.0 (included in archive) Available from http://wuarchive.wustl.edu/aminet/dirs/comm_www.html.
PhotoFolio automatically
detects if a CyberGraphX card is installed and uses the native CyberGraphX calls for optimum speed and less memory overhead. If a CyberGraphX card is not
found then PhotoFolio uses guigfx.library to render to the screen automatically.
PhotoFolio supports language catalog files as introduced with Workbench 2.1 locale.library. If you wish to create your own national translation you should consult the blank translation file PhotoFolio.ct that resides in the catalogs directory of the release archive.
If you have finished creating a translation table and want to share it with others, send it to us for everyone else to use.
Please report all bugs!
Bugs can be reported via the bug report form online at http://www.scouts.org.au/steeplesoftware/photofolio/en/support.html.
We are striving to make PhotoFolio the best program of its kind and we have tried to write a bug free program, but it's nearly (always?) impossible. Some (many?) bugs always make it through the testing.
If you come upon one of those undesirable features which even we and our testers were unable to track down and remove, follow these steps:
1. Read the documentation and make sure you are doing things correctly.
2. Check on the PhotoFolio mailing list to see if others are having similar problems or that there is a known problem.
3. Describe your problem as elaborately as possible, explaining every step taken to reproduce the problem.
4. State your system and program configuration. It helps to know on which machine there are problems. Include information such as memory size, Amiga model (A1200, A4000, etc.), graphics hardware (ECS, AGA, etc.), CPU type (MC68020, MC68040, PPC etc.).
5. Ensure no patch programs are running and causing problems.
6. Make sure you have all required libraries etc and that they are of the required minimum versions. You can use PFSysInfo included in the distribution to assist in this process.
For the latest patches, upgrades and information on PhotoFolio, check the PhotoFolio home page at http://mafeking.scouts.org.au/steeplesoftware.
To join the PhotoFolio users mailing list, point your browser at http://groups.yahoo.com/group/photofolio or send an email to photofolio@yahoogroups.com.
It is always satisfying to receive feedback from others (good or bad) and to receive requests for enhancements.
If you wish to contact Steeple Software directly, the authors´ addresses are listed below.
1280 Stevens St
Mundaring, Perth,
Western Australia 6073
Australia
Email: steve@quartly.net
Email: paulhuxham@yahoo.com
System 1 |
System 2 |
| Amiga 3000/040 |
Amiga 4000/060 |
| Kickstart 3.1, OS 3.5 |
Kickstart 3.1, OS 3.9 |
| 14 Meg RAM |
42 Meg RAM |
| 1 Gig Hard Disk |
9 Gig Hard disk |
| CyberVision 64/3D |
CyberVision 64/3D |
| SAS/C 6.55 |
SAS/C 6.58 |
Steve and Paul would like to extend special thanks to a great many people who have helped to bring PhotoFolio to release state. The list below is by no means complete or in any particular order and we hope you will forgive us if we forgot you.
I spend many long hours in front of my computer screen writing software. My wife Debra, whom I adore, has not complained once. In fact she encourages me to write software. Many times she has said to me... "I'd rather you wrote software, than spent your time and our money at the pub every night." To you Debra, I thank you for your patience and love.
I want to thank my wife Tuyen, who reluctantly watches me wander off to write more code, or run off to press enter to compile something during a movie. You put up with a lot my dear!
The author of MUI. Wow, what a great programming interface. PhotoFolio wouldn't be half of what it is without MUI. Thanks Stefan.
This application uses MUI - MagicUserInterface © Copyright 1992-97 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 Muünchen
GERMANY
Support and online registration is available at http://www.sasg.com.
The author of mysticview.library, guigfx.library and render.library. Without guigfx.library and render.library, PhotoFolio would be limited to CyberGraphX users only. Our thanks go to Timm for these very useful libraries. PhotoFolio supports MysticView internally, this was also made possible by Timm who wrote MysticView and made the library available to users. After endless sleepless nights and a truck load of e-mails, we got it working. Thanks a heap Timm!
This application uses MysticView by Timm S. Muëller.
mysticview.library is the third abstraction layer on top of guigfx.library and render.library.
mysticview.library provides a single display class running asynchronously in the background. It can be supplied a variety of attributes.
This library is freeware.
Requirements:
· OS 3.0 (v39)
· 68020, minimum suggested: 68030/40
· guigfx.library v16 (dev/misc/guigfxlib.lha)
· render.library v30 (dev/misc/renderlib.lha)
Supports:
· Higher CPU, FPU
· OS 3.1 (v40)
· CyberGraphX, Picasso96
Release advice and support.
Distributing PhotoFolio and continuing support of the Amiga platform
Without you, PhotoFolio wouldn't exist.
Oliver Esberger, Lucca Longone, Vit Sindlar, Victor Gutiérrez, Gérard Leyne, David Ceulemans, Daniel Sternik
Oliver Esberger, David Ceulemans, Andreas Kleinert, Dieter Muëller, Vit Sindlar
Sorting algorithm for natural order comparisons of strings in C, copyright © 2000 by Martin Pool mbp@humbug.org.au
The ppm loader in imageio.library contains code based on the pbm utility library.
pbm utility library
Copyright © 1988 by Jef Poskanzer.
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. This software is provided "as is" without express or implied warranty.
PhotoAlbum is Copyright &co; 1996-1998 by Helmut Hoffmann
· Amiga Inc - Amiga
· Haage and Partner - Amiga platform support
· Olaf Barthel - So much excellent source code, OS 3.5, OS 3.9 and more