home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 14 Text / 14-Text.zip / avcfconv.txt < prev    next >
Text File  |  1994-03-05  |  11KB  |  363 lines
  1. =======================================================================
  2.                     AVC Support for TGA
  3.  
  4.    The AVC will read most TGA images. The AVC will write 3 different
  5. "types" of TGA images.
  6.   ----------------------------------------------------------------------
  7.                           Input Support
  8.  
  9. *  ID Length - Not used, except to skip the Image ID field.
  10.  
  11. *  Color Map Type - Supports both 0 and 1; will only use color-map if
  12.    image is already mapped (not RGB).
  13.  
  14. *  Image Type - Supports 1, 2, 3, 9, 10, 11; 0 is not supported because
  15.    it indicates that no image data is included.
  16.  
  17. *  Color Map Specification:
  18.    .  First Entry Index - Not used.  AVC will use entire map included.
  19.    .  Color-map Length - Supports up to 256.
  20.    .  Color-map Entry Size - Supports 15, 16, 24, and 32.
  21.  
  22. *  Image Specification:
  23.    .  X-origin of Image - Not used.
  24.    .  Y-origin of Image - Not used.
  25.    .  Image Width - AVC image pel width
  26.    .  Image Height - AVC image pel height
  27.    .  Pixel Depth - Supports 8, 16, 24, 32 (where 32 is actually 24).
  28.    .  Image Descriptor - Not used.
  29.  
  30. *  Image ID - Not used.
  31.  
  32. *  Color-Map Data - AVC uses only if the image is mapped.
  33.  
  34. *  Image Data - Start of image data.
  35.  
  36. ------------------------------------------------------------------------
  37.                          Output Support
  38.  
  39. *  ID Length - 0
  40.  
  41. *  Color Map Type - 0 if RGB 16 or RGB24; 1 if Mapped.
  42.  
  43. *  Image Type - 1 if Mapped; 2 if RGB 16 or RGB 24.
  44.  
  45. *  Color Map Specification:
  46.    .  First Entry Index - 0
  47.    .  Color-map Length - 256 if Mapped; 0 if RGB 16 or RGB 24
  48.    .  Color-map Entry Size - 24 if Mapped; 0 if RGB 16 or RGB 24
  49.  
  50. *  Image Specification:
  51.    .  X-origin of Image - 0
  52.    .  Y-origin of Image - 0
  53.    .  Image Width - up to 640
  54.    .  Image Height - up to 480
  55.    .  Pixel Depth - 8 if Mapped; 16 if RGB 16; 24 if RGB 24
  56.    .  Image Descriptor - 0
  57.  
  58. *  Image ID - Not included.
  59.  
  60. *  Color-Map Data - Only included if Mapped, and then in BGR order.
  61.  
  62. *  Image Data - If RGB 16 or RGB 24, in BGR order; if Mapped, map index.
  63.  
  64. =======================================================================
  65.  
  66.                     AVC Support for BMP
  67.  
  68.    The AVC will read a subset of OS/2 BMP images. The AVC will write
  69. two different "types" of OS/2 BMP images.
  70.  
  71. ------------------------------------------------------------------------
  72.                           Input Support
  73.  
  74. *  Type - Type of file. Supports IBM.
  75.  
  76. *  Size - Size of file. Not used.
  77.  
  78. *  X Hotspot - Not Used.
  79.  
  80. *  Y Hotspot - Not Used.
  81.  
  82. *  Data Offset - Must point to image data.
  83.  
  84. *  Info Length - Not Used.
  85.  
  86. *  Image Width - AVC image pel width.
  87.  
  88. *  Image Length - AVC image pel height.
  89.  
  90. *  Planes - Supports 1.
  91.  
  92. *  Bit Count - Supports 1, 4, 8, 24.
  93.  
  94. *  Map - Used if mapped image.
  95.  
  96. ------------------------------------------------------------------------
  97.                          Output Support
  98.  
  99. *  Type - BM.
  100.  
  101. *  Size - Size of file.
  102.  
  103. *  X Hotspot - 0.
  104.  
  105. *  Y Hotspot - 0.
  106.  
  107. *  Data Offset - Points to Image Data.
  108.  
  109. *  Info Length - 0x0C.
  110.  
  111. *  Image Width - Up to 640.
  112.  
  113. *  Image Length - Up to 480.
  114.  
  115. *  Planes - 1.
  116.  
  117. *  Bit Count - 4 or 8 if Mapped; 24 if RGB 24.
  118.  
  119. *  Map - Used if mapped image.
  120. =======================================================================
  121.  
  122.                     AVC Support for TIFF
  123.  
  124. AVC supports a subset of the TIFF Specification Revision 5.0 (Final).
  125. The AVC will read a wide range of TIFF images, including Intel and
  126. Motorola formats. The AVC will write three different "types"
  127. of TIFF images, all in Intel format.
  128.  
  129. ------------------------------------------------------------------------
  130.                           Input Support
  131.  
  132. General
  133. *  File Format - Intel and Motorola formats.
  134.  
  135. *  TIFF version number - 0x002a (required).
  136.  
  137. *  For fields where both short and long values are permitted, AVC
  138.    supports both types.
  139.  
  140. Basic Fields
  141. *  BitsPerSample (258) - Default 1. Supports 1,4,8,(5,6,5),(8,8,8).
  142.    Other values are not supported.
  143.  
  144. *  ColorMap (320) - AVC Supports.
  145.  
  146. *  ColorResponseCurves (301) - AVC Ignores.
  147.  
  148. *  Compression (259) - Default 1. Supports 1,2,3,4. LZW and
  149.    Packbits are not supported.
  150.  
  151. *  GrayResponseCurve (291) - AVC Ignores.
  152.  
  153. *  GrayResponseUnit (290) - AVC Ignores.
  154.  
  155. *  ImageLength (257) - Supports input of <= 0xFFFF. AVC sizing
  156.    routines may limit further.
  157.  
  158. *  ImageWidth (256) - Supports input of <= 0xFFFF. AVC sizing
  159.    routines may limit further: BW-4800, Grayscale-3200, RGB-3200.
  160.  
  161. *  NewSubfileTypes (254) - Default 0. AVC Ignores.
  162.  
  163. *  PhotometricInterpretation (262) - Default 1. Supports 0,1,2,3.
  164.    0 and 1 are treated equally. Transparency mask not supported.
  165.  
  166. *  PlanarConfiguration (284) - Default 1. Supports 1. Separate sample
  167.    planes are not supported.
  168.  
  169. *  Predictor (317) - Default 1. AVC Ignores.
  170.  
  171. *  ResolutionUnit (296) - Default 2. AVC Ignores.
  172.  
  173. *  RowsPerStrip (278) - AVC Ignores.
  174.  
  175. *  SamplesPerPixel (277) - Default 1. Supports 1,3.
  176.  
  177. *  StripByteCounts (279) - AVC Ignores.
  178.  
  179. *  StripOffsets (273) - AVC requires. Supports only 1 strip.
  180.  
  181. *  XResolution (282) - Default 1.
  182.  
  183. *  YResolution (283) - Default 1.
  184.  
  185. Informational Fields
  186. *  Artist (315) - AVC Ignores.
  187.  
  188. *  DateTime (306) - AVC Ignores.
  189.  
  190. *  HostComputer (316) - AVC Ignores.
  191.  
  192. *  ImageDescription (270) - AVC Ignores.
  193.  
  194. *  Make (271) - AVC Ignores
  195.  
  196. *  Model (272) - AVC Ignores.
  197.  
  198. *  Software (305) - AVC Ignores.
  199.  
  200. Facsimile
  201. *  Compression (259) - See Basic Fields, Compression (259).
  202.  
  203. *  Group3Options (292) - AVC Ignores.
  204.  
  205. *  Group4Options (293) - AVC Ignores.
  206.  
  207. Document Storage and Retrieval Fields
  208. *  DocumentName (269) - AVC Ignores.
  209.  
  210. *  PageName (285) - AVC Ignores.
  211.  
  212. *  PageNumber (297) - AVC Ignores.
  213.  
  214. *  XPosition (286) - Default 0.
  215.  
  216. *  YPosition (287) - Default 0.
  217.  
  218. No Longer Recommended Fields
  219. *  CellLength (265) - AVC Ignores.
  220.  
  221. *  CellWidth (264) - AVC Ignores.
  222.  
  223. *  FillOrder (266) - AVC Ignores.
  224.  
  225. *  FreeByteCounts (289) - AVC Ignores.
  226.  
  227. *  FreeOffsets (288) - AVC Ignores.
  228.  
  229. *  MaxSampleValue (281) - Default 0.
  230.  
  231. *  MinSampleValue (280) - Default 0.
  232.  
  233. *  SubfileType (255) - AVC Ignores.
  234.  
  235. *  Orientation (274) - AVC Ignores.
  236.  
  237. *  Thresholding (263) - AVC Ignores.
  238.  
  239. ------------------------------------------------------------------------
  240.                          Output Support
  241.  
  242. General
  243. *  File Format - Intel Format
  244.  
  245. *  TIFF version number - 0x002a (required).
  246.  
  247. *  Output is one of three types:
  248.    .  Mapped
  249.    .  RGB 565
  250.    .  RGB 888
  251.  
  252. *  Basic Fields:
  253.    .  BitsPerSample (258) - Mapped - 4,8; RGB 565 - 5,6,5;
  254.       RGB 888 - 8,8,8
  255.    .  ColorMap (320) - Mapped only.
  256.    .  Compression (259) - No Compression - 1.
  257.    .  Image Length (256) - up to 640.
  258.    .  NewSubfileTye (254) - Output with no data.
  259.    .  PhotometricInterpretation (262) - Mapped - 3; RGB - 2.
  260.    .  PlanarConfiguration (284) - RGB format - 1.
  261.    .  ResolutionUnit (296) Inch - 2.
  262.    .  RowsPerStrip (278) - ImageLength.
  263.    .  SamplesPerPixel (277) - Mapped - 1; RGB - 3.
  264.    .  StripByteCounts (279) - ImageWidth x ImageLength.
  265.    .  StripOffsets (273) - AVC supports only 1 strip.
  266.    .  XResolution (282) - X Aspect Ratio.
  267.    .  YResolution (283) - Y Aspect Ratio.
  268. =======================================================================
  269.  
  270.                     AVC Support for IOCA 6.0
  271.  
  272.    AVC supports a subset of the IOCA Specification Revision 6.0 (Final).
  273. The AVC will read a wide range of IOCA images.  The AVC will write two
  274. different "types" of IOCA images.
  275.  
  276. Note: 0x00 represents hexadecimal 00.
  277. ------------------------------------------------------------------------
  278.                           Input Support
  279.  
  280. *  Begin Segment Name - optional.  AVC does not use this.
  281.  
  282. *  Begin Image Content
  283.    .  IOCA image object - 0xFF IOCA (required)
  284.  
  285. *  Image Size Parameter
  286.    .  Unit base - Supports 0x00, 0x01, 0x02.  Used to convert horizontal
  287.       and vertical resolution to AVC x and y aspect ratios.
  288.    .  Horizontal resolution - Converted to AVC image x aspect ratio.
  289.    .  Vertical resolution - Converted to AVC image y aspect ratio.
  290.    .  Horizontal resolution - AVC image pel width.
  291.    .  Vertical size - AVC image pel height.
  292.  
  293. *  Image Encoding Parameter
  294.    .  Compression Algorithm - Default 0x03 No compression.  Supports
  295.       0x01 IBM MMR and 0x03 No compression.  Other compressions not
  296.       supported.
  297.    .  Recording Algorithm - Default 0x01 RIDIC.  Supports 0x01 RIDIC.
  298.       All other values not supported.
  299.  
  300. *  Image IDE Size Parameter
  301.    .  Bits per IDE - Default 1 bit.  Supports 1, 8, 16, 24.  Does not
  302.       support 4-bit.  If RGB color format specified, only supports
  303.       16 and 24 bits.
  304.  
  305. *  Image LUT-ID Parameter
  306.    .  Look-up Table ID - AVC does not do anything with this parameter.
  307.       It does not support mapped IOCA images, because the map is not
  308.       included with the image.
  309.  
  310. *  IDE Structure Parameter
  311.    .  Additive or Subtractive - 0x00 Additive.  No others supported.
  312.    .  Color format - Default 00x00 BW.  Supports 0x00 BW, 0x01 RGB,
  313.       and 0x02 Grayscale.  No others are supported.
  314.    .  Number of bits for Element 1 - Default 1
  315.    .  Number of bits for Element 2 - Default 0
  316.    .  Number of bits for Element 3 - Default 0
  317.  
  318. *  End Image Content
  319.  
  320. *  End Segment
  321.  
  322. ------------------------------------------------------------------------
  323.                          Output Support
  324.  
  325. *  Begin Segment
  326.    .  Image Segment Name - not specidied; length 0x00.
  327.  
  328. *  Begin Image Content
  329.    .  IOCA image object - 0xFF IOCA (required).
  330.  
  331. *  Image Size Parameter
  332.    .  Unit base - 0x00 ten inches
  333.    .  Horizontal resolution - AVC image (x aspect ratio) X (10).
  334.    .  Vertical resolution - AVC image (y aspect ratio) X (10).
  335.    .  Horizontal resolution - AVC image pel width.
  336.    .  Vertical size - AVC image pel height.
  337.  
  338. *  Image Encoding Parameter
  339.    .  Compression Algorithm - 0x03 no compression.
  340.    .  Recording Algorithm - 0x01 RIDIC.
  341.  
  342. *  Image IDE Size Parameter
  343.    .  Bits per IDE - 16 or 24, depending on RGB 5:6:5 or RGB 8:8:8
  344.       selected.
  345.  
  346. *  Image LUT-ID Parameter
  347.    .  Look-Up Table ID - 0x00 no look-up table.
  348.  
  349. *  IDE Structure Parameter
  350.    .  Additive or Subtractive - 0x00 additive
  351.    .  Color format - 0x01 RGB.
  352.    .  Number of bits for Element 1-5 or 8, depending on RGB 5:6:5 or
  353.       RGB 8:8:8 selected.
  354.    .  Number of bits for Element 2-6 or 8, depending on RGB 5:6:5 or
  355.       RGB 8:8:8 selected.
  356.    .  Number of bits for Element 3-5 or 8, depending on RGB 5:6:5 or
  357.       RGB 8:8:8 selected.
  358.  
  359. *  End Image Content
  360.  
  361. *  End Segment
  362. =======================================================================
  363.