home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / gbmos2pm.zip / gbmdlg / gbmdlg.scr < prev    next >
Text File  |  1997-01-26  |  35KB  |  745 lines
  1. .*
  2. .* gbmdlg.scr - Help for Gbm file formats dialog
  3. .*
  4. .* Important: Only edit the original .SCR file.
  5. .* If this file is not by the filename given above, then it has been put
  6. .* through IPFCPREP and so will be regenerated next MAKE.
  7. .*
  8. .imd gbmdlgrc.h
  9. .*...vgbmdlgrc\46\h:0:
  10. :userdoc.
  11. .*...sprolog:0:
  12. :prolog.
  13. :title.GbmDlg Help
  14. :author.Andy Key
  15. :eprolog.
  16. .*...e
  17. :toc.
  18. :body.
  19. .*...sHID_GBM_FILEDLG   \45\ Bitmap File dialog:0:
  20. :h1 res=&HID_GBM_FILEDLG..Bitmap File dialog
  21. :i1 id=gbmfile.Bitmap File dialog
  22. :p.This dialog allows you to load a bitmap from a file, or save a bitmap to
  23. a file.
  24. Filenames and directories may be selected from the listboxes via the
  25. keyboard or the mouse, just like in any other File dialog.
  26. :p.You can handle bitmap files of a variety of different formats.
  27. For example,  OS/2 Bitmaps, CompuServe GIF files, ZSoft PCX files
  28. and many others.
  29. :p.To see an extensive list of the level of support for the various
  30. bitmap formats, and the format specific options available in each, see the
  31. :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  32. section of this help.
  33. :p.You can select which files are listed in the files listbox using the
  34. :hp2.Bitmap filetype filter:ehp2. combo box.
  35. You can pick, :hp2.<All files>:ehp2.,
  36. :hp2.<All GBM supported files>:ehp2. and various :hp2.<Format>:ehp2.s.
  37. :p.The program will look at the :hp2.file extension:ehp2. and determine
  38. the format of the file and use the relevant bitmap file handling code.
  39. :p.The :hp2.Optional bitmap format specific options:ehp2. field allows you
  40. to specify a string which is used to give hints to the relevant bitmap file
  41. handling code. For example, you can tell the GIF file reader to ignore
  42. corrupt data and return how far it got by giving the ":hp9.errok:ehp9."
  43. option.
  44. .*...e
  45. .*...sHID_GBM_SUPPORT   \45\ Bitmap file format support:0:
  46. :h1 res=&HID_GBM_SUPPORT..Bitmap file format support
  47. :i1 id=gbmsupp.Bitmap file format support
  48. :p.This program uses the :hp2.Generalised Bitmap Module:ehp2..
  49. This peice of code can read and write a variety of bitmap formats.
  50. The application program is unaware of the file format of any bitmaps, and
  51. is just presented with the bitmap data in a single standard way.
  52. :p.Some bitmap formats allow additional :hp2.options:ehp2. to be supplied
  53. and these options are listed highlighted like :hp9.this:ehp9..
  54. :p.This section fully defines the level of support &colon.-
  55. :p.
  56. Formats supported are &colon.
  57. :sl.
  58. :li.:link reftype=hd res=&HID_GBM_BITMAP..OS/2 / Windows Bitmap:elink.
  59. :li.:link reftype=hd res=&HID_GBM_GIF..CompuServe Graphics Interchange Format:elink.
  60. :li.:link reftype=hd res=&HID_GBM_PCX..ZSoft PC Paintbrush Image Format:elink.
  61. :li.:link reftype=hd res=&HID_GBM_TIFF..Microsoft/Aldus Tagged Image File Format:elink.
  62. :li.:link reftype=hd res=&HID_GBM_TARGA..Truevision Targa/Vista:elink.
  63. :li.:link reftype=hd res=&HID_GBM_ILBM..Amiga IFF / ILBM Interleaved bitmap format:elink.
  64. :li.:link reftype=hd res=&HID_GBM_YUV12C..YUV12C M-Motion Frame Buffer:elink.
  65. :li.:link reftype=hd res=&HID_GBM_GREYMAP..Portable Greyscale-map:elink.
  66. :li.:link reftype=hd res=&HID_GBM_PIXMAP..Portable Pixel-map:elink.
  67. :li.:link reftype=hd res=&HID_GBM_KIPS..IBM KIPS:elink.
  68. :li.:link reftype=hd res=&HID_GBM_IAX..IBM Image Access eXecutive:elink.
  69. :li.:link reftype=hd res=&HID_GBM_XBITMAP..X Windows bitmap:elink.
  70. :li.:link reftype=hd res=&HID_GBM_SPRITE..RiscOS Sprite:elink.
  71. :li.:link reftype=hd res=&HID_GBM_PSEG..IBM Printer Page Segment:elink.
  72. :li.:link reftype=hd res=&HID_GBM_GEMRAS..GEM Raster:elink.
  73. :li.:link reftype=hd res=&HID_GBM_PORTRAIT..Portrait:elink.
  74. :li.:link reftype=hd res=&HID_GBM_JPEG..JPEG:elink.
  75. :li.:link reftype=hd res=&HID_GBM_OTHERS..Others:elink.
  76. :esl.
  77. :p.The :link reftype=hd res=&HID_GBM_FILEDLG..Bitmap File Dialog:elink.
  78. can handle bitmaps in any of the formats documented above.
  79. .*...e
  80. .*...sHID_GBM_BITMAP    \45\   OS\47\2 \47\ Windows bitmap:0:
  81. :h2 res=&HID_GBM_BITMAP..OS/2 / Windows bitmap
  82. :i2 refid=gbmsupp.OS/2 / Windows bitmap
  83. :p.The following file extensions
  84. :xmp.
  85.   .BMP .VGA .BGA .RLE .DIB .RL4 .RL8
  86. :exmp.
  87. :p.are recognised as OS/2 1.1, 1.2, 2.0 or Windows 3.0 bitmaps.
  88. :p.:hp2.Input:ehp2.
  89. :p.The bitmap support will read any of the above if uncompressed or
  90. run-length compressed.
  91. :p.CCITT G3 MH Fax compressed files, or RLE24 compressed files can't be read.
  92. :dl compact tsize=7 break=all.
  93. :dt.:hp9.index=N:ehp9.
  94. :dd.Can be used if the file is an OS/2 bitmap-array file to specify which
  95. bitmap in the array to read (default N=0 - the first in the array).
  96. :dt.:hp9.inv:ehp9.
  97. :dd.Causes the palette to get inverted after reading.
  98. Provided to allow for inconsistencies between Windows and OS/2 programs in
  99. how the palette of 1bpp files should be interpreted.
  100. :dt.:hp9.invb:ehp9.
  101. :dd.Causes the bitmap bits to get inverted after reading.
  102. :edl.
  103. :p.:hp2.Output:ehp2.
  104. :p.The this module can write both OS/2 1.1 and OS/2 2.0 / Windows 3.0 style
  105. bitmaps.
  106. :p.By default OS/2 2.0 or Windows 3.0 bitmaps are written.
  107. :p.The OS/2 2.0 / Windows 3.0 style of bitmaps written are written with a
  108. header size (cbFix) of 40, which is compatible with both Windows 3.0 and
  109. OS/2 2.0.
  110. :dl compact tsize=7 break=all.
  111. :dt.:hp9.1.1:ehp9.
  112. :dd.Causes the bitmap to be written OS/2 1.1 style.
  113. :dt.:hp9.2.0:ehp9. or :hp9.win:ehp9.
  114. :dd.Causes the bitmap to be written OS/2 2.0 / Windows 3.0 style.
  115. :dt.:hp9.inv:ehp9.
  116. :dd.Causes the palette to get inverted before written.
  117. Provided to allow for inconsistencies between Windows and OS/2 programs in
  118. how the palette of 1bpp files should be interpreted.
  119. :dt.:hp9.invb:ehp9.
  120. :dd.Causes the bitmap bits to get inverted before written.
  121. :dt.:hp9.darkfg:ehp9.
  122. :dd.This is probably the best option to use when writing 1bpp bitmaps.
  123. It ensures that the darkest colour is represented in the file as 1's
  124. (and is therefore the foreground), and when the bitmap is reloaded, this
  125. will come out black.
  126. :dt.:hp9.lightfg:ehp9.
  127. :dd.As darkfg, but the lightest colour is stored as 1's.
  128. :edl.
  129. :p.The newer MultiMedia Windows bitmap format that allows 16 and 32 bpp
  130. support is not currently supported.
  131. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  132. help panel lists other supported file formats.
  133. .*...e
  134. .*...sHID_GBM_GIF       \45\   CompuServe Graphics Interchange Format:0:
  135. :h2 res=&HID_GBM_GIF..CompuServe Graphics Interchange Format
  136. :i2 refid=gbmsupp.CompuServe Graphics Interchange Format
  137. :p.The :hp2..GIF:ehp2. file extension is recognised as a GIF file.
  138. :p.:hp2.Input:ehp2.
  139. :p.1 bpp GIF files are read as 1 bpp data.
  140. :p.2, 3 and 4 bit GIF files are read and returned as 4 bpp data.
  141. :p.5, 6, 7 and 8 bit GIF files are read and returned as 8 bpp data.
  142. :p.GIF files provide no support for 24 bpp images.
  143. :p.Both :hp2.GIF87a:ehp2. and :hp2.GIF89a:ehp2. level files may be read.
  144. :p.The code will correctly handle deferred clear-codes in the LZW data
  145. stream.
  146. Files with these often break earlier programs that claim to load GIF files.
  147. :dl compact tsize=7 break=all.
  148. :dt.:hp9.index=N:ehp9.
  149. :dd.Can be used to specify which image in the GIF file to read (default N=0).
  150. :dt.:hp9.errok:ehp9.
  151. :dd.If a corrupted or truncated GIF file is encountered, normally an error
  152. is returned.
  153. With this option, as much data as was decoded before the error is returned,
  154. and no error occurs.
  155. :edl.
  156. :p.:hp2.Output:ehp2.
  157. :p.The :hp2.GIF87a:ehp2. style of GIF files are written, and since the
  158. GIF standard is backwardly compatible, all programs that claim to load GIF
  159. files should handle the output generated by this program.
  160. :p.The exception to this is that if the :hp2.transcol:ehp2. option is used
  161. a :hp2.GIF89a:ehp2. style file will be written.
  162. :p.This program does not generate GIF files with deferred-clear-codes, as
  163. these have been shown to break many older GIF readers.
  164. :dl compact tsize=7 break=all.
  165. :dt.:hp9.xscreen=N:ehp9.,:hp9.yscreen=N:ehp9.
  166. :dd.Specifies what values to put in these fields of the GIF file header.
  167. The default is the image size.
  168. :dt.:hp9.background=N:ehp9.
  169. :dd.Specifies what background colour index to write in the GIF file header.
  170. The default is 0.
  171. :dt.:hp9.xpos=N:ehp9.,:hp9.ypos=N:ehp9.
  172. :dd.Specifies what values to put in these fields in the GIF file header.
  173. The defaults are 0 and 0.
  174. :dt.:hp9.transcol=N:ehp9.
  175. :dd.Specifies that index N designates a transparent colour.
  176. This option is useful for when you wish to embed GIF files in HTML documents.
  177. Using this option causes a GIF89a file to be written because the
  178. Graphics Extension Block holding the transparency information is a part of
  179. the GIF89a spec., and not the GIF87a.
  180. :dt.:hp9.transcol=edge:ehp9.
  181. :dd.As above, except transparent colour is the colour of the first pixel
  182. in the bitmap.
  183. :dt.:hp9.ilace:ehp9.
  184. :dd.Causes the GIF file to be written interlaced, which can be good for those
  185. GIF files referenced from HTML documents.
  186. :edl.
  187. :p.This code correctly handles 1bpp GIF files.
  188. Some programs make incorrect assumptions about the initial LZW code table size
  189. in the 1bpp case, and so fall over.
  190. UBU is/was guilty of this.
  191. :p.This code has been tested on a wide selection of files from a wide
  192. variety of sources.
  193. It has been tested against the output of public domain PPMTOGIF.EXE,
  194. and tested for compatibility with UNIX X Windows xloadimage and xv.
  195. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  196. help panel lists other supported file formats.
  197. :p.GIF and 'Graphics Interchange Format' are trademarks (tm) of
  198. Compuserve, Incorporated, an H&.R Block Company.
  199. .*...e
  200. .*...sHID_GBM_PCX       \45\   ZSoft PC Paintbrush Image Format:0:
  201. :h2 res=&HID_GBM_PCX..ZSoft PC Paintbrush Image Format
  202. :i2 refid=gbmsupp.ZSoft PC Paintbrush Image Format
  203. :p.The :hp2..PCX:ehp2. and :hp2..PCC:ehp2. file extensions are recognised as
  204. a Paintbrush file.
  205. :p.Only a subset of the possible planes/bits-per-plane combinations are
  206. supported.
  207. :p.:hp2.Input:ehp2.
  208. :p.This program reads 1,4,8 and 24 bpp files.
  209. :p.The run-length encoding scheme is supported.
  210. :p.Compressed runs of pixels are not supposed to straddle scan lines.
  211. Some other applications violate this rule.
  212. By default, if this code finds that a run of pixels is longer than the scan
  213. line, it will use the leftover pixels on the next scan line.
  214. Some images will not load properly, as they require the loading
  215. program to discard those pixels in the run that extend beyond the end
  216. of the scan line.
  217. This behaviour can be enabled using the :hp9.trunc:ehp9. option.
  218. :p.:hp2.Output:ehp2.
  219. :p.This program writes 1,4,8 and 24 bpp files, using run-length compression.
  220. :p.It will always ensure run-lengths of pixels do not straddle scan lines.
  221. :p.This code has been tested on some PC Paintbrush originated .PCX files.
  222. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  223. help panel lists other supported file formats.
  224. .*...e
  225. .*...sHID_GBM_TIFF      \45\   Microsoft\47\Aldus Tagged Image File Format:0:
  226. :h2 res=&HID_GBM_TIFF..Microsoft/Aldus Tagged Image File Format
  227. :i2 refid=gbmsupp.Microsoft/Aldus Tagged Image File Format
  228. :p.The :hp2..TIF:ehp2. and :hp2..TIFF:ehp2. file extensions are
  229. recognised as TIFF files.
  230. :p.There is support to handle 1,4,8 and 24 bpp files.
  231. :p.:hp2.Input:ehp2.
  232. :p.This program reads uncompressed, Packbits and LZW compressed files.
  233. :p.This code will read all Baseline TIFF 6.0 files, except CCITT Modified
  234. Huffman encoded bi-level files.
  235. :dl compact tsize=7 break=all.
  236. :dt.:hp9.index=N:ehp9.
  237. :dd.Can be used if the file contains more than one image to specify which
  238. image to read (default N=0 - the first).
  239. :edl.
  240. :p.:hp2.Output:ehp2.
  241. :p.This program usually writes uncompressed data.
  242. :p.Data are written in a single large strip.
  243. :p.Files written by this code are Baseline TIFF 6.0 compliant.
  244. :dl compact tsize=7 break=all.
  245. :dt.:hp9.artist=TEXT:ehp9.
  246. :dd.Causes an :hp2.Artist:ehp2. tag to be added with text TEXT.
  247. :dt.:hp9.lzw:ehp9.
  248. :dd.Asks GBM to use LZW compression.
  249. :dt.:hp9.software=TEXT:ehp9.
  250. :dd.Causes the :hp2.Software:ehp2. tag to be added with text TEXT.
  251. :dt.:hp9.make=TEXT:ehp9.
  252. :dd.Causes the :hp2.Make:ehp2. tag to be added with text TEXT.
  253. :dt.:hp9.model=TEXT:ehp9.
  254. :dd.Causes the :hp2.Model:ehp2. tag to be added with text TEXT.
  255. :dt.:hp9.host=TEXT:ehp9.
  256. :dd.Causes the :hp2.Host:ehp2. tag to be added with text TEXT.
  257. :dt.:hp9.documentname=TEXT:ehp9.
  258. :dd.Causes the :hp2.DocumentName:ehp2. tag to be added with text TEXT.
  259. :dt.:hp9.pagename=TEXT:ehp9.
  260. :dd.Causes the :hp2.PageName:ehp2. tag to be added with text TEXT.
  261. :dt.:hp9.imagedescription=TEXT:ehp9.
  262. :dd.Causes the :hp2.ImageDescription:ehp2. tag to be added with text TEXT.
  263. :dt.:hp9.pal1bpp:ehp9.
  264. :dd.Causes 1 bpp data to be written as a palettised file, with 2 palette
  265. entries.
  266. Technically this is not TIFF 6.0 Baseline compliant.
  267. The default is to write out a bi-level file with the brightest colour as
  268. white.
  269. This is Baseline compliant.
  270. :edl.
  271. :p.The TEXT should not include spaces.
  272. :p.There are 2 well known corruptions of the TIFF format.
  273. :p.Some TIFF writers write the ColorMap tags length to be 2^N, whereas it
  274. should be 3*2^N.
  275. This code will detect this tag having a bad length, and correct for it
  276. transparently.
  277. UBU is/was guilty of this.
  278. :p.Some TIFF readers/writers believe that ColorMap entrys are bytes.
  279. In fact they are words.
  280. When reading TIFF files, if this code finds that all the palette entrys
  281. are in the range 0-255, as opposed to 0-65535, then it multiplys them all
  282. by 256, thus transparently overcoming the problem.
  283. When writing TIFF files, this code writes the 8 bit palette entry in both
  284. the low and high bytes of the tag.
  285. Thus programs that look at the high byte work fine.
  286. Programs that use the full word work fine (the colours get 0.5% brighter).
  287. Programs that incorrectly look at the bottom byte work fine too.
  288. At least one version of Image Support is/was guilty of this.
  289. :p.JPEG compressed data, and data in the Y-Cb-Cr colour space is not supported.
  290. :p.CCITT G3 Modified Huffman / Facsimile compressed data is not supported.
  291. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  292. help panel lists other supported file formats.
  293. .*...e
  294. .*...sHID_GBM_TARGA     \45\   Truevision Targa\47\Vista bitmap:0:
  295. :h2 res=&HID_GBM_TARGA..Truevision Targa/Vista bitmap
  296. :i2 refid=gbmsupp.Truevision Targa/Vista bitmap
  297. :p.The following file extensions
  298. :xmp.
  299.   .TGA .VST .AFI
  300. :exmp.
  301. :p.are recognised as Targa/Vista files.
  302. :p.This code can read the uncompressed or run-length compressed Targa/Vista
  303. formats.
  304. It will write uncompressed files.
  305. :p.This code only supports 8 bpp and 24 bpp images.
  306. :p.:hp2.Input:ehp2.
  307. :p.This code will read files with both top-left-origin and bottom-left-origin.
  308. Not all Targa readers correctly handle bottom-left-origin files.
  309. :p.When reading 16 bpp files (which are 5 red + 5 green + 5 blue + 1 alpha),
  310. they are loaded and presented as 24 bpp bitmaps with only the top 5 bits of
  311. each of the 8 bit bytes valid.
  312. The bottom 3 bits are zero.
  313. :p.When reading 32 bpp files (which are 8 red + 8 green + 8 blue + 8 alpha),
  314. the alpha channel is ignored.
  315. :p.:hp2.Output:ehp2.
  316. :dl compact tsize=7 break=all.
  317. :dt.:hp9.yup:ehp9. and :hp9.ydown:ehp9.
  318. :dd.Causes the data to be written in bottom-left-origin or top-left-origin
  319. form. The default is bottom-left-origin.
  320. :dt.:hp9.16:ehp9.
  321. :dd.If the data is 24 bpp, then the 16 flag causes only the most significant
  322. 5 bits of the red, green and blue to be written in a 16 bit pixel.
  323. :dt.:hp9.24:ehp9.
  324. :dd.Has no effect, as this is the default.
  325. :dt.:hp9.32:ehp9.
  326. :dd.If the data is 24 bpp, then the 32 flag causes the data to be padded with
  327. 8 zero bits of alpha channel to make a 32 bit pixel.
  328. :edl.
  329. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  330. help panel lists other supported file formats.
  331. .*...e
  332. .*...sHID_GBM_ILBM      \45\   Amiga IFF \47\ ILBM Interleaved bitmap format:0:
  333. :h2 res=&HID_GBM_ILBM..Amiga IFF / ILBM Interleaved bitmap format
  334. :i2 refid=gbmsupp.Amiga IFF / ILBM Interleaved bitmap format
  335. :p.The following file extensions
  336. :xmp.
  337.   .IFF .LBM
  338. :exmp.
  339. :p.are recognised as interleaved bitmap files.
  340. :p.Normally ILBM files are 1,2,3,4 or 5 bpp,
  341. because the early Amigas supported upto 32 colours at once.
  342. 6,7, 8 and 24 bpp files are also found nowadays too.
  343. :p.:hp2.Extra-HalfBrite:ehp2., or :hp2.EHB:ehp2. is a mode where N
  344. colours have palette entries, but the file may contain 2*N colours.
  345. The second set of N colours are half the brightness of the first half.
  346. In this way, for example, 64 colours may be displayed on an early Amiga.
  347. :p.:hp2.Hold-And-Modify:ehp2., or :hp2.HAM:ehp2. is a type of screen format
  348. where each pixel is either one of a small number of colours in a palette,
  349. or is held the same as the pixel to its left except that either the red,
  350. green or blue is modified.
  351. In this way a much larger range of colours can be displayed.
  352. :p.HAM modes sometimes have fringes down the vertical edges of
  353. shapes in the picture, as sometimes it is necessary to modify the lefthand
  354. pixel several times to get to the desired colour, if a suitable entry is
  355. not in the palette.
  356. :p.:hp2.HAM6:ehp2. is a HAM mode where there are 16 base palette
  357. entries and a possible maximum of 4096 colours.
  358. This is found on early Amigas.
  359. :p.:hp2.HAM8:ehp2. is a HAM mode where there are 64 base palette
  360. entries and a full 24 bit range of colours.
  361. Also because of the larger palette, fringing is less than in HAM6.
  362. This mode is present on later Amigas.
  363. :p.:hp2.Sliced-Hold-And-Modify:ehp2., or :hp2.SHAM:ehp2. is a mode where
  364. the palette is changed on every (or every other) scan line.
  365. This also helps reduce fringing compared to normal HAM6.
  366. SHAM is actually sliced HAM6, and might really be called SHAM6, and
  367. SHAM8 is not known to exist.
  368. :p.:hp2.Input:ehp2.
  369. :p.This code can read files that contain uncompressed or RLE compressed
  370. data.
  371. :p.1 bpp files can be read ok.
  372. :p.2,3 and 4 bpp files are read and returned as 4 bpp data.
  373. :p.5,6,7 and 8 bpp files are read and returned as 8 bpp data.
  374. :p.24 bpp files are read and returned as 24 bpp data.
  375. :p.EHB images can be read and are returned as 8 bpp data.
  376. :p.HAM6, HAM8 and SHAM files can be read and are returned as 24 bpp data.
  377. :p.Only the :hp2.BMHD:ehp2., :hp2.CMAP:ehp2., :hp2.CAMG:ehp2. and
  378. :hp2.BODY:ehp2. chunks are used when reading the file.
  379. :p.:hp2.Output:ehp2.
  380. :p.This code can write 1, 4, 8 and 24 bpp files.
  381. :p.24 bpp files can also be written in HAM6 form.
  382. This loses quality, but, is still better than a normal 8 bpp file.
  383. :p.This code writes RLE compressed data, as this usually results in
  384. much smaller files.
  385. :p.Only the :hp2.BMHD:ehp2., :hp2.CMAP:ehp2. and :hp2.BODY:ehp2. chunks
  386. are written to the file.
  387. When writing HAM data, a :hp2.CAMG:ehp2. chunk is written also.
  388. :p.You can optionally override parts of the BMHD header.
  389. :dl compact tsize=7 break=all.
  390. :dt.:hp9.ham6:ehp9.
  391. :dd.Means write 24 bpp data in HAM6 format, rather than as a true
  392. 24 bpp file.
  393. :dt.:hp9.xpos=N:ehp9.,:hp9.ypos=N:ehp9.
  394. :dd.Overrides the origin information in the file. Defaults are 0,0.
  395. :dt.:hp9.transcol=N:ehp9.
  396. :dd.Overrides the transparent colour field. Default is 0.
  397. :dt.:hp9.xaspect=N:ehp9.,:hp9.yaspect=N:ehp9.
  398. :dd.Overrides the aspect ratio information. Defaults are 1,1.
  399. This header information is not always honored by ILBM readers.
  400. :dt.:hp9.xscreen=N:ehp9.,:hp9.yscreen=N:ehp9.
  401. :dd.Overrides the screen size information.
  402. This is not often used by ILBM readers.
  403. The default is the image size.
  404. :edl.
  405. :p.Note that when some early programs try to load an >5 bpp ILBM file,
  406. they can switch to a 32 colour (5 bpp mode) and only read the 5 least
  407. significant planes of the file. This generally looks bad.
  408. :p.This support has been tested using a large range of sample files.
  409. But, some sample files supplied to the author have yet to be loaded.
  410. In particular some (24bpp?) DCTV originated files are not yet understood.
  411. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  412. help panel lists other supported file formats.
  413. .*...e
  414. .*...sHID_GBM_YUV12C    \45\   YUV12C M\45\Motion Frame Buffer:0:
  415. :h2 res=&HID_GBM_YUV12C..YUV12C M-Motion Frame Buffer
  416. :i2 refid=gbmsupp.YUV12C M-Motion Frame Buffer
  417. :p.The :hp2..VID:ehp2. file extension is recognised as a YUV12C file.
  418. :p.Although YUV12C files contain 12 bit YUV encoded colour image data,
  419. this code pretends they contain 24 bit RGB encoded colour data.
  420. :p.:hp2.Input:ehp2.
  421. :p.The files are converted from YUV to RGB data before the data is
  422. presented to the program.
  423. :p.:hp2.Output:ehp2.
  424. :p.The RGB data is converted to YUV when it is written to disk.
  425. :p.YUV12C files must be a multiple of 4 pixels wide.
  426. When trying to write a bitmap that is not a multiple of 4 pixels wide, this
  427. code truncates the last 1, 2 or 3 pixels left over.
  428. :dl compact tsize=7 break=all.
  429. :dt.:hp9.xpos=N:ehp9.,:hp9.ypos=N:ehp9.
  430. :dd.Overrides the origin information in the file. Defaults are 0,0.
  431. :edl.
  432. :p.This support has been tested using the M-Control Program 2.0,
  433. Browser sample application.
  434. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  435. help panel lists other supported file formats.
  436. .*...e
  437. .*...sHID_GBM_GREYMAP   \45\   Portable Greyscale\45\map:0:
  438. :h2 res=&HID_GBM_GREYMAP..Portable Greyscale-map
  439. :i2 refid=gbmsupp.Portable Greyscale-map
  440. :p.The :hp2..PGM:ehp2. file extension is recognised as a Greymap file.
  441. :p.Credit for file format to Jef Poskanzer.
  442. :p.Only the Binary :hp2.P5:ehp2. form of this format is supported.
  443. :p.These files hold :hp2.no palette:ehp2. information.
  444. :p.:hp2.Input:ehp2.
  445. :p.The files are returned as an 8 bit image usually with a greyscale palette.
  446. :dl compact tsize=7 break=all.
  447. :dt.:hp9.r:ehp9.,:hp9.g:ehp9.,:hp9.b:ehp9. or :hp9.k:ehp9.
  448. :dd.Forces the image to be read as shades of red, green, blue or grey
  449. (the default).
  450. :edl.
  451. :p.:hp2.Output:ehp2.
  452. :p.Normally 8 bpp image data as the greyscale equivelent of the bitmap data.
  453. :dl compact tsize=7 break=all.
  454. :dt.:hp9.r:ehp9.,:hp9.g:ehp9.,:hp9.b:ehp9. or :hp9.k:ehp9.
  455. :dd.Forces the red,green or blue component of the image to be written, or
  456. alternatively to write the greyscale equivelent (the default).
  457. :edl.
  458. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  459. help panel lists other supported file formats.
  460. .*...e
  461. .*...sHID_GBM_PIXMAP    \45\   Portable Pixel\45\map:0:
  462. :h2 res=&HID_GBM_PIXMAP..Portable Pixel-map
  463. :i2 refid=gbmsupp.Portable Pixel-map
  464. :p.The :hp2..PPM:ehp2. file extension is recognised as a Pixel-map file.
  465. :p.Credit for file format to Jef Poskanzer.
  466. :p.Only the Binary :hp2.P6:ehp2. form of this format is supported.
  467. :p.The Portable Pixel-map format is only capable of holding 24 bpp RGB data,
  468. and this code fully supports this.
  469. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  470. help panel lists other supported file formats.
  471. .*...e
  472. .*...sHID_GBM_KIPS      \45\   IBM KIPS:0:
  473. :h2 res=&HID_GBM_KIPS..IBM KIPS
  474. :i2 refid=gbmsupp.IBM KIPS
  475. :p.The :hp2..KPS:ehp2. file extension is recognised as a Pixel-map file.
  476. :p.The .KPS file is not enough to define a KIPS image.
  477. :p.The palette is stored in either an associated
  478. :hp2..PAL:ehp2. or :hp2..KPL:ehp2. file.
  479. :p.:hp2.Input:ehp2.
  480. :dl compact tsize=7 break=all.
  481. :dt.:hp9.pal:ehp9. or :hp9.kpl:ehp9.
  482. :dd.Tells this code to look for a .PAL or a .KPL file to find the palette
  483. (default is .PAL)
  484. :edl.
  485. :p.:hp2.Output:ehp2.
  486. :dl compact tsize=7 break=all.
  487. :dt.:hp9.pal:ehp9. or :hp9.kpl:ehp9.
  488. :dd.Tells this code to write  a .PAL or a .KPL file containing the palette.
  489. (default is .PAL)
  490. :edl.
  491. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  492. help panel lists other supported file formats.
  493. .*...e
  494. .*...sHID_GBM_IAX       \45\   IBM Image Access eXecutive:0:
  495. :h2 res=&HID_GBM_IAX..IBM Image Access eXecutive
  496. :i2 refid=gbmsupp.IBM Image Access eXecutive
  497. :p.The :hp2..IAX:ehp2. file extension is recognised as a IAX file.
  498. :p.This image format does not include a palette or a file header.
  499. In particular, the image file size cannot be determined from the file!
  500. This code assumes an image width of 512 pixels, and determines the image
  501. height by dividing the file size by the width.
  502. :p.The data is presented as a greyscale.
  503. :p.:hp2.Input:ehp2.
  504. :dl compact tsize=7 break=all.
  505. :dt.:hp9.r:ehp9.,:hp9.g:ehp9.,:hp9.b:ehp9. or :hp9.k:ehp9.
  506. :dd.Forces the image to be read as shades of red, green, blue or grey
  507. (the default).
  508. :dt.:hp9.width=N:ehp9.
  509. :dd.Overrides the default assumption that the image width is 512 pixels.
  510. :edl.
  511. :p.:hp2.Output:ehp2.
  512. :p.Normally 8 bpp image data as the greyscale equivelent of the bitmap data.
  513. :dl compact tsize=7 break=all.
  514. :dt.:hp9.r:ehp9.,:hp9.g:ehp9.,:hp9.b:ehp9. or :hp9.k:ehp9.
  515. :dd.Forces the red,green or blue component of the image to be written, or
  516. alternatively to write the greyscale equivelent (the default).
  517. :edl.
  518. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  519. help panel lists other supported file formats.
  520. .*...e
  521. .*...sHID_GBM_XBITMAP   \45\   X Windows Bitmap:0:
  522. :h2 res=&HID_GBM_XBITMAP..X Windows Bitmap
  523. :i2 refid=gbmsupp.X Windows Bitmap
  524. :p.The :hp2..XBM:ehp2. file extension is recognised as a X Bitmap file.
  525. :p.X Bitmap files are ASCII text files, that look to be directly source
  526. include-able in C programs.
  527. :p.This program is very generous in its parsing of the files.
  528. :p.This program supports X10 and X11 1bpp bitmaps.
  529. Some .XBM files with text strings inside have been encountered.
  530. These looked to be sprites or icons and are not supported.
  531. :p.When reading X Bitmaps, 1's are returned as black, 0's as white.
  532. :p.When writing X bitmaps, the darkest colour is written as 1's, the lightest
  533. as 0's.
  534. :p.This code has been tested on some .XBM files.
  535. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  536. help panel lists other supported file formats.
  537. .*...e
  538. .*...sHID_GBM_SPRITE    \45\   RiscOS Sprite:0:
  539. :h2 res=&HID_GBM_SPRITE..RiscOS Sprite
  540. :i2 refid=gbmsupp.RiscOS Sprite
  541. :p.The :hp2..SPR:ehp2. and :hp2..SPRITE:ehp2. file extensions are
  542. recognised as a RiscOS sprite file.
  543. Technically, due to the way the RiscOS works, files don't have extensions.
  544. But for convenience, I have arbitrarily said .SPR, to allow sprites to fit in
  545. with all the other image formats.
  546. :p.:hp2.Input:ehp2.
  547. :p.This code will read 1,2,4 and 8 bpp files.
  548. 2bpp files will be expanded to 4bpp on reading.
  549. :p.Sprite files can contain an image, or an image and a mask plane.
  550. This code will ignore the mask plane.
  551. :p.If no palette is present in the file, GBM will assume a default palette
  552. similar to that used by the RiscOS Wimp.
  553. :p.There is a limitation in that the :hp2.first-bit:ehp2. field of the
  554. sprite header must be a multiple of 8 (highly likely).
  555. :dl compact tsize=7 break=all.
  556. :dt.:hp9.index=N:ehp9.
  557. :dd.Can be used if the file contains more than one sprite to specify which
  558. sprite in the file to read (default N=0 - the first in the file).
  559. :edl.
  560. :p.:hp2.Output:ehp2.
  561. :p.This code will write 1,4 and 8bpp files.
  562. :p.A palette will be written into the file.
  563. :p.Only the image plane is written, ie&colon. no mask plane.
  564. :p.When outputting 8bpp bitmaps, the usual wierd Archimedes palette is written
  565. and the bitmap data is :hp2.mapped to this palette:ehp2..
  566. This is because the Archimedes cannot support arbitrary 256 colour palettes.
  567. The VIDC chip only has 16 palette registers, with 16 fixed overrides on
  568. (or shades of) each.
  569. :p.GBM writes 16 palette entries to the file.
  570. Sprite files can be found with 64 palette entries (with 4 overrides on each).
  571. However, it is seen that these 64 palette entries are actually just 16 entries
  572. with the 4 overrides on each. Hence this is equivelent to 16 entries with 16
  573. overrides, except some of the overrides are explicitly stored in the file.
  574. :p.Tested reading 4bpp sprites with no palette.
  575. :p.Tested reading 8bpp sprites with no palette and with 64 entry palette.
  576. :p.Sprites generated by GBM have been loaded on RiscOS.
  577. Remember&colon. Use SetType to change type of file from PC-file to Sprite,
  578. by SetType option of filer menu or "*SetType <filename> Sprite".
  579. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  580. help panel lists other supported file formats.
  581. .*...e
  582. .*...sHID_GBM_PSEG      \45\   IBM Printer Page Segment:0:
  583. :h2 res=&HID_GBM_PSEG..IBM Printer Page Segment
  584. :i2 refid=gbmsupp.IBM Printer Page Segment
  585. :p.The following file extensions
  586. :xmp.
  587.   .PSE .PSEG .PSEG38PP .PSEG3820
  588. :exmp.
  589. :p.are recognised as PSEG files.
  590. :p.PSEG files are used as a way to include image data in SCRIPT documents.
  591. :p.PSEG files only contain 1bpp data, which is always ink on paper, ie&colon.
  592. black on white.
  593. :p.:hp2.Input:ehp2.
  594. :p.PSEG files should be downloaded from the host in binary mode.
  595. No EBCDIC/ASCII conversion should be used in the download process.
  596. :p.The palette is always returned as black 1's on white 0's, because PSEG
  597. files do not include any palette.
  598. :dl compact tsize=7 break=all.
  599. :dt.:hp9.fixrec:ehp9.
  600. :dd.Some PSEG files have been observed to have shorter records than specified
  601. in the length field (2nd and 3rd bytes) of a record.
  602. Although this doesn't matter when on VM, it can confuse non-VM readers, such
  603. as GBM.
  604. GBM can be told to attempt to compensate for this corrupt record structure
  605. using the fixrec option.
  606. :edl.
  607. :p.:hp2.Output:ehp2.
  608. :p.When writing PSEG files, any colour palette is lost.
  609. :p.The resulting file is a binary file and should be uploaded to a VM machine
  610. as such.
  611. No EBCDIC/ASCII conversion should be used.
  612. However, on a VM host, the record structure of a PSEG is necessary for
  613. it to be correctly interpreted by the VM tools.
  614. On non VM systems, files do not have a record structure.
  615. Therefore after uploading, the PSEG files must be 'fixed'.
  616. You need a tool, like FIXL3820 EXEC to do this.
  617. Basically, each PSEG files record starts with a 0x5a character, and this can
  618. be used to delineate records.
  619. :p.PSEG files are a multiple of 8 pixels wide, so this code writes a file
  620. with the width the next multiple of 8 pixels wide.
  621. The right edge is padded with white pixels.
  622. :dl compact tsize=7 break=all.
  623. :dt.:hp9.double:ehp9.
  624. :dd.There is a scale factor in the PSEG header.
  625. By specifying this option, the scale factor is written as double the
  626. usual value.
  627. :edl.
  628. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  629. help panel lists other supported file formats.
  630. .*...e
  631. .*...sHID_GBM_GEMRAS    \45\   GEM Raster:0:
  632. :h2 res=&HID_GBM_GEMRAS..GEM Raster
  633. :i2 refid=gbmsupp.GEM Raster
  634. :p.Files with the :hp2..IMG:ehp2. extension are recognised as GEM Raster
  635. files.
  636. :p.The GEM Raster file format is an old format, found primarily on the Atari
  637. platform.
  638. :p.It has a basic flavor in which &colon.-
  639. :sl.
  640. :li.1 bpp bitmaps can only be black and white.
  641. :li.4 bpp bitmaps can only use a fixed 'standard' palette, or be greyscale.
  642. :li.2,3,5,6,7 and 8 bpp bitmaps can only be greyscale.
  643. :li.24 bpp bitmaps are not supported.
  644. :esl.
  645. :p.In addition there are XIMG extensions to the format &colon.-
  646. :sl.
  647. :li.1-8 bpp bitmaps can contain a palette.
  648. :li.24 bpp bitmaps are now allowed.
  649. :esl.
  650. :p.:hp2.Input:ehp2.
  651. :p.This code can read all of the above, with the usual proviso that 2 and 3
  652. bpp are rounded up to 4 bpp, and 5,6 and 7 bpp are rounded up to 8.
  653. :p.:hp2.Output:ehp2.
  654. :p.GBM will write all the above formats, and where there are choices,
  655. the following options can be used &colon.-
  656. :dl compact tsize=7 break=all.
  657. :dt.:hp9.grey:ehp9.
  658. :dd.GBM writes 4 bpp files by mapping them to the standard palette by
  659. default.
  660. The non default behaviour of mapping to a grayscale can be enabled by this
  661. flag.
  662. :dt.:hp9.pal:ehp9.
  663. :dd.When writing 4 or 8 bpp files, this option tells GBM to write an XIMG
  664. format file with the palette included.
  665. :dt.:hp9.pixw=N:ehp9.,:hp9.pixh=N:ehp9.
  666. :dd.This overrides the default pixel dimensions in the header.
  667. The default is 85 by 85 microns.
  668. :edl.
  669. :p.Note that Image Alchemy 17 appears to assume a different standard 16 colour
  670. palette when converting to GEM Raster format.
  671. This disagrees with :hp2.all:ehp2. the testcase images currently encountered.
  672. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  673. help panel lists other supported file formats.
  674. .*...e
  675. .*...sHID_GBM_PORTRAIT  \45\   Portrait:0:
  676. :h2 res=&HID_GBM_PORTRAIT..Portrait
  677. :i2 refid=gbmsupp.Portrait
  678. :p.Files with the :hp2..CVP:ehp2. extension are recognised as Portrait files.
  679. :p.These files hold a single 512x512 24bpp RGB image.
  680. Some photographers in Germany hand you a disk containing a .CVP file
  681. when you get your passport pictures taken.
  682. You can return later with the disk and get further prints made.
  683. :p.Now with GBM supporting this format, you can convert to and from other
  684. file formats and use paintbox programs to remove those ugly pimples...
  685. :p.Pixels are not square in this file format, so images when loaded appear
  686. horizontally stretched.
  687. GBM leaves it up to the user to rescale the image to look nice.
  688. Scaling horizontally by a factor somewhere between 0.75 and 0.8 gives a
  689. pleasing effect.
  690. :p.Of course, it is important to remember that Portrait files only hold
  691. 512x512 images, and if you take an image from elsewhere and convert to
  692. Portrait, the image will be printed thinner at the photographers due to
  693. this non-square-pixel problem.
  694. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  695. help panel lists other supported file formats.
  696. .*...e
  697. .*...sHID_GBM_JPEG      \45\   JPEG:0:
  698. :h2 res=&HID_GBM_JPEG..JPEG
  699. :i2 refid=gbmsupp.JPEG
  700. :p.The following file extensions
  701. :xmp.
  702.   .JPG .JPEG .JPE
  703. :exmp.
  704. :p.are recognised as JPEG files.
  705. :p.Technically it is the JFIF type of JPEG files which are supported.
  706. :p.8 bpp (greyscale) and 24 bpp files may be read.
  707. :p.Only 24 bpp data may be written.
  708. :p.:hp2.Output:ehp2.
  709. :p.Bitmaps can be written with varying degrees of quality
  710. (ie: degrees of lossyness of the compression).
  711. They can also be written in a simple progressive manner.
  712. :dl compact tsize=7 break=all.
  713. :dt.:hp9.quality=Q:ehp9.
  714. :dd.Causes the file to be written at quality Q, where Q is a rather
  715. arbitrary measure.
  716. Q can be in the range 0 to 100, with a reasonable default of 75.
  717. :dt.:hp9.prog:ehp9.
  718. :dd.Causes the file to be written as a progressive JPEG.
  719. :edl.
  720. :p.GBM can be compiled up either with or without support for JPEG.
  721. If you don't see JPEG amongst the list of supported file formats on the
  722. File Open dialog box, then you are using a GBM.DLL without support.
  723. :p.The JPEG support for GBM is provided by the Independant JPEG Groups
  724. JPEGLIB library, version 6a.
  725. It may be freely used provided the IJG are credited (hence its use in GBM,
  726. and this paragraph in the online help).
  727. :p.The code to interface GBM to IJG 6a was written by
  728. Mark Lisowski <mlisowski@aixterm1.urz.uni-heidelberg.de>.
  729. I have made a couple of minor modifications.
  730. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  731. help panel lists other supported file formats.
  732. .*...e
  733. .*...sHID_GBM_OTHERS    \45\   Others:0:
  734. :h2 res=&HID_GBM_OTHERS..Others
  735. :i2 refid=gbmsupp.Others
  736. :p.Support for all the bitmap file formats may be added at any time,
  737. without application writers being aware of it.
  738. :p.Any new formats will be listed in the dialog filetype combobox,
  739. although the help may not (yet) have an entry for them.
  740. :p.The :link reftype=hd res=&HID_GBM_SUPPORT..Bitmap file format support:elink.
  741. help panel lists other supported file formats.
  742. .*...e
  743. :index.
  744. :euserdoc.
  745.