home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 110 / af110sub.adf / datatypes.lzx / RGFX-DT / RGFX-DT.doc < prev    next >
Text File  |  2012-01-08  |  5KB  |  185 lines
  1. Documentation of rgfx.datatype 43.2
  2. -----------------------------------
  3.  
  4.  
  5. Copyright
  6. ---------
  7.  
  8. The IFF-RGFX format is copyright by Andreas Kleinert
  9.  
  10. The rgfx.datatype 43.x and the converter DT2RGFX is copyright by Achim Stegemann.
  11.  
  12. This archive is Freeware !
  13. Do with it what you want, as long as you do not remove any files from this archive !
  14.  
  15.  
  16. Introduction
  17. ------------
  18.  
  19. With the help of the rgfx.datatype, your datatype sytem is able to read images
  20. coded in the new IFF-RGFX-Format created by Andreas Kleinert.
  21.  
  22. A converter called DT2RGFX is included in the C-drawer.
  23.  
  24.  
  25. Requirements for rgfx.datatype
  26. ------------------------------
  27.  
  28. * OS 3.x
  29. * MC68020 or better
  30.  
  31.  
  32. Additionally recommened
  33. -----------------------
  34.  
  35.  * xpkmaster.library for Xpk compressed files (usually they are !).
  36.  * render.library for color reduction for non-CGX users (AGA modes).
  37.  * CyberGraphX with picture.datatype V43.x for 24-bit images.
  38.  
  39. AGA-only users MUST have installed the render.library.
  40. CGX users MUST either have installed picture.datatype V43.x and/or the render.library.
  41.  
  42. The render.library is available on Aminet:dev/misc.
  43.  
  44.  
  45. Requirements for RGFXPrefs
  46. --------------------------
  47.  
  48. * OS 3.x
  49. * MC68020 or better
  50. * MUI 3.x
  51.  
  52.  
  53. Requirements for DT2RGFX
  54. ------------------------
  55.  
  56. * OS 3.x
  57. * MC68020 or better
  58.  
  59. Additionally recommended
  60. -------------------------
  61.  
  62. * xpkmaster.library for Xpk compression.
  63.  
  64.  
  65. Installation
  66. ------------
  67.  
  68. Simply click on the 'Install' script.
  69.  
  70.  
  71. The DT2RGFX Utility
  72. -------------------
  73.  
  74. With this utility, you can convert any image you have a datatype for, to the new
  75. IFF-RGFX format.
  76. It is CLI-only !!
  77.  
  78. Template: DT2RGFX FROM/A,TO/A,XPK/K,PLANAR/S,VERBOSE/S
  79.  
  80. FROM:    The filename of the source image.
  81. TO:      The destination filename.
  82. XPK:     The ID of an XPK-Packer. For example XPK NUKE.
  83.          The picture will only compressed when you specify a packer !!
  84. MODE:    The compression value. Default is 100 (best compression)
  85. PLANAR:  Save the picture in planar mode.
  86.          Default is chunky mode.
  87.          24-Bit images will always be saved in chunky mode !!
  88. VERBOSE: Verbose mode. Print some information while converting.
  89.  
  90.  
  91. Preferences for the rgfx.datatype
  92. ---------------------------------
  93.  
  94. Mode:
  95.  -> V43 CGX Mode
  96.     Enables V43 CyberGraphX mode.
  97.     If you do not have the picture.datatype 43.x, the datatype will fall back to V40 mode.
  98.  -> V40 AGA Mode
  99.     Truecolor images will be color reduced for AGA.
  100.     You must have installed the render.library !
  101.  
  102. V40 Depth:
  103. Depth to use for color reducing in AGA modes.
  104. Values are from 3 to 8 (default).
  105.  
  106. Dither Mode:
  107. Enables Floyd-Steinberg dithering (recommended).
  108. Default is 'No dithering'.
  109.  
  110. Currently I only support MUI for the preferences.
  111. If you don't have MUI, you also can adjust the preferences very easy.
  112. The ENV-variable 'DataTypes/pcd.prefs' contains the parameter as a DOS-argument
  113. with the template 'MODE/N,DEPTH/N,FS/S'.
  114. You can change the settings anytime either by using the 'SetEnv'-command or by
  115. using a text editor.
  116. A GadTools version of the preferences may follow in the near future.
  117.  
  118.  
  119. Bugs and Known Problems
  120. -----------------------
  121.  
  122. The rgfx.datatype and the converter were tested successfully with all kinds of pictures
  123. and compression types. Even with no CyberGraphX being installed, the datatype and the
  124. converter worked without any problems.
  125.  
  126. As old EHB pictures are no more used, I couldn't verify this, although it should work.
  127.  
  128. There are some corrupt pixels when handling HAM pictures in planar mode
  129. with Xpk compression. I don't know whether this bug comes from the converter
  130. or the datatype, because normal AGA pictures are handled correctly !
  131.  
  132.  
  133. Future of RGFX
  134. --------------
  135.  
  136. That depends on how Amiga users accept the new graphic file format !
  137. I myself liked it from the very first moment, because the ILBM format is neither
  138. able to produce good compressed files, nor it can handle all those different
  139. screen types that exist today.
  140.  
  141. GIVE IFF-RGFX A CHANCE AND SUPPORT IT AS OFTEN AS YOU CAN !!
  142.  
  143. Currently (as much as I know), the IFF-RGFX format is supported in:
  144. * SViewNG V7.30+ from Andreas Kleinert
  145. * Digital Almanac V39.9+ from myself.
  146.  
  147.  
  148. History
  149. -------
  150.  
  151. 03-Dec-97  V43.0
  152.    * First public release.
  153.  
  154. 04-Dec-97  V43.1
  155.    * Improved planar handling in the converter and the datatype.
  156.    * Datatype has now full error handling.
  157.  
  158. 03-Mar-98  V43.2
  159.     * Datatype is now able to reduce colors of 24-bit images with the render.library.
  160.    * Added MUI preferences (no GadTools version, I'm too lazy for it).
  161.    * Added NewIcons to the archive.
  162.  
  163.  
  164. Credits
  165. -------
  166.  
  167. Andreas Kleinert for his support with IFF-RGFX.
  168. Timm S. Müller for the render.library.
  169.  
  170.  
  171. Author
  172. ------
  173.  
  174. Feel free to contact me.
  175. Comments, critics, supports, bug reports are welcome !
  176.  
  177. Name:     Achim Stegemann
  178. Email:    astegema@ix.urz.uni-heidelberg.de
  179. Internet: http://www.rzuser.uni-heidelberg.de/~astegema/projects.html#rgfx
  180.  
  181. If you have question about the IFF-RGFX format, contact Andreas Kleinert.
  182. Email:  Andreas_Kleinert@t-online.de
  183. Aminet: dev/misc/IFF-RGFX.lha
  184.  
  185.