home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 2 / MECOMP-CD-II.iso / amiga / grafix / transgraphica / read.me < prev    next >
Encoding:
Text File  |  1998-01-18  |  6.0 KB  |  201 lines

  1.  
  2.   NAME: TransGraphica
  3.  
  4.  SHORT: A utility to convert ASCII pictures to IFF
  5.  
  6. AUTHOR: Francis G. Loch a.k.a. Dreamland Fantasy
  7.  
  8.   DATE: 18th January 1998
  9.  
  10.  
  11. Copyright
  12. ---------
  13.  
  14.    This program is Freeware (not Public Domain) and is the copyrighted
  15.    property of the author.
  16.  
  17.  
  18. Distribution
  19. ------------
  20.  
  21.    This program may be freely copied and distributed provided that no charge
  22.    is made for the copy and that none of the files in the archive are
  23.    altered, omitted or added to in any way, shape or form.
  24.  
  25.    PD companies are excluded from the above and are permitted to charge for
  26.    the program to cover any costs or overheads provided that no more than
  27.    £2.50 is charged per copy (this includes postage and packaging). None of
  28.    the files in the archive may be altered, omitted or added to in any way
  29.    shape or form without the permission of the author.
  30.  
  31.  
  32. Note to magazines and CD-ROM publishers
  33. ---------------------------------------
  34.  
  35.    If you intend to include this program on a cover-disk and/or CD-ROM
  36.    please notify me first so that I can ensure that you have the latest
  37.    version of the program.
  38.  
  39.  
  40. Disclaimer
  41. ----------
  42.  
  43.    I make no guarantees about the performance of this program and I will not
  44.    under any circumstances accept responsibility for any loss of data or
  45.    damage to equipment as result of using this program.
  46.  
  47.  
  48. Requirements
  49. ------------
  50.  
  51.    - An Amiga (or compatible) with OS 2.0 or greater
  52.  
  53.    - ReqTools library
  54.  
  55.  
  56. Test information
  57. ----------------
  58.  
  59.    This program has been tested on the following setups:-
  60.  
  61.    - A basic Amiga 1200.
  62.    - An Amiga 1200 with a 50 MHz Blizzard 1230-IV (no FPU), 2+32 meg of RAM,
  63.      hard disk, 8x CD-ROM drive and external floppy drive.
  64.  
  65.    The program has also been tested with CPU caches off and the original and
  66.    enhanced chip set options.
  67.  
  68.  
  69. A message from the author
  70. -------------------------
  71.  
  72.    If you use this program and like it, I would greatly appreciate any
  73.    comments or suggestions you may have regarding it. This would also let me
  74.    know if it is worthwhile supporting and updating this program because at
  75.    present I do not know if there are many people that would have a use for it.
  76.  
  77.    Also, if anyone has a setup different from those listed in the "Test
  78.    information" section then please notify me.
  79.  
  80.    My contact address can be found near the end of this text file.
  81.  
  82.  
  83. Background
  84. ----------
  85.  
  86.    One day I got a hold of some pretty groovy ASCII clipart. Looking through
  87.    some of them I thought "Hey, wouldn't that look good as a proper graphic"
  88.    and so began the story of TransGraphica. The original program
  89.    (imaginatively entitled "ASCII>IFF") was quickly written and the ASCII
  90.    clipart was then successfully converted to IFF.
  91.  
  92.    Several months later, I was looking for a programming project to do and
  93.    after a few brainstorming sessions I thought to myself "Hmm, perhaps I
  94.    could re-program ASCII>IFF". Work was promptly started on the new version
  95.    of ASCII>IFF, TransGraphica.
  96.  
  97.  
  98. Instructions
  99. ------------
  100.  
  101.    TransGraphica should be pretty simple to understand but here is a list of
  102.    its functions anyway:-
  103.  
  104.    Project
  105.    -------
  106.    Load ASCII file       - Loads an ASCII file.
  107.    Save as IFF-ILBM file - Saves the ASCII picture as an IFF-ILBM file.
  108.    About                 - Displays details about TransGraphica.
  109.    Quit                  - Quits TransGraphica.
  110.  
  111.    Options
  112.    -------
  113.    Inverse video         - Allows you to switch between black on white and
  114.                            white on black.
  115.    Reset window          - Resets the window back to its original size
  116.  
  117.  
  118. Program history
  119. ---------------
  120.  
  121.    - ASCII>IFF          The original program. Never released.
  122.  
  123.    - Version 1.0        Initial release. Complete re-write of the original code.
  124.  
  125.    - Version 1.01       Corrected the save iff routine as it did not save the
  126.                         pictures properly in inverse video.
  127.  
  128.    - Version 1.1        Improved the viewer palette routines so that it will
  129.                         find the required colour or the nearest one to it.
  130.  
  131.    - Version 1.2        The program now autoscales the pictures. Added the
  132.                         "Reset window" option. Optimised the palette routines.
  133.  
  134.  
  135. Known bugs and limitations
  136. --------------------------
  137.  
  138.    - Sometimes if you attempt to load a non-ASCII file the program will crash.
  139.  
  140.    - If you are running Magic Menu sometimes it changes the palette when you
  141.      activate the menus, particularly if you are using high-colour Workbench
  142.      screens. This does not affect how the picture is saved.
  143.                                                            
  144.    - Only handles upto 150 lines of text.
  145.  
  146.    - The text width is always 80 (I have never come across a text file that has
  147.      a width greater than this).
  148.  
  149.    - The tab is always 8 spaces (Again, I have never come across a text file
  150.      that has a tab that has been different from this).
  151.  
  152.  
  153. The future of TransGraphica
  154. ---------------------------
  155.  
  156.    Depending on the response TransGraphica gets (see "A message from the
  157.    author" above) the following features may possibly be added in future
  158.    releases:-
  159.  
  160.    - Handling of files that have more than 150 lines
  161.  
  162.    - Scroll bars so that you can go up and down big ASCII files
  163.  
  164.    - This READ.ME file improved and re-written as an AmigaGuide
  165.  
  166.    - An install script
  167.  
  168.    - Bug fixes
  169.  
  170.  
  171. Contacting the author
  172. ---------------------
  173.  
  174.    I can be contacted via the following address:-
  175.  
  176.         Francis G. Loch,
  177.         Medical Technical Officer,
  178.         Medical Physics Instrument Lab,
  179.         Ground Floor,
  180.         Glasgow Royal Infirmary,
  181.         84 Castle Street,
  182.         Glasgow,
  183.         Scotland,
  184.         United Kingdom,
  185.         G4 0SF.
  186.  
  187.    Please note that this address can be used until July 31, 1998. Thereafter
  188.    I cannot be contacted at this address.
  189.  
  190.  
  191. Contents of archive
  192. -------------------
  193.  
  194.    - TransGraphica              The TransGraphica program
  195.  
  196.    - TransGraphica.info         The icon for the program
  197.  
  198.    - READ.ME                    This text file
  199.  
  200.    - READ.ME.info               The icon for the text file
  201.