home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 004.lha / MacView.doc < prev    next >
Encoding:
Text File  |  1986-03-02  |  5.3 KB  |  113 lines
  1.             MacPaint Viewer Program
  2.                 V1.01 - 8/10/86
  3.              by Scott P. Evernden
  4.             =======================
  5.  
  6. Congratulations!  You have just downloaded the best MacPaint to Amiga utility
  7. available.  I hope that you will find many uses for this tool as well as the
  8. paint images that it displays and can produce for use on your Amiga.
  9.  
  10. What does it do?
  11. ================
  12. MacView allows you to view a standard MacPaint picture file on your Amiga.
  13. You can look at the image in either of Amiga's low resolution (320 x 200
  14. pixels) or high resolution (640 x 400 pixels) modes.  Because the MacIntosh
  15. utilizes square pixels, only these 2 view modes are supported, since they
  16. result in the squarest pixels available on the Amiga.  You can switch modes
  17. while the program is running.
  18.  
  19. MacPaint images measure 576 x 720 pixels, so it is clearly not possible to
  20. look at the entire MacPainting at once.  For this reason, MacView provides
  21. 1 (in hi-res) or 2 (in lo-res) thumbing bars to allow you to pan around in
  22. the larger MacPaint image.
  23.  
  24. This program uses a fixed color palette of black on white to replicate the
  25. appearance of the Mac screen.  Sorry, I provided no mechanism to change this.
  26.  
  27. In addition, MacView provides you with the ability to "snapshot" your
  28. current screen into an IFF paint file.  IFF paint files are used by
  29. DeluxePaint, Aegis Images, and Graphicraft, and should be compatible with
  30. other and future Amiga paint programs.  Once you have produced the IFF
  31. file(s), you can leave MacView, start up your favorite paint program, and
  32. load the image.  At this point, you will have available the full range of
  33. your paint program's capabilities to alter the picture.  Nothing could be
  34. simpler!
  35.  
  36. Installing MacView
  37. ==================
  38. Since you now clearly have de-arced the MacView files, you need do little
  39. more than ensure (for Workbench use) that MacView (and its associated
  40. MacView.info file) is located at the top of a floppy's directory structure
  41. (in DF0: or DF1:, not in a sub-directory).  You will note that I have
  42. included a several (perhaps familiar) MacPaintings (and .info files) to get
  43. you started.  You can put the Mac files anywhere on the same disk.  It's a
  44. good idea to keep them in their own directory (i.e., drawer).
  45.  
  46. Using MacView
  47. =============
  48. MacView can be run from either the Workbench or CLI.  From Workbench, simply
  49. open the MacView icon, and you will see an empty painting.  You will need
  50. to use the PROJECT menu to indicate a file to be opened for viewing.
  51. Alternatively, from the workbench, you can open any of the MacPaint image
  52. files, and MacView will run displaying that file's contents.
  53.  
  54. From CLI, simply incant "MacView filename" to get a hi-res screen of the Mac 
  55. painting.  The filename is optional.  Also, from CLI, MacView will accept a
  56. number of "switches" to control its default operation.  These can be listed
  57. by typing "MacView ?" for the switch list.  Current switches support:
  58. starting up in low vs. hi res (-l or -h; hi-res (-h) is by default);
  59. control of whether MacView outputs compressed vs non-compressed IFF files
  60. (-c or -n; compress (-c) is the default).
  61.  
  62. You can load new Mac files using the PROJECT menu; you also use this menu to
  63. output the IFF files to be subsequently loaded into your Amiga paint program.
  64.  
  65. The VIEW MODES menu allows you to alternate between low and high resolution
  66. on-the-fly.
  67.  
  68. General Notes
  69. =============
  70. This is an early version of this program.  I welcome (nay, encourage)
  71. comments and criticisms in order to improve it in any way.  Most of my
  72. testing has occurred under CLI, so please let me know if you experience any
  73. anomolies.
  74.  
  75. I had little to go on in trying to figure out if a MacPaint file really came
  76. from MacPaint.  I still do not know the format of the header except there
  77. appear to be two different formats.  One (older?) format has a 512 byte
  78. header starting with a long 2; another format holds a 640 byte header, and
  79. contains the characters "PNTGMPNT" starting at the 65'th byte.  If neither of
  80. these criteria is met, MacView will indicate that the file doesn't look like
  81. a MacPaint file.  Both header formats also appear to contain the fill
  82. patterns, which this program makes no use of.  If you know more, please let
  83. me know.  This program should correctly operate on MacPaint files which have
  84. NOT been chopped due to XMODEM funnies, so start downloading whenever.
  85.  
  86. When producing files for import into Aegis Images, you will need to name the
  87. IFF files with a ".pic" suffix (like "woodcut.pic"), since Images will only
  88. list and read paintings with this extension.  Also, Images DOES NOT accept
  89. hi-res IFF at this time, so don't bother trying.  If you use Graphicraft,
  90. then you will need to run MacView from CLI, and use the -n switch, since
  91. Graphicraft doesn't understand compressed IFF files.  Graphicraft, like
  92. Images, also can't handle hi-res pictures.
  93.  
  94. These files and the MacView Program may be freely distributed and given
  95. away, as long as you don't claim you're the author.  Leave this file and
  96. allow me the credit!
  97.  
  98. Lastly, I am still paying for my Amiga, and I need your help.  If you feel
  99. that this program is serving you in some useful way, then consider sending
  100. me some bucks.  If you don't like the program, then forget it (write one
  101. yourself!).  All hardcopy correspondence can be directed to me at:
  102.  
  103.     Scott P. Evernden
  104.     9 Courtland St.
  105.     Holliston, MA 01746
  106.  
  107. Electronically, I am:
  108.  
  109.     PLINK:    SCOTT E
  110.     CIS:    73116,3451    (don't expect a speedy response)
  111.  
  112. Have fun!
  113.