home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / d / deep4all / !Deep4All / !Help < prev    next >
Text File  |  1997-01-18  |  9KB  |  254 lines
  1. **************************************************
  2. *                                                *
  3. *                   Deep4All                     *
  4. *                  ~~~~~~~~~~                    *
  5. *         © 1995-1996 by Andreas Dehmel          *
  6. *                                                *
  7. *    A viewer for new type sprites for *all*     *
  8. *             Acorn RISC machines.               *
  9. *                                                *
  10. *                    V 0.12                      *
  11. *                                                *
  12. **************************************************
  13.  
  14.  
  15. This application is of interest mostly for non-
  16. RiscPC owners.
  17.  
  18. Simply install !Deep4All on the icon bar by double
  19. clicking on its filer icon. You can view Sprites (new
  20. and old format, except for CMYK Sprites) by dragging
  21. them on !Deep4All's icon or double clicking on them.
  22.  
  23. If you have a graphics card installed that gives you
  24. true colour screenmodes in the desktop (e.g. Colour
  25. Card Gold) you can also view sprites in these colour
  26. depths.
  27.  
  28. The sprites are not dithered. That's why true colour
  29. sprites usually look rather poor in screenmodes with
  30. less than 16bpp. This is not the program's fault -
  31. to verify this simply run the sprite through !ChangeFSI
  32. with dithering disabled. It is however a quick and
  33. easy way to examine a sprite and - AFAIK - the only
  34. way to view true colour sprites in true colour modes
  35. in the desktop on older machines.
  36.  
  37.  
  38. Requirements:
  39.  
  40. Probably RISC OS 3 - I can't say about RISC OS 2 since
  41. I don't have access to any such machines. Apart from
  42. that Deep4All should happily run with pretty much
  43. anything.
  44.  
  45.  
  46.  
  47. CHANGES SINCE VERSION 0.01
  48. ==========================
  49.  
  50.  
  51. 1) Cooperates with ChangeFSI
  52. ----------------------------
  53.  
  54. Deep4All now also recognizes a load of foreign file types
  55. (including JPEG, GIF, TIFF, Targa,...) and calls ChangeFSI
  56. to convert them to sprites, thus effectively becoming a
  57. ChangeFSI front-end. Foreign filetypes are only accepted
  58. from the filer, not from other applications, though. The
  59. reason is that in order to call ChangeFSI the image has to
  60. be present as a file somewhere. Of course you could always
  61. hack your way around that but the question is: do you want
  62. to? I don't.
  63. Facilities to edit the parameters passed to ChangeFSI are
  64. included in the program:
  65.  
  66. The Icon Bar menu has a new entry called "FSI options".
  67. This leads to a dialogue box with a number of writable
  68. icons where you can enter values to be passed to ChangeFSI.
  69. Entering nothing means disable this option.
  70. Commonly used parameters (i.e. mode, scale_x, scale_y,
  71. gamma correction, sharpening and smoothing) have their own
  72. writable icons. But you can also use ChangeFSI's other
  73. options by writing them in the "Misc options" field. You
  74. have to write them explicitly including the "-", just as
  75. you would when using ChangeFSI from the command line, as
  76. the "Misc options" contents are passed directly to ChangeFSI.
  77. So if you wanted to rotate the image, expand its dynamic
  78. range and apply histogram equalization simply enter
  79.  
  80. -rotate -range -equal
  81.  
  82. in the "Misc options" icon.
  83.  
  84. Clicking on the "save" button saves your current choices.
  85. They're reloaded each time Deep4All is started.
  86.  
  87. MAKE SURE THE OUTPUT IS A SPRITE!
  88.  
  89. ChangeFSI is called in a task window and is thus running
  90. in the background. This might be interesting for RiscPC
  91. users as well as with Deep4All you can convert images
  92. without freezing up the machine (well, the hourglass might
  93. be a bit annoying; but then maybe a future version of
  94. ChangeFSI will contain a switch that disables it ;-) ).
  95. This also means that you can do anything with Deep4All
  96. while the conversion's in process, including loading other
  97. images.
  98. Some care should be taken, though, as <Wimp$Scrap> is used
  99. as transfer file between ChangeFSI and Deep4All. This could
  100. be a problem if you've specified a -max value to ChangeFSI
  101. and some other application needs to access <Wimp$Scrap>.
  102. So avoid application-to-application file transfers during
  103. conversion (RAM transfer is OK).
  104.  
  105.  
  106. Possible errors related to ChangeFSI use:
  107.  
  108. - ChangeFSI hasn't been booted
  109.   The filer hasn't seen ChangeFSI, so Deep4All can't call
  110.   it. Open the directory folder containing ChangeFSI and
  111.   it'll work.
  112.   (Deep4All checks for the presence of the variable
  113.    ChangeFSI$Dir)
  114.  
  115. - ChangeFSI failed
  116.   If ChangeFSI terminates but Deep4All can't find the sprite
  117.   file this error is issued. In most cases the failure is
  118.   due to lack of memory but of course a corrupt file will
  119.   have the same effect. To check you could enter
  120.   -info
  121.   in the "Misc options" icon. That way ChangeFSI will print
  122.   status info about the image and a task window will pop up.
  123.  
  124. - You already have ChangeFSI running a job
  125.   Well... you have, so this asks you if you want to override
  126.   the existing one or cancel your last request. Usually it's
  127.   not a good idea to have more than one running simultaneously
  128.   as Deep4All will only accept input from one which could lead
  129.   to a stray <Wimp$Scrap> file.
  130.   NOTE: if you've started conversion by double clicking and
  131.   cancel your request it gets passed on by the Filer. The most
  132.   common consequence is that ChangeFSI gets loaded and starts
  133.   conversion itself.
  134.  
  135.  
  136.  
  137. 2) Sprite cropping
  138. ------------------
  139.  
  140. It happens from time to time that I get scans with frayed
  141. edges and so forth. I don't want to convert them to 8bpp
  142. sprites and crop them with Paint (also Paint's cropping
  143. is crap!) so I thought it might be a good idea to offer
  144. cropping in Deep4All.
  145.  
  146. To select the area you want to keep drag a frame in the
  147. sprite window (for precision jobs scale the image up).
  148. Everything inside the frame, including its border, will be
  149. kept, the rest is thrown away.
  150.  
  151. As usual you can adjust the frame by dragging with adjust.
  152. A click with select removes the frame.
  153.  
  154. To actually crop simply select "crop" from the sprite menu.
  155.  
  156. Crop can also be used on sprites with a transparency mask :-)
  157.  
  158.  
  159.  
  160. 3) Sprite export
  161. ----------------
  162.  
  163. 1) and especially 2) necessitate 3). 'nuff said, saving
  164. works as usual. RAM transfer also supported.
  165.  
  166.  
  167.  
  168.  
  169. CHANGES SINCE V0.10
  170. ===================
  171.  
  172. Some bug fixes:
  173.  
  174. 1) When cropping new format sprites with less or equal 8bpp
  175.    they ended up with the wrong mode (yes, the reason is
  176.    that I map them internally to old format sprites). Since
  177.    that type of sprite is *very* rare I missed this in 0.10.
  178.  
  179. 2) Adjusted the clipping frame a little. It seemed to be
  180.    about 1 screen pixel off in 0.10.
  181.  
  182. 3) Stumbled accidentally over some 4bpp sprites without a
  183.    palette and had to find out they were rendered completely
  184.    wrong (not my fault but ColourTrans'). Now fixed.
  185.  
  186.  
  187.  
  188. CHANGES SINCE V0.11
  189. ===================
  190.  
  191. Added the "Force Palette" option which allows you to set the
  192. current palette to the one given in the sprite if the current
  193. screenmode has at least as many bpp as the spritemode, which
  194. also has to be <= 8. It's not RISC OS-conformant because when
  195. possible it changes the desktop palette so the rest of your
  196. desktop will usually look rather wild. However if the sprite's
  197. palette was optimised the image will look WAY better so I think
  198. one can live with that; you don't _have_ to use it, after all.
  199. You can sometimes come damn close to 24bpp that way, often better
  200. than 15bpp (since the palette entries are true 24bpp values, not
  201. 15bpp).
  202. If you try this with sprites with 256 palette entries you really
  203. should have a Risc PC or a graphics card (e.g. CCGold) that lets
  204. you program all 256 palette entries rather than only 16 like on
  205. older machines since the result is bound to look horrible
  206. otherwise.
  207. The menu entry for "Force Palette" is greyed out if it's not
  208. available with the current screenmode / sprite combination.
  209. The original palette will be restored if you
  210.  
  211. - Untick the menu entry
  212. - Close the sprite window
  213. - Load a new sprite that doesn't allow palette forcing (with this
  214.   screenmode)
  215. - Quit Deep4All
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222. LEGAL ISSUES
  223. ============
  224.  
  225. This application is Freeware. You may copy it freely
  226. provided no part of it is changed and no money is charged for
  227. the copy, except for a small amount to cover expenses such as
  228. disc cost. I retain the full copyright.
  229.  
  230. I will not accept any responsibility for any kind of
  231. d