home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 013.lha / Mac_View / macview.doc < prev    next >
Encoding:
Text File  |  1986-11-10  |  9.3 KB  |  201 lines
  1.               MacPaint Viewer Program
  2.                    V1.2 - 1/8/87
  3.                  Scott P. Evernden
  4.             ===========================
  5.  
  6. Congratulations! You have just downloaded the best MacPaint to Amiga
  7. utility available.  I hope that you will find many uses for this tool as
  8. well as the paint images that it displays and can produce for use on
  9. your Amiga and/or MacIntosh.  (MacView V1.2 requires KickStart 1.2 to
  10. operate properly.)
  11.  
  12. What does it do?
  13. ================
  14. MacView allows you to view a standard MacPaint picture file on your
  15. Amiga.  You can look at the image in either of Amiga's low resolution
  16. (320 x 200 pixels) or high resolution (640 x 400 pixels) modes.  Because
  17. the MacIntosh utilizes square pixels, only these 2 view modes are
  18. supported, since they result in the squarest pixels available on the
  19. Amiga.  You can switch modes while the program is running.  MacView also
  20. allows you to convert an Amiga (color) IFF picture into a (black &
  21. white) MacPaint picture. 
  22.  
  23. MacPaint images measure 576 x 720 pixels, so it is clearly not possible
  24. to look at the entire MacPainting at once.  For this reason, MacView
  25. provides 1 (in hi-res) or 2 (in lo-res) thumbing bars to allow you to
  26. pan around in the larger MacPaint image.  This latest release of the
  27. program also provides a hand cursor which you can use to push the
  28. MacPaint image around.  It appears whenever the left mouse button is
  29. pressed. 
  30.  
  31. This program uses a fixed color palette of black on white to replicate
  32. the appearance of the Mac screen.  Sorry, I provided no mechanism to
  33. change this.
  34.  
  35. In addition, MacView provides you with the ability to "snapshot" your
  36. current screen into an IFF paint file.  IFF paint files are used by
  37. DeluxePaint, Aegis Images, and Graphicraft, and should be compatible
  38. with other and future Amiga paint programs.  Once you have produced the
  39. IFF file(s), you can leave MacView, start up your favorite paint
  40. program, and load the image.  At this point, you will have available the
  41. full range of your paint program's capabilities to alter the picture. 
  42. Nothing could be simpler!
  43.  
  44. MacView now can read and convert an Amiga IFF file into a MacPaint file. 
  45. The program uses a simple dithering technique to convert up to 5 planes
  46. of color information into a 1 plane monochrome image.  Now you can exchange
  47. paintings and pictures with your MacBuddies!
  48.  
  49. Finally, rev 1.2 of MacView provides you with the capability to print
  50. either the current screen image, or the entire MacPainting. 
  51.  
  52. Installing MacView
  53. ==================
  54. Since you now clearly have de-arced the MacView files, you need do
  55. little more than ensure (for Workbench use) that MacView (and its
  56. associated MacView.info file) is located at the top of a floppy's
  57. directory structure (in DF0: or DF1:, not in a sub-directory).  You will
  58. note that I have included (in rev1.2) a new MacPainting (and its .info
  59. file) to get you started.  You can put the MacPaint file anywhere on the
  60. same disk.  It's a good idea to keep several MacPaint files in their own
  61. directory (i.e., drawer). 
  62.  
  63. Using MacView
  64. =============
  65. MacView can be run from either the Workbench or CLI.  From Workbench,
  66. simply open the MacView icon, and you will see an empty painting.  You
  67. will need to use the PROJECT menu to indicate a file to be opened for
  68. viewing.  Alternatively, from the Workbench, you can open any of the
  69. MacPaint image files, and MacView will run displaying that file's
  70. contents.
  71.  
  72. From CLI, simply incant "MacView filename" to get a hi-res screen of the
  73. Mac painting.  The filename is optional.  Also, from CLI, MacView will
  74. accept a number of "switches" to control its default operation.  These
  75. can be listed by typing "MacView ?" for the switch list.  Current (rev1.2)
  76. switches (changed from rev1.01) support:
  77.  
  78.     MacView [-b] [-f] [-h] [-n] [mfile]
  79.  
  80.     -b: omit MacBinary header on MacPaint output.
  81.     Normally MacView prepends a standard 128-byte header to output
  82.     MacPaint files.  This header facilitates the file transfer to a
  83.     MacIntosh via the "MacBinary" XMODEM protocol.
  84.  
  85.     -f: skip MacPaint filetype checks (force)
  86.     MacView will complain if it doesn't see certain byte patterns
  87.     indicating a valid MacPaint input file.  You can _try_ this
  88.     switch if you are having trouble.
  89.  
  90.     -h: hi resolution screen
  91.     Otherwise comes up in (flicker-free!) lo-res.
  92.  
  93.     -n: noncompressed IFF output
  94.     Graphicraft uses an older noncompressed IFF file format for its
  95.     pictures.  You need to use this switch for that program.
  96.  
  97.  mfile: MacPaint file to view
  98.  
  99.  
  100. The PROJECT menu provides options to read IFF and MacPaint files for
  101. viewing; you can also write IFF and MacPaint files suitable for use
  102. on the Amiga and MacIntosh, respectively.  From the PROJECT menu, you
  103. can also print the picture being viewed.  A Partial print dumps only the
  104. current window contents to the printer, while a Full print will produce
  105. a full-size 8 x 10 inch hardcopy of the entire MacPainting.
  106.  
  107. The VIEW MODES menu allows you to alternate between low and high resolution
  108. on-the-fly.
  109.  
  110. General Notes
  111. =============
  112. When reading an IFF picture or brush, MacView will double the size of the
  113. image if you are in the hi-res (640 x 400) viewmode and if the IFF image
  114. is 320 x 200 or smaller.  This will result in a chunk of the IFF painting
  115. missing on the right side if it's width is greater than 288 pixels.
  116. Note that your current position in the MacPainting (indicated by the
  117. thumbing bars) is used for placement of IFF pictures being read.
  118.  
  119. The dither technique employed to convert from color to black and white is
  120. adequate, in my opinion, for most of the IFF paintings I have tried.  I
  121. welcome any new ideas in this area.  Unfortunately, the dithering accentuates
  122. the flicker in hi-res mode.  One-plane IFF files will convert directly into
  123. MacPaint files with no degradation as long as the 2 colors used have
  124. sufficient contrast to one another.
  125.  
  126. I have almost no access to a MacIntosh, so please be aware that I am
  127. shooting a little blindly here.  A new hotspot in MacView 1.2 concerns
  128. the production of the MacBinary file header.  My source of information
  129. for the format is from the Jan '86 issue of MacTutor.  I think I got it
  130. right; let me know immediately if I'm wrong.  I have tested (briefly)
  131. moving the MacPaint output produced by this program to a MacIntosh via
  132. MacTerminal.  The Mac has a different date format than that used by the
  133. Amiga - I have not yet determined if I am writing the
  134. creation/modification date correctly in the MacBinary header. 
  135.  
  136. The (-f) "force" option can be used to make MacView accept MacInput
  137. which it would otherwise refuse.  Currently MacView performs these
  138. checks when opening a supposed MacPainting:
  139.  
  140.     128 bytes are read, otherwise a hard (non-forceable) error.
  141.     If the 0th, 74th, and 82nd bytes are 0, and if 65-68 are "PNTG",
  142.         then these 128 bytes are a MacPainting MacBinary header.
  143.     If MacBinary, and 69-72 are "MPNT" or "PANT" then OK,
  144.         and 512 bytes (of MacPaint header) are read.
  145.     If not MacBinary, and 0-3 contain a (long) binary 2, then OK,
  146.         and 384 more bytes (of Macpaint header) are read.
  147.     If not OK and no -f switch, then complain, otherwise forge ahead.
  148.  
  149. The MacPaint header is ignored by MacView.  I have reason to suspect
  150. that a binary 3 might also legally start the MacPaint header. 
  151. Information on the various Apple formats are almost impossible to
  152. acquire, so please inform me if this looks like i'm taking the wrong
  153. approach. 
  154.  
  155. This is still an early version of this program.  I welcome and encourage
  156. comments and criticisms in order to improve it in any way.  Most of my
  157. testing has occurred under the CLI, so please let me know if you
  158. experience any anomolies.  I would like to thank those folks, especially
  159. the Amiga Zone gang on PeopleLink, who provided ideas for new features. 
  160.  
  161. Other Things
  162. ============
  163. When producing files for import into Aegis Images, you will need to name
  164. the IFF files with a ".pic" suffix (like "woodcut.pic"), since Images
  165. will only list and read paintings with this extension.  Also, Images
  166. DOES NOT accept hi-res IFF at this time, so don't bother trying.  If you
  167. use Graphicraft, then you will need to run MacView from CLI, and use the
  168. -n switch, since Graphicraft is an older program which doesn't
  169. understand compressed IFF files.  Graphicraft, like Images, also can't
  170. handle hi-res pictures.
  171.  
  172. I am well aware of a number of features which would be desireable to add
  173. to this program.  Real file requesters, color control, positive/negative
  174. switching, etc., are just some ideas which are obvious.  Perhaps a
  175. choice of dither patterns should be offered to yield different
  176. graininess in the MacPaint output.  MacView does not yet support HAM IFF
  177. images ($hould it?).  Finally, some form of contrast/brightness control
  178. for the IFF->MacPaint conversion could be added. 
  179.  
  180. These files and the MacView Program may be freely distributed and given
  181. away as shareware, as long as you don't make any money from it and you
  182. don't claim you're the author.  Leave this file and allow me the credit!
  183.  
  184. Lastly, I am still (still!) paying for my Amiga, and I need your help. 
  185. If you feel that this program is serving you in some useful way, then
  186. consider sending me $10 or more.  This would serve to uplift my
  187. confidence in shareware, and to assure you of future stuff.  If you
  188. don't like the program, then forget it (write one yourself!).  Money and
  189. hardcopy correspondence can be directed to me at:
  190.  
  191.     Scott P. Evernden
  192.     9 Courtland St.
  193.     Holliston, MA 01746
  194.  
  195. Electronically, I am:
  196.  
  197.     PLINK:    SCOTT E
  198.     CIS:    73116,3451    (don't expect a speedy response)
  199.  
  200. Have fun!
  201.