JPEG_+_Comment 1.10
© 1995 Felix Coronado
------------------------
ARexx Pseudo-Loader for JPEG files & JPEG file comments
For use with The Art Department Professional v2.5

                         ------------------------

 Copyright and Distribution
 ==========================
 JPEG_+_Comment is copyright 1995 by Felix Coronado.  All rights reserved.


 JPEG_+_Comment is Freeware and it may be distributed only if:

 1. it is in its original unmodified form
 2. it is accompanied by this documentation
 3. nothing is charged for it, other than the cost of the media and nominal
    duplication fees

 Any distribution of JPEG_+_Comment that does not meet all of the above
 requirements must have the prior written permission of the author (Felix C.
 Coronado).

 Permission is granted to include JPEG_+_Comment in Fred Fish's Amiga Disk
 Library (including CD ROM versions of it) and the AmiNet CD ROMs.

                         ------------------------

 Disclaimer
 ==========
 This program (JPEG_+_Comment) comes with no warranty, either expressed or
 implied.  The author (Felix Coronado) is in no way responsible for any
 damage, loss, or ill-effects directly or indirectly caused by the usage of
 this program.

                         ------------------------

 What Does It Do?
 ===============
 JPEG_+_Comment is an ARexx script for use with ADPro 2.5 that searches for
 and displays any text comments contained in a JPEG file, then loads the file
 into ADPro's image buffer.

 NOTE: JPEG_+_Comment will only search for comments in JFIF JPEG files, as
 this is the only type of JPEG file that it was designed to recognize.  This
 limitation is due to the fact that I have no information on the other
 varieties (HSI JPEGs, TIFF JPEGs, PICT JPEGs, & others?) of JPEGs.  It
 wouldn't make much sense to add support for any of those types but HSI,
 since the ADPro JPEG Loader only supports JFIF and HSI JPEGS.

                         ------------------------

 Requirements
 ============
 1. ARexx
 2. Art Department Professional version 2.5
 3. ADPro JPEG Loader

                         ------------------------

 Installation
 ============
 Copy JPEG_+_Comment to your ADPro:Loaders2 directory or elsewhere.

                         ------------------------

 Using it
 ========
 Start JPEG_+_Comment using the instructions for launching ARexx scripts in
 your ADPro manual, or any other method you can think of.

 Once it starts, you will see a requester with the words "Smoothing Off" and
 three buttons.  The right button (Cancel) aborts the script.  The middle
 button changes the Smoothing status of the JPEG Loader as shown in the
 requester.  The left button (OK) accepts the Smoothing status and displays a
 file requester from which to pick a JPEG file to load.

 If the file you pick is a JPEG file, a small window will open showing the
 following:

     File: <the JPEG file you selected>
     Smoothing: <the Smoothing status of the JPEG Loader>

     Searching for comments...

     Ctrl-d to stop

 JPEG_+_Comment is now searching the selected file for comments.  If you
 press Ctrl-d (the "Ctrl" key and the "d" key at the same time) while this
 window is open, JPEG_+_Comment will stop searching for comments and go on to
 the rest of the script.  Pressing Ctrl-c while this window is open will
 abort the script.

 If you stop the search before any comments are found, or if no comments are
 found, JPEG_+_Comment will load the selected file into ADPro's image buffer.

 If JPEG_+_Comment is able to find comments, a large window will open showing
 the following:

     File: <the JPEG file you selected>
     Smoothing: <the Smoothing status of the JPEG Loader>

     Comment <number>: <Comment>

 After this window opens, JPEG_+_Comment will load the selected file into
 ADPro's image buffer.  The window will remain open until you click on its
 close gadget.

                         ------------------------

 Contacting the Author
 =====================
 If you have any bug reports, questions, suggestions, comments, or gifts to
 send me or if you would like information about the most recent versions of
 my programs, I would be glad to hear from you.  I would particularly like to
 hear from you if:

 1. You come across a JPEG file that you know contains comments but
   JPEG_+_Comment does not recognize it as a JPEG file or does not display
   the comments.  If this occurs, I would appreciate it if you sent me a copy
   of the file so that I could try to fix the problem.

 2. You have any information relating to:
    a. JPEG file comments (programs that let you add/edit them, etc.)
    b. the various JPEG file formats (the structure of JPEG files, what JPEG
      file formats can contain comments, etc.)

 I can be reached at:

 E-mail:
        Internet: (if you don't get a reply from one address, try the other)
                  felixthecat@geocities.com
                  75460.722@compuserve.com

      CompuServe: 75460,722

 WWW: www.geocities.com/Paris/2866

                         ------------------------

 Version History
 ===============
 1.10 May 21, 1995 - Minor improvements
 ---------------------------------------------------------------------------
 1.09 April 5, 1995 - JPEG_+Comment no longer differentiates between
                      "Creation info" comments and other comments
                    - Other minor improvements
 ---------------------------------------------------------------------------
 1.08 April 2, 1995 - Minor improvements
 ---------------------------------------------------------------------------
 1.07 March 26, 1995 - JPEG_+_Comment now searches the entire file for
                       comments, instead of stopping at a certain point
                     - Files are now read in variable size blocks (default
                       64K)
                     - Other minor improvements
 ---------------------------------------------------------------------------
 1.06 March 10, 1995 - JPEG_+_Comment should now be able to recognize all
                       JFIF JPEG files
 ---------------------------------------------------------------------------
 1.05 March 6, 1995 - JPEG_+_Comment now detects multiple "Comment" comments
                      if they are present and displays them as
                      "Comment <number>:"
                    - Other minor improvements
 ---------------------------------------------------------------------------
 1.04 March 1, 1995 - Fixed a bug that could prevent JPEG_+_Comment from
                      detecting "Comment:" comments in certain rare cases
                    - Fixed "Ctrl-d to abort" message to say "Ctrl-d to stop"
 ---------------------------------------------------------------------------
 1.03 February 28, 1995 - If the JPEG Loader runs into trouble while loading
                          an image, JPEG_+_Comment will now make itself the
                          currently selected loader before exiting
 ---------------------------------------------------------------------------
 1.02 February 23, 1995 - First public release
 ---------------------------------------------------------------------------
 1.0 January 15, 1995
 ---------------------------------------------------------------------------

                         ------------------------

 Other Stuff by Felix Coronado
 =============================
 Look for these other fine ARexx scripts/programs by Felix Coronado:

 Cataloger - ARexx script for The Art Department Professional v2.x or
             MorphPlus.  Makes image catalogs containing thumbnails of
             selected files.
             Features include:
             - Loads & saves most ADPro/MorphPlus file formats
             - Many options, different combinations can be saved & loaded
             - Files can be picked from requesters, FRED Sequence files, or
               ASCII file lists

 GIF_+_Comment - ARexx script that acts as a pseudo-Loader for The Art
                 Department Professional v2.5.  Loads a GIF file while
                 displaying any text comments contained in the file.

 ShowComment.rexx - ARexx program that searches for and displays any text
                    comments contained in a JPEG or GIF file.
