home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / c / creator / !Creator / Docs / Guide next >
Encoding:
Text File  |  1997-01-05  |  19.2 KB  |  612 lines
  1.  
  2. __________________
  3.  
  4. Creator user guide
  5. __________________
  6.  
  7.  
  8. User, please note
  9. =================
  10.  
  11. Creator is Shareware. It is not free software. You may freely use this
  12. program for a single 30 day trial period. After this trial period, you must
  13. decide whether or not you want to continue to use the program. If you don't,
  14. you must stop using the program and delete your copy. If you do, you must
  15. register your copy of the program with the author, paying a small
  16. registration fee. Refer to 'Registering' for details.
  17.  
  18. Please respect the rules of Shareware. Shareware programs like Creator have
  19. cost an awful lot of time and effort to build, will serve you well, and will
  20. cost you very little. If you register the Shareware you use, you will ensure
  21. that Shareware authors will continue to improve the software you use, and
  22. write exciting new Shareware software. If you don't register the Shareware
  23. you use, you are stealing money from Shareware authors, and they will stop
  24. writing Shareware, and start writing much more expensive commercial software
  25. instead.
  26.  
  27. Copyright notice
  28. ================
  29.  
  30. The copyright (c) of this program belongs to John Kortink. All rights are
  31. reserved.
  32.  
  33. You may not change this program (except for documented configuration
  34. changes). You may not use any part of this program in any other program or
  35. product without my written approval. You may spread this program freely, but
  36. only in complete and unchanged form, and only against bare distribution costs
  37. (if any). This program is provided 'as is'. No fitness of this program for
  38. any particular purpose is implied. Using this program is entirely at your own
  39. risk.
  40.  
  41.  
  42. //
  43. //
  44. // Introduction
  45. //
  46. //
  47.  
  48. Creator is a pixel image format convertor. It can perform direct conversions
  49. between a large number of image formats and image subformats. Whenever a
  50. reduction of colour resolution is required, Creator employs sophisticated
  51. algorithms to preserve as much as possible of the image contents.
  52.  
  53. Creator is extremely fast. All code, except for the WIMP interface and the
  54. JPEG and PNG conversion code, has been written in 100%, carefully optimized
  55. ARM assembly code.
  56.  
  57.  
  58. //
  59. //
  60. // Using Creator
  61. //
  62. //
  63.  
  64. On Creator's iconbar menu the usual 'Info' and 'Quit' icons can be found. In
  65. addition, 'Control' gives access to the 'Creator control' window (click on
  66. 'Control' to make the window permanent), and 'Status' gives access to the
  67. 'Status' menu. Both the 'Creator control' window and the 'Status' menu are
  68. described below.
  69.  
  70. Dragging an image file to Creator's icon will initiate a conversion. If
  71. Creator recognizes the format of the image file, the 'Creator image' window
  72. will appear. The 'Creator image' window is described below.
  73.  
  74.  
  75. //
  76. //
  77. // The 'Creator image' window
  78. //
  79. //
  80.  
  81. In this window, you will find two parts, called 'Input image' and 'Output
  82. image'.
  83.  
  84. The 'Input image' part refers to the image file you dragged to the Creator
  85. icon bar, and shows details of the input image. In addition :
  86.  
  87. - 'Options', for some image formats, allows you to specify 'load options',
  88.   which (mostly subtly) influence the way your input image is interpreted.
  89.   Refer to 'Supported image formats (detailed)' for information on specific
  90.   load options.
  91.  
  92. The 'Output image' part refers to the image file you are going to save, and
  93. allows you to specify the format of the output image. The choices that are
  94. available represent all possible conversions that Creator is capable of,
  95. given the format of the input image, as follows :
  96.  
  97. - 'Format' allows you to choose the image format.
  98. - 'Colours' allows you to choose the number of colours used. If the writable
  99.   field is not shaded, you may also specify the precise maximum number of
  100.   colours to be used.
  101. - 'Compression' allows you to choose the compression method used.
  102. - 'Options', for some image formats, allows you to specify 'save options',
  103.   which (mostly subtly) influence the way your output image is saved. Refer
  104.   to 'Supported image formats (detailed)' for information on specific save
  105.   options.
  106.  
  107. The 'Colours' field deserves some further explanation. This is displayed as
  108. 'x bit r:g:b type', where 'x' is the number of bits per pixel (referred to
  109. below as 'bpp'), 'r', 'g', and 'b' are the number of bits of accuracy in a
  110. pixel colour of red, green, and blue respectively, and 'type' is the pixel
  111. colour type. There are essentially two pixel colour types :
  112.  
  113. - The 'palette' or 'grey' type indicates that pixel values are not pixel
  114.   colours themselves but indices into a pixel colour lookup table (called a
  115.   'palette'). The 'grey' pixel type also indicates that all palette colours
  116.   are greys.
  117. - The 'true' pixel type indicates that pixel values directly represent pixel
  118.   colours. Therefore, 'x' is always the addition of 'r', 'g' and 'b'.
  119.  
  120. Conversions may or may not need colour quantization, colour dithering and/or
  121. colour remapping algorithms to be applied. Creator applies the required
  122. algorithms automatically.
  123.  
  124. Colour quantization is used whenever a 'superset' of colours (used in the
  125. input image) needs to be reduced to a smaller 'subset' of colours (to be used
  126. in the output image). The colour quantization algorithm calculates the subset
  127. of colours that best represents the superset of colours, taking into account
  128. the number of times each colour from the superset appears in the input image.
  129. Colour quantization is only used for palette colour output images. The colour
  130. quantization algorithm used in Creator is known as Heckbert 'median cut'. 
  131.  
  132. Colour dithering is used when the number of colours in the output image is
  133. less than that in the input image, or when any of the number of bits per
  134. r/g/b in the output image colours is less than that in the input image
  135. colours, or when the output palette is fixed. In all these cases, some or all
  136. of the input image colours do not have an exactly matching colour in the
  137. output image, and so, for these colours, the 'closest' output image colours
  138. need to be chosen. For a given pixel, the colour dithering algorithm
  139. 'diffuses' the errors made by this approximation to neighboring pixels. This
  140. effectively 'smears out' the approximation errors over the rest of the image,
  141. which makes the errors much less visible to the human eye. The colour
  142. dithering algorithm used in Creator is a 'zizag' variant of Floyd-Steinberg.
  143.  
  144. Colour remapping is used whenever the colour quantization algorithm is used,
  145. and it finds that the number of different colours actually used in the input
  146. image is less than or equal to the number of available output image colours.
  147. In this case, the output image palette simply consists of all actually used
  148. input image colours, and all that is needed is 'remapping' of the input image
  149. colours to their respective output image colours. An exact copy of the input
  150. image results. For example, it is not uncommon to encounter 24 bpp 'true
  151. colour' image files in which only 256 colours (or even less) are actually
  152. used. This can happen if someone, somewhere, sometime, for whatever dim
  153. reason, has 'promoted' an 8 bpp palette colour image to 'true colour'. In
  154. these cases, Creator can exactly recreate the original palette colour image.
  155.  
  156. Creator does the right thing if the output palette turns out to be all grey
  157. (which usually only happens when the output format requires a fixed grey
  158. palette, e.g. PBMPlus 8 bpp or JPEG 8 bpp). In this situation, the colour
  159. dithering algorithm used is unsuitable if the input image is in colour,
  160. because colours are impossible to approximate well with just grey values,
  161. resulting in a bad quality output image. In this case, a special 'grey only'
  162. dithering algorithm is used instead, which gives perfect results. The
  163. 'Dithering' setting (see elsewhere) has no effect if this algorithm is used.
  164.  
  165. After making all your choices, you can enter a filename in the 'Filename'
  166. field and drag the filetype icon to save the output image.
  167.  
  168.  
  169. //
  170. //
  171. // The 'Creator control' window
  172. //
  173. //
  174.  
  175. In this window, you will find two parts, called 'Quantization' and
  176. 'Dithering'.
  177.  
  178. The 'Quantization' part allows you to select the accuracy with which colour
  179. frequencies are determined during colour quantization. A higher number of
  180. bits for 'Red', 'Green' or 'Blue' will increase the accuracy with which the
  181. corresponding primary colour is handled. Note however that selecting more
  182. than the default of 5 bits per primary colour results in only very marginal
  183. and mostly unnoticable differences in image quality. Also note that selecting
  184. less than 5 bits is not really recommended except for the entertainment value
  185. that the resulting images provide. Also note that memory requirements double
  186. with every bit added to the total number of bits. The default setting of 5
  187. bits per primary colour (15 bits total) needs around 128k of memory.
  188.  
  189. The 'Dithering' part allows you to select the accuracy of the colour mapping
  190. tables used during colour dithering. Similar comments as for the
  191. 'Quantization' setting apply, and the default setting of 5 bits per primary
  192. colour also needs around 128k of memory.
  193.  
  194.  
  195. //
  196. //
  197. // The 'Status' menu
  198. //
  199. //
  200.  
  201. In this menu you can manipulate Creator's 'status', which consists of a
  202. number of configuration settings.
  203.  
  204. - 'Save' will save the current status.
  205. - 'Load' will load the saved status.
  206. - 'Default' will load the default status.
  207. - 'Kill' will remove the saved status.
  208.  
  209. When Creator starts up it loads the saved status, or the default status if
  210. there is no saved status.
  211.  
  212. The status consists of the 'Quantization' and 'Dithering' settings.
  213.  
  214.  
  215. //
  216. //
  217. // Supported image formats (overview)
  218. //
  219. //
  220.  
  221. Creator can read the following image formats (in alphabetical order) :
  222.  
  223. - AIM
  224. - CadSoft
  225. - Clear
  226. - Degas
  227. - GIF
  228. - IFF
  229. - IMG
  230. - Irlam
  231. - JPEG
  232. - MacPaint
  233. - MTV
  234. - PBMPlus
  235. - PCX
  236. - Pineapple
  237. - PNG
  238. - QRT
  239. - Sprite
  240. - TIFF
  241.  
  242. Creator can write the following image formats (in alphabetical order) :
  243.  
  244. - Clear
  245. - GIF
  246. - JPEG
  247. - PBMPlus
  248. - PNG
  249. - Sprite
  250. - TIFF
  251.  
  252.  
  253. //
  254. //
  255. // Supported image formats (detailed)
  256. //
  257. //
  258.  
  259. Following are brief details of all supported image formats.
  260.  
  261. Image format interpreters are usually very complete, but may, in some cases,
  262. lack support for some subformats. All image interpreters have at least been
  263. tested successfully on all sample images I could find, and have been verified
  264. as well as possible against documentation available to me. Generally, if
  265. Creator encounters formats or subformats that cannot be recognized or are not
  266. supported, it will give up gracefully and provide an indication of why it has
  267. failed.
  268.  
  269. AIM
  270. ===
  271. - Origin
  272.   Acorn machines. !AIM (Archimedes Image Manager) program.
  273. - Colours
  274.   8 bpp 8:8:8 grey
  275. - Compression
  276.   none
  277. - Recognition
  278.   filetype &004
  279. - Miscellaneous
  280.   Resolution is always 256 x 256 pixels.
  281.  
  282. CadSoft
  283. =======
  284. - Origin
  285.   Acorn machines. Millipede Prisma display board.
  286. - Colours
  287.   8 bpp 8:8:8 palette colour
  288. - Compression
  289.   none
  290.   runlength
  291. - Recognition
  292.   filetype &69A
  293.   'MILLIPEDE' at offset &10
  294.  
  295. Clear
  296. =====
  297. - Origin
  298.   Acorn machines. !Translator program and several hardware vendors' programs.
  299. - Colours
  300.   1,2,3,4,5,6,7,8 bpp 8:8:8 palette colour
  301.   24 bpp 8:8:8 true colour
  302. - Compression
  303.   none
  304. - Recognition
  305.   filetype &690
  306.  
  307. Degas
  308. =====
  309. - Origin
  310.   Atari machines. Degas and other programs.
  311. - Colours
  312.   1,2,4 bpp 3:3:3 palette colour
  313. - Compression
  314.   none
  315.   runlength
  316. - Recognition
  317.   filetype &691
  318.  
  319. GIF
  320. ===
  321. - Origin
  322.   Various machines. Graphics Interchange Format, devised by and copyright of
  323.   Compuserve Incorporated.
  324. - Colours
  325.   1,2,3,4,5,6,7,8 bpp 8:8:8 palette colour
  326. - Compression
  327.   12-bit LZW
  328. - Recognition
  329.   filetype &695
  330.   'GIF87a' or 'GIF89a' at offset &0
  331. - Miscellaneous
  332.   When reading, any GIF89a extensions are skipped and ignored. When writing,
  333.   GIF87a format is always used.
  334. - Save options
  335.   'Interlace' defines whether or not an interlaced image is saved. 'Interlace
  336.   = Yes' will save an interlaced image, 'Interlace = No' won't.
  337.  
  338. IFF
  339. ===
  340. - Origin
  341.   Various machines. Interchange Format File, devised by Electronic Arts.
  342. - Colours
  343.   1,2,3,4,5,6,7,8 bpp 4:4:4 palette colour
  344.   1,2,3,4,5,6,7,8 bpp 8:8:8 palette colour
  345.   12 bpp 4:4:4 true colour
  346.   24 bpp 8:8:8 true colour
  347. - Compression
  348.   none
  349.   runlength
  350. - Recognition
  351.   filetype &693
  352.   'FORM' at offset &0 and 'ILBM' at offset &8
  353.  
  354. IMG
  355. ===
  356. - Origin
  357.   Atari and IBM compatible machines. Digital Research GEM programs.
  358. - Colours
  359.   1 bpp 8:8:8 grey
  360. - Compression
  361.   various methods
  362. - Recognition
  363.   filetype &692
  364.  
  365. Irlam
  366. =====
  367. - Origin
  368.   Acorn machines. Irlam video digitiser.
  369. - Colours
  370.   24 bpp 8:8:8 grey
  371. - Compression
  372.   none
  373. - Recognition
  374.   filetype &69B
  375.   'Irlam' at offset &0
  376.  
  377. JPEG
  378. ====
  379. - Origin
  380.   Various machines. Joint Photographic Expert Group, the actual format is
  381.   called JFIF (JPEG File Interchange Format), devised by C-Cube Microsystems.
  382. - Colours
  383.   8 bpp 8:8:8 grey
  384.   24 bpp 8:8:8 true colour
  385. - Compression
  386.   Baseline JPEG
  387. - Recognition
  388.   filetype &C85
  389.   &FF, &D8 at offset &0
  390. - Load options
  391.   'Float DCT = No' uses 'fast' integer DCT (Discrete Cosine Transform) code.
  392.   'Float DCT = Yes' uses slightly more accurate but 'slow' floating point DCT
  393.   code. In practice, both option settings nearly always result in the same
  394.   image quality.
  395. - Save options
  396.   'Quality = xx', where xx = 0..100, sets the quality level. 100 is best
  397.   quality, lowest compression. 0 is worst quality, highest compression.
  398.   'Optimize' switches on/off compression optimization (switching it on
  399.   results in somewhat smaller files but also uses more processing time).
  400.   'Optimize = Yes' switches on compression optimization. 'Optimize = No'
  401.   switches it off.
  402. - Miscellaneous
  403.   - Processing code is in C. Acknowledgements :
  404.     - Compiled with GCC for RISC OS release 1.0.7, (c) 1996 Nick Burrett.
  405.     - Linked with UnixLib 3.7b, maintained by Simon Callan.
  406.     - Uses IJG JPEG library 6a (07 Feb 1996), (c) 1991-1996 Thomas G. Lane
  407.       I am required to state that 'This work is based in part on the work of
  408.       the Independent JPEG Group'.
  409.  
  410. MacPaint
  411. ========
  412. - Origin
  413.   Apple MacIntosh machines. MacPaint program.
  414. - Colours
  415.   1 bpp 8:8:8 grey
  416. - Compression
  417.   runlength
  418. - Recognition
  419.   filetype &694
  420.   'PNTG' at offset &41
  421. - Miscellaneous
  422.   Resolution is always 576 x 720 pixels.
  423.  
  424. MTV
  425. ===
  426. - Origin
  427.   Various machines. MTV ray tracer.
  428. - Colours
  429.   24 bpp 8:8:8 true colour
  430. - Compression
  431.   none
  432. - Recognition
  433.   filetype &699
  434.  
  435. PBMPlus
  436. =======
  437. - Origin
  438.   Unix machines. Portable Bit Map set of conversion programs, devised by Jef
  439.   Poskanzer.
  440. - Colours
  441.   1,2,3,4,5,6,7,8 bpp 8:8:8 grey
  442.   24 bpp 8:8:8 true colour
  443. - Compression
  444.   none
  445. - Recognition
  446.   filetype &69E
  447.   'Px' at offset &0, where x = 1,2,3,4,5,6
  448. - Miscellaneous
  449.   Cannot save 2..7 bpp 8:8:8 grey.
  450.  
  451. PCX
  452. ===
  453. - Origin
  454.   IBM compatible machines. ZSoft PC Paintbrush program.
  455. - Colours
  456.   1,2,4,8 bpp 8:8:8 palette colour
  457. - Compression
  458.   none
  459.   runlength
  460. - Recognition
  461.   filetype &697
  462.  
  463. Pineapple
  464. =========
  465. - Origin
  466.   Acorn machines. Pineapple Software video digitiser.
  467. - Colours
  468.   16 bpp 5:6:5 true colour
  469. - Compression
  470.   none
  471. - Recognition
  472.   filetype &696
  473.   'FSIfile' at offset &0
  474. - Miscellaneous
  475.   Resolution is always 512 x 256 pixels.
  476.  
  477. PNG
  478. ===
  479. - Origin
  480.   Various machines. Portable Network Graphics format, initially designed to
  481.   impove on and fully replace GIF, since GIF's compression algorithm poses
  482.   patent problems since 1995. Forget GIF, use PNG (compresses better too !).
  483. - Colours
  484.   1,2,4,8 bpp 8:8:8 palette colour
  485.   1,2,4 bpp 8:8:8 grey
  486.   8 bpp 8:8:8 grey with optional alpha channel
  487.   16 bpp 16:16:16 grey with optional alpha channel
  488.   24 bpp 8:8:8 true colour with optional alpha channel
  489.   48 bpp 16:16:16 true colour with optional alpha channel
  490. - Compression
  491.   Deflate
  492. - Recognition
  493.   filetype &B60
  494.   137, 80, 78, 71, 13, 10, 26, 10 at offset &0
  495. - Miscellaneous
  496.   Reader supports all formats, but :
  497.   - 16 bpp 16:16:16 grey is 'stripped' to 8 bpp 8:8:8 grey.
  498.   - 48 bpp 16:16:16 true colour is 'stripped' to 24 bpp 8:8:8 true colour.
  499.   - Alpha channels and transparency cause pixel colours to be recalculated
  500.     against a background colour (black if not specified in PNG file).
  501.   - Processing code is in C. Acknowledgements :
  502.     - Compiled with GCC for RISC OS release 1.0.7, (c) 1996 Nick Burrett.
  503.     - Linked with UnixLib 3.7b, maintained by Simon Callan.
  504.     - Uses libpng 1.0 beta 3 0.89, (c) 1995-1996 Guy Eric Schalnat.
  505.     - Uses zlib 1.0.4, (c) 1995-1996 Jean-loup Gailly and Mark Adler.
  506.  
  507. QRT
  508. ===
  509. - Origin
  510.   Various machines. QRT ray tracer.
  511. - Colours
  512.   24 bpp 8:8:8 true colour
  513. - Compression
  514.   none
  515. - Recognition
  516.   filetype &698
  517.  
  518. Sprite
  519. ======
  520. - Origin
  521.   Acorn machines. Acorn defined native image format.
  522. - Colours
  523.   1,2,4,8 bpp 4:4:4 palette colour
  524.   1,2,4,8 bpp 8:8:8 palette colour
  525.   15 bpp 5:5:5 true colour
  526.   24 bpp 8:8:8 true colour
  527. - Compression
  528.   none
  529. - Recognition
  530.   filetype &FF9
  531. - Load options
  532.   'Default palette' defines the palette to use when palette colour sprites
  533.   without a palette are loaded. If the mapping of the bpp of the input to the
  534.   corresponding mode is thought of as 1,2,4,8 bpp --> mode 18,19,20,21, then
  535.   'Default palette = WIMP' will use the default WIMP palette for the
  536.   appropriate mode, and 'Default palette = Mode' will use the default mode
  537.   palette (as after a MODE command outside the desktop).
  538. - Save options
  539.   'Sprite type' defines the sprite type to save. It only affects the mode
  540.   number saved in the sprite file. 'Sprite type = Default' will save old type
  541.   sprites for 4:4:4 palette colour input, else new type sprites. 'Sprite type
  542.   = Force old' will always save old type sprites. 'Sprite type  = Force new'
  543.   will always save new type sprites.
  544. - Miscellaneous
  545.   Sprite masks are always ignored. Old type 8 bpp 4:4:4 sprites always have
  546.   the standard fixed 256-colour palette and are actually saved without
  547.   palette.
  548.  
  549. TIFF
  550. ====
  551. - Origin
  552.   Various machines. Tag Image File Format (that's 'Tag', not 'Tagged' as most
  553.   people think !), devised by Aldus Corporation and Microsoft Corporation.
  554. - Colours
  555.   1,2,4,8 bpp 8:8:8 palette colour
  556.   24 bpp 8:8:8 true colour
  557. - Compression
  558.   none
  559.   packbits
  560.   12-bit LZW
  561. - Recognition
  562.   filetype &FF0
  563.   'II' or 'MM' at offset &0
  564.  
  565.  
  566. //
  567. //
  568. // Registering
  569. //
  570. //
  571.  
  572. Please register this program if it serves you well. I am sacrificing a lot of
  573. my time to help increase the amount of good software available for your Acorn
  574. machine. Registration is cheap and easy.
  575.  
  576. To register, send 30 Dutch Guilders to :
  577.  
  578. John Kortink
  579. Nutterbrink 31
  580. 7544 WJ Enschede
  581. The Netherlands
  582.  
  583. As soon as your registration has been received you will be a registered user
  584. of Creator. A floppy disc with the latest version of Creator will be sent to
  585. you free of charge, unless you are easily able to access my www page on the
  586. Internet, in which case you already have immediate access to the very latest
  587. versions. Registration also entitles you to free use of any future versions
  588. of Creator.
  589.  
  590. NOTE : if you register for any one of of my applications Creator, Translator
  591. or GreyEdit, you are automatically registered for all of them.
  592.  
  593. I can accept any of the following types of payment (in order of preference) :
  594.  
  595. - Cash. You may send any regular European currency, as long as it is
  596.   equivalent to 30 Dutch Guilders and consists of 'large', recent bank notes
  597.   only.
  598. - Eurocheque. Please note down your pass number on the back of the cheque or
  599.   I will be unable to cash the cheque at the bank.
  600.  
  601. Please note that I cannot accept any other type of payment, including cheques
  602. that are not Eurocheques. I cannot cash these cheques without paying high
  603. bank charges.
  604.  
  605. Updates of Creator will be made available by (in order of preference) :
  606.  
  607. - World Wide Web, on www.inter.nl.net/users/J.Kortink.
  608. - Electronic mail, to kortink@inter.nl.net.
  609. - Snail mail, to : see registration address. Include a DD or HD floppy,
  610.   return envelope and one International Reply Coupon (IRC).
  611.  
  612.