home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d557 / dpatch.lha / DPatch / DPatch.doc < prev    next >
Text File  |  1991-10-28  |  6KB  |  122 lines
  1. Documentation for DPatch v4.00 by Colin Bell.
  2. --------------------------------------------
  3. Docs by Colin Bell & Tom Ellard.
  4.  
  5. Distribution and Legal.
  6. -----------------------
  7.      DPatch is copyright 1991 by Colin Bell. It may be freely distributed
  8. for no more than the cost of the media. It may not be sold, sold as part of
  9. a commercial product or placed under restricted access for profit. This
  10. prohibits sale by commercial shareware libraries.
  11.  
  12.      Use this program at your own risk. The author will not be responsible
  13. for any losses or damages resulting from use of the program.
  14.  
  15. Synopsis.
  16. ---------
  17.      Dpatch replaces values within the code for Deluxe Paint 4.0 and 3.25.
  18. These values control the screen sizes. By editing a configuration file you
  19. can run DPaint with any screen size.
  20.  
  21. Why you need DPatch
  22. -------------------
  23.      Version 3.1 of DPaint was the first to offer painting and animation in
  24. overscan. Version 3.14 added PAL television support (3.1 would work under
  25. PAL but crash under some conditions.) Under the PAL system, overscan was
  26. provided at 352 pixels by 290 pixels. This size looks OK on a computer
  27. monitor and most televisions but leaves a gap at one side of the screen
  28. when viewed on broadcast quality monitors. To use DPaint images for
  29. broadcast required stretching the picture horizontally with something like
  30. an ADO.
  31.      When Workbench 2.0. arrived, DPaint had problems with requesters and a
  32. conflict with 2.0.'s use of the left Amiga key. So version 3.25 was
  33. released. 3.25 adds a new maximum overscan mode which makes it useful for
  34. broadcast. Stupidly, the size for normal overscan has been revised to be
  35. 352 by 283. Any animation made by Deluxe Paint 3.14 is distorted into
  36. interlace mode and unusable. So you have a situation where you need to have
  37. two copies of DPaint available for old and new sized animations.
  38.      Another problem is that DPaint3.25/4.0. will not load animations that
  39. don't match its preset screen size. Just about every different program has
  40. its own idea of overscan and so the IFF standard is made useless.
  41.      After putting up with situation for many years and owning three copies
  42. of Deluxe Paint we declared a new interface guideline for all Amiga
  43. programs. No preset overscan size, always offer a way to enter a custom
  44. size. And if they don't do it right - we'll show them how! :-)
  45.  
  46. Installing DPatch.
  47. ------------------
  48.      Place all the DPatch files in the same drawer as your copy of DPaint.
  49. Note - I said copy. Never patch the original.
  50.      Using a text editor such as Ed, TxEd, TransWrite or any that saves
  51. pure text without formatting, load DPatch.config.
  52.      You will see a list of all the different screen sizes under which
  53. DPaint can operate. Alongside these are the names given to these sizes. For
  54. example:
  55.      #0283     ;STD PAL LORES
  56.      means that standard PAL LoRes will be 283 pixels tall. Ugh, we want
  57. 290. Change #0283 to #0290. Do this for any other screen size you want to
  58. change. You can make comments anywhere to the right of a ; symbol, but
  59. don't alter the format of the numbers. Now resave the file Dpatch.config to
  60. the directory holding DPaint
  61.  
  62.      Ok, now double click on the DP4 icon. This uses Iconx to execute a
  63. script that runs DPatch and then DPaint. You'll see a menu asking:
  64.  
  65.                NORMAL
  66.                OLD
  67.                CUSTOM
  68.                     
  69.      Normal means keep to the sizes provided with DPaint 3.25/4.0. Old
  70. means use the sizes that came with DPaint 3.14. And most fun of all, Custom
  71. means use the sizes that were set in the configuration. Click on one of
  72. these and up comes DPaint, with the sizes you want.
  73.  
  74. Running from CLI and scripts.
  75. ----------------------------
  76.      At the CLI prompt type DPatch [path]
  77.  
  78.      If no filename is specified the program looks for "Dpaint" in the
  79. current directory & path. If you supply the path/name from the CLI eg. 
  80.      dpatch Gfx:Paint/Deluxepaint
  81. then it will attempt to find that file. You cannot specify a different path
  82. from Workbench.
  83.      If Dpatch aborts for any reason it will set an ERROR returncode (10)
  84. for a fatal error (One which displays an error message) or a WARN (5)
  85. returncode if you click on the close gadget. This is useful in your script
  86. file so that you can abort running Dpaint if there is a problem.
  87.  
  88. Problems
  89. -------- 
  90. - Wrong version of DPaint. You need Dpaint 3.25/4.0., 3.25 has a bright
  91. green sticker on the box saying AmigaDOS 2.0. compatable. 4.0. has the
  92. multiple ghosted Tut face on it.
  93.  
  94. - Can't find the configuration. It should be in the same directory as
  95. DPatch and Dpaint or S: of the workbench from which DPatch and Dpaint are
  96. run.
  97.  
  98. - Dpatch cannot be used on crunched versions of Dpaint. If you have used
  99. Powerpacker or Imploder to compress DPaint, decompress it, patch it, and
  100. compress it again.
  101.  
  102. - All hell breaks loose! Well, go easy on those screen sizes! This patch
  103. runs fine on an Amiga 3000 under 2.0. but if you are using a 1000 under 1.3
  104. you're going to have problems with CHIP memory running out and 1.3 not
  105. liking big screens. Also setting the sizes to stupid things like 2 by 2
  106. pixels will just get you in trouble.
  107.  
  108. How DPatch works.
  109. -----------------
  110. Basically, the table of screen sizes built into Dpaint gets overwritten by
  111. Dpatch. It was found that this table of screen sizes is used by dpaint to
  112. completely control the screen sizes AND memory allocated for the screen.
  113. The patch is done to the file on disk. For this reason, it may be best to
  114. completely delete the Dpaint icon & only use the Dpatch script to launch
  115. dpaint.
  116.  
  117. Colin can be contacted at:
  118.                       PO Box 1058       FidoNet:  3:712/512
  119.                       Bondi Junction
  120.                       N.S.W.  2026
  121.                       Australia
  122.