home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 314.lha / TMP_to_DP / TmpToDP.doc < prev    next >
Text File  |  1989-11-30  |  6KB  |  130 lines
  1. TempToDP - send ".tmp" format files directly into DigiPaint 3
  2. -------------------------------------------------------------
  3.  
  4. Scenario 1
  5. ----------
  6.   The Sliced Ham (SHAM) stuff was going around, and it was producing
  7. really nice results.  However, one thing that the conversion programs
  8. did that I found unforgiveable was to "average" pixels if the picture
  9. crossed a certain width or height boundary, thus drastically modifying
  10. the orignal image.
  11.  
  12. Scenario 2
  13. ----------
  14.   After getting my hands on DigiPaint 3 (and just playing with it
  15. for a few days), I started looking at the AREXX commands.  Since
  16. these commands use a regular message port, it is possible to
  17. bypass AREXX completely and send data directly to it from another
  18. program.  The GIFTOTMP program included with the distribution
  19. did okay, but the final conversion process would squeeze the picture
  20. down to fit on a "normal" screen.  Heck, I wanted to take these
  21. 256 color GIF pictures that I had downloaded and see them in 
  22. close to all of their glory, even if I had to scroll around to see
  23. them.
  24.  
  25. The Result
  26. ----------
  27.   Well, you can already guess.  I wrote a program to take the output
  28. of GIFTOTMP and send it directly to DigiPaint 3.  The result of my
  29. efforts is TmpToDP, the program you now have in your hands.  Using
  30. this program, I've been able to convert pictures as large as 800 x 400
  31. pixels from 256 color GIF files into huge HAM pictures that you can
  32. view and play with in DigiPaint 3 (my favorite toy for now).
  33.  
  34.   And DigiPaint 3 does one hell of a rendering, too.
  35.  
  36. Using the program
  37. -----------------
  38.   TmpToDP runs only from CLI.
  39.   
  40.   The command line template looks like this:
  41.   
  42.   Usage : TempToDP <temp file> <digipaint portname>
  43.   
  44.   The meanings of these are:
  45.   
  46.   <temp file> - the name of the .tmp file that has been produced by
  47.     the GIFTOTMP program.
  48.   <digipaint portname> - since the name of the DigiPaint 3 port for
  49.     passing messages can differ depending on how you invoke DigiPaint 3,
  50.     you must specify the portname that it is expecting.  See the
  51.     DigiPaint 3 manual for information on what the portname will be.
  52.   
  53.   After you do this, assuming everything has gone well (ie. the portname
  54. has been found and the file opened), TmpToDP will begin sending lines
  55. of data from the file to DigiPaint 3.  There is no intermediate file
  56. needed, and the program doesn't take up too much memory since it only
  57. processes one line at a time.  This way, you can usually get huge pictures
  58. over to DP3 without using lots of memory.
  59.  
  60.   You may abort operation of the program safely at any time by
  61. pressing control-c.
  62.  
  63. Hints
  64. -----
  65.   Most of the time, the picture that you send in will look fine.  There
  66. will be times that you might get a little bit of fringing.  If that is the
  67. case, then try adjusting the base palette to colors close to the ones that
  68. are in the picture.  This can make an immense difference if the colors on
  69. the screen are far removed from the ones in the base palette.  After
  70. adjusting the base palette, send the picture in one more time.
  71.   
  72.   Something interesting to note - dithering is active on lines that are
  73. being sent in, if it is turned on within DigiPaint 3.  Sometimes this
  74. can help or hurt the picture you're passing in.  Experimentation is the
  75. best way to figure out what works best.
  76.  
  77.   Make *sure* that what you are passing into the program is a tmp format
  78. file.  (sorry, I don't know the 'official' name for this format)  There
  79. is no "signature" in the file to indicate whether it is indeed this
  80. format, so I have not gone to the trouble of putting in any check
  81. routines.  This means that you can probably screw things up by reading
  82. in some other strange binary format file.  (readtemp c:dir DigiPaint3)
  83.  
  84. Notes
  85. -----
  86.   The GIFTOTMP program that is referenced herein is contained in the
  87. SHAMVIEW3.ZOO distribution (as it is known on BIX).  It was written
  88. by Mark Podlipec, and is not included in this distribution.
  89.   
  90.   The "cop2.tmp" file included in this distribution is a ready-to-send
  91. "tmp" formatted file for you to experiment with, should you not have
  92. any GIF format pictures or GIFTOTMP laying around at the moment.
  93.  
  94.   For those who would like to try their hand at doing something similar
  95. to this for other file formats, the entire Modula-2 source code (fairly
  96. well commented) is included.  Also, I have heard that there are other
  97. pieces of PD software that output this mysterious "tmp" file format, but
  98. I have had yet to run across them.  If you can inform me better on this
  99. subject, contact me at one of the contact spots below.
  100.  
  101. ------------------------------------------------------------------------
  102.     This program was developed using M2Sprint Modula-2 from M2S Inc.,
  103.   Dallas, Texas.  This is a very friendly, very powerful, very
  104.   feature-packed development environment.  If you are at all interested
  105.   in Modula-2, you should check out the competition and then check
  106.   out M2Sprint.  You won't be disappointed.
  107. ------------------------------------------------------------------------
  108.   
  109. Distribution & Stuff
  110. --------------------
  111.     This program is freely distributable.  There is no fee or charge
  112.   associated with its use, only that you abide by these rules when 
  113.   redistributing it.  It may be included on public domain collections 
  114.   that cost THE SAME AS THE FISH DISKS OR LESS.  In other words, only
  115.   on PD disks that charge only for media and/or mailing compensation.
  116.     Please, if you distribute this, keep the archive intact, or be
  117.   sure to include everything that has been included with this program
  118.   if it is being made available in an uncompressed format.
  119.     Also, this may be uploaded to any network or bulletin board that 
  120.   claims no sort of copyright on material posted there.  
  121.   
  122.     To talk to a starving Amiga developer:
  123.     
  124.     bix : csbailey (this is preferred)
  125.     
  126.     phone: (803) 794-4933
  127.     mail : Chris Bailey
  128.            2405, Feather Run Trail
  129.            W. Columbia, SC  29169
  130.