home *** CD-ROM | disk | FTP | other *** search
/ Really Useful CD 1 / ReallyUsefulCD1.iso / extras / graphics / _translatr / docs / guide next >
Encoding:
Text File  |  1990-08-26  |  31.9 KB  |  726 lines

  1. _______________________________________________________________________________
  2.  
  3. Translator 6.21                             -------------------------------
  4.                                              This program is PUBLIC DOMAIN
  5. Version date : 26 Aug 1990                  -------------------------------
  6.  
  7. ----------------
  8. - Introduction -
  9. ----------------
  10.  
  11. Translator will translate image files from other computers to the Archimedes.
  12. The following image files are supported :
  13.  
  14. - Atari PI1,PI2,PI3,PC1,PC2,PC3 files (320x200x16, 640x200x4 and 640x400x2,
  15.   uncompressed and compressed)
  16. - Atari IMG files (monochrome only)
  17. - Amiga IFF files (including HAM and halfbright modes)
  18. - MacIntosh MacPaint files (576x720x2 b/w)
  19. - GIF (Graphics Interchange Format) files
  20. - Archimedes' sprite files
  21. - ProArtisan compressed (type 0 and 1) files (640x256x256)
  22. - Watford digitiser files (512x256x64 greys)
  23. - Render Bender files (256 colour mode images)
  24. - AIM files (256x256x256 greys)
  25. - SUN Microsystems files (1/8-bit per pixel uncompressed)
  26. - PCX files (2/4/16-colour EGA and 256-colour MCGA)
  27. - TIFF files (bilevel, greyscale, palette colour and RGB full colour (also
  28.   known as TIFF Classes B,G,P and R), uncompressed or PackBits compressed,
  29.   1,2,4,8 or 24 bits per pixel)
  30. - QRT RAW (24-bit RGB) files (Quick Ray Tracer)
  31. - ArVis Videographics (15-bit RGB) files (2 sprite files in HIP/LOP dirs)
  32. - Translator's own 'Clear' files (pure 24-bits RGB and up to 8 bit per pixel
  33.   with palette, any resolution, refer to 'Clear files' for more information)
  34. - MTV (Marc Terrence VanDeWettering) ray tracer images (24-bit RGB)
  35. - 'CadSoft' (used by Cadsoft and Millipede PRISMA digitiser) images (8 bit
  36.   per pixel colour)
  37.  
  38. -------------------------
  39. - Using the application -
  40. -------------------------
  41.  
  42. To start up Translator, double-click on the '!Translatr' icon. It will
  43. install itself on the icon bar, and clicking MENU on Translator's icon will
  44. give the usual 'Info' and 'Quit' options. Clicking SELECT or ADJUST will
  45. pop up the options menu, but most options will not be selectable at this stage.
  46.  
  47. Loading an image can be done in three ways :
  48. a) by dragging the image file to the Translator icon on the icon bar
  49. b) by dragging the image file to the image window (when an image is loaded)
  50. c) by double-clicking on an image file (not for 'native' Archimedes formats,
  51.    to ensure that the originating programs (when loaded) 'catch' these files,
  52.    not Translator)
  53.  
  54. NOTE : The ArVis Videographics format consists of two sprite files per image,
  55. of which one resides in a directory named 'HIP', the other in a directory
  56. called 'LOP' (both at the same directory level). To load an ArVis image, drag
  57. the sprite file in the 'HIP' directory to Translator (i.e. a or b).
  58.  
  59. Image files should be filetyped appropiately to be recognized by Translator.
  60. The following filetypes are used by Translator (the filetypes in the range
  61. &690-&6xx are new filetypes, used for foreign formats) :
  62.  
  63. -------------------------------------------------------------------------
  64. Filetype Name       Image file type/origin
  65. -------------------------------------------------------------------------
  66. &004     AIM        AIM (Archimedes Image Manager)
  67. &690    *Clear      Translator Clear
  68. &691    *Degas      Atari PI1,PI2,PI3,PC1,PC2,PC3
  69. &692    *Img        Atari IMG
  70. &693   !*AmigaIFF   Amiga IFF (ILBM)
  71. &694   !*MacPaint   MacIntosh MacPaint
  72. &695   !*GIF        GIF (Graphics Interchange Format)
  73. &696   !*SUN        SUN Microsystems
  74. &697    *PCX        PC PCX
  75. &698    *QRT        QRT (Quick Ray Tracer) RAW
  76. &699    *MTV        MTV ray tracer
  77. &69A   !*CadSoft    CadSoft/Millipede PRISMA
  78. &D58     RendPic    Render Bender
  79. &DE2     ProArt     ProArtisan
  80. &DFA     Picture    Watford digitiser
  81. &FF0   !*TIFF       TIFF (Tag Image File Format)
  82. &FF9     Sprite     Standard Archimedes sprite file (or ArVis, see above)
  83. -------------------------------------------------------------------------
  84. A '*' indicates which filetypes also load by method c) (see above).
  85. A '!' indicates which filetypes can be recognized and loaded without having
  86. the correct filetype. You can choose to give these files the correct filetype
  87. yourself, or leave them as they are.
  88.  
  89. Every new filetype is represented in filer windows by its own icon, which
  90. is similar to Translator's iconbar icon.
  91.  
  92. When succesfully processed, the image will appear in a resizable, scrollable
  93. window.
  94.  
  95. --------------------
  96. - The options menu -
  97. --------------------
  98.  
  99. Clicking MENU on the image window (when an image is loaded) or clicking
  100. SELECT or ADJUST on the iconbar icon will pop up the options menu :
  101.  
  102.  
  103. --------------
  104. | Image info |
  105. --------------
  106.  
  107. This icon gives access to an information window, in which the resolution,
  108. compression technique, filename, etc. of the image is displayed.
  109.  
  110.  
  111. ----------
  112. | Pop up |
  113. ----------
  114.  
  115. This icon gives access to a submenu in which options can be set that influence
  116. the way that the image first appears when succesfully processed :
  117.  
  118. 'Auto mode'
  119.  
  120. Clicking this icon will toggle the 'auto mode' flag. When it is ON (i.e.
  121. ticked) Translator will select the most suitable mode for display of the image
  122. for you when the image appears in its window. When OFF, you can/must choose
  123. the mode yourself (possibly using the image information provided under 'Image
  124. info').
  125.  
  126. 'Auto palette'
  127.  
  128. Clicking this icon will toggle the 'auto palette' flag. When it is ON (i.e.
  129. ticked) Translator will select the 'Image palette' (see below) automatically
  130. when the image appears in its window. When OFF, the palette remains unchanged.
  131.  
  132. 'Auto zoom'
  133.  
  134. Clicking this icon will toggle the 'Auto zoom' flag. When it is ON, then
  135. Translator will attempt to zoom out (never in though) on the image so that it
  136. fits entirely on the current mode's screen.
  137.  
  138. 'View mode'
  139.  
  140. Clicking this icon will toggle the 'View mode' flag. When it is ON, then
  141. when a new image is loaded, the current mode is remembered, and is re-selected
  142. when the image window is closed.
  143.  
  144. 'Mode set'
  145.  
  146. This icon gives access to a submenu of 'mode sets'. When one of these
  147. mode sets is 'active' (default is none), selection of the mode for
  148. display of the image will be via this mode set. Each mode set consists
  149. of four mode numbers, for 2,4,16 and 256 colour display requirements
  150. of the image respectively. There are two standard sets : 'Normal' (modes
  151. 0,8,12 and 15, all 640x256 pixels) is for users of all monitors, 'Multisync'
  152. (modes 18,19,20 and 21, all 640x512 pixels) is for users of multisync
  153. monitors only. A third set is user-definable and must contain the four
  154. required mode numbers seperated by comma's (for 2,4,16 and 256 colours
  155. respectively). Selecting 'None' in this submenu will switch off the mode
  156. set option (so the 'closest' mode will always be selected, as normal).
  157.  
  158.  
  159. --------------
  160. | Processing |
  161. --------------
  162.  
  163. This icon gives access to a submenu in which options can be set that influence
  164. the way in which the image is processed :
  165.  
  166. 'Clear output'
  167.  
  168. When this icon is ticked, a 'Clear' file will be created from the next image
  169. loaded into Translator. This icon gives access to a file window, in which a
  170. Clear file may be 'opened' by dragging the filetype icon to a filer window.
  171. By clicking on this icon, Clear output is cancelled and the last opened Clear
  172. file (which is always empty at this stage) is deleted.
  173. Refer to 'Clear files' for more information.
  174.  
  175. 'Output mode'
  176.  
  177. The output mode for the image may be freely chosen. This icon gives access
  178. to a submenu, in which two choices of output mode may be selected :
  179.  
  180. - Auto
  181.  
  182. When this icon is selected (i.e. ticked), Translator will determine the
  183. best possible output mode (and palette) to display the image. For example,
  184. for pure RGB and 256 colour images, a 256 colour mode (with at least the
  185. required resolution) will be chosen for output, whereas if the image has
  186. 5-16 colours, or 3-4, or 1-2, a 16, 4 or 2 colour mode respectively.
  187. The 'Auto' setting is the default setting, as you will usually want the
  188. highest image quality.
  189. The palette is not changed in 256 colour modes (i.e. the standard palette
  190. is used, a 'principle' that can be found in more places throughout
  191. Translator), while in other modes the image's 'exact' palette is used
  192. for optimal results.
  193.  
  194. - Current
  195.  
  196. When this icon is selected (i.e. ticked), the current mode will always
  197. be used as the output mode, and thus also determines the number of colours
  198. in the resulting Archimedes image. This may be useful when the quality
  199. of the image is not of the utmost importance, but other considerations
  200. play a major role. For example, if you wish to create a desktop icon based
  201. on some image, or you want the resulting image to be usable by Artisan (which
  202. can only work in 16 colour modes, in contrast to Pro-Artisan), you may
  203. specifically select a 16-colour mode for output.
  204. When this icon is ticked, the 'Output palette' icon also gives you control
  205. over the output palette (see its discussion below).
  206. 'Error spreading' (see below) will help to still reach a result as close as
  207. possible to the original, given the limited number of colours and non-ideal
  208. palettes that may be chosen.
  209.  
  210. 'Output palette'
  211.  
  212. This icon gives access to a submenu in which a choice for the output palette
  213. may be made. NOTE : This is only effective when 'Current' is selected in
  214. the 'Output mode' submenu, as when 'Auto' is selected, Translator determines
  215. the best possible output palette.
  216.  
  217. - Current
  218.  
  219. When this icon is selected (i.e. ticked), the current palette is used for
  220. the output image. Usually this is the desktop palette (ideal for creating
  221. icons), but via either palette file loading or palette manipulation by hand
  222. (via the palette utility), any palette may be chosen. In 256 colour modes
  223. however, the output palette used is ALWAYS the standard palette.
  224. There are some example palette files for 16 colour modes in the 'Palette16'
  225. directory. These contain palettes that divide the 4 available colourbits
  226. between red, green and blue (i.e. 2,1,1 or 1,2,1 or 1,1,2 respectively),
  227. and one palette with 1 bit red, blue, green and 'tint' (amount of white).
  228.  
  229. - Default
  230.  
  231. When this icon is selected (i.e. ticked), the current mode's default palette
  232. is used (as following a VDU20). In 16 colour modes, the upper eight 'flashing'
  233. colours are not used.
  234.  
  235. - Greyscale
  236.  
  237. When this icon is selected (i.e. ticked), a greyscale from black up to
  238. full white will be used. This may be especially useful for black and white
  239. images.
  240.  
  241. 'Scaling'
  242.  
  243. This icon gives access to a submenu with a further submenu leading to the 'x'
  244. (width) and 'y' (height) scaling factors.
  245.  
  246. The scaling factors may be entered as 'multiplier:divisor' or 'multiplier'.
  247. The difference is, that the former defines an 'absolute' scaling, and that
  248. the latter (the 'simple' form) defines exactly the number of pixels you want.
  249. When using the 'simple' form, for example the X scaling ratio will (re-)appear
  250. as e.g. '100:x' when you entered '100'. This is to make clear that the exact
  251. scaling ratio is dependant upon the number of (x and/or y) pixels in the input
  252. image(s) that will be loaded subsequently.
  253.  
  254. You can define any scaling ratio you want (i.e. you can scale the image both
  255. up or down). The ratio is automatically divided down to the lowest form,
  256. so you may enter any ratio that seems convenient. For example, to scale down
  257. a, say, 640x512 pixel image to 600x480 pixels, you would enter '600:640' (or
  258. simply '600') and '480:512' (or simply '480') for 'x' and 'y' respectively.
  259.  
  260. Using the 'simple' form, it is possible to scale all subsequently loaded
  261. images (down or up) to an image with a fixed resolution. The 'absolute' form
  262. enables a fixed scaling to be defined for all subsequently loaded images.
  263.  
  264. When scaling is active (i.e. not 1:1), the 'Scaling' icon will be ticked.
  265. Clicking on the '1:1' icon will reset the scaling factors to normal (both x
  266. and y 1:1), while clicking on any of the remaining icons will select a preset
  267. scaling for both x and y (i.e. 1:2, 2:1, etc.).
  268.  
  269. When scaling without error spreading being active, obviously pixels are simply
  270. discarded (when scaling down) or duplicated (when scaling up). Usually, in
  271. this case, you can do the scaling equally well by using the scaling options of
  272. the save functions (which do exactly the same).
  273. However, when error spreading is active, you are likely to get a much better
  274. quality if you pre-scale the image (by setting the appropiate scaling factors
  275. here) and THEN save it (in full). This is because, after error spreading,
  276. every pixel's 'neighbor(s)' usually contains a correction for the pixel's
  277. true colour. When scaling down/up with the 'Save' or 'Zoom' options, you just
  278. lose or duplicate these 'neighbor' pixels and the error spreading effect may
  279. be either completely lost (when scaling down, because the corrections in
  280. the discarded pixels are lost) or not optimal (when scaling up, because all
  281. the duplicated pixels could have been used to more finely spread errors).
  282.  
  283. 'Error spreading'
  284.  
  285. This icon gives access to a submenu, in which Translator can be set to use
  286. one of two kinds of error spreading, or none. The icon is 'ticked' if error
  287. spreading is enabled.
  288. When either error spreading is on (i.e. ticked), errors made by the
  289. approximation of the input pixels' RGB valus in all output modes are spread
  290. out (locally) over the image. This usually results in images with a much higher
  291. quality, so you will usually leave error spreading on.
  292. When you switch it off only the best approximations to colours are used, and
  293. the errors made will be completely ignored. You may want to do this to compare
  294. results. When there are enough colours and the ideal palette can be selected,
  295. i.e. always in non-256 colour modes when 'Auto' mode is on (see above), error
  296. spreading will have no effect, as there will be no errors.
  297. There are two choices of error spreading available, which differ in the way
  298. they spread the approximation errors :
  299.  
  300. - 'Simple'
  301. This spreads out the errors along the same pixel row only. In fact, it gives
  302. one of its neighbor pixels the full error factor, as follows :
  303.  
  304. ------------------------------------------
  305. |           | Current pixel | full error |
  306. ------------------------------------------
  307.  
  308. This is the fastest of the two, and gives very good results.
  309.  
  310. - 'Floyd Steinberg'
  311. Floyd Steinberg error spreading, devised by R.W. Floyd and L. Steinberg,
  312. spreads the errors made more intelligently. It divides the error factors
  313. among four neighbor pixels (instead of one), as follows :
  314.  
  315. -------------------------------------------------
  316. |               | Current pixel | 7/16 of error |  <-- current line
  317. -------------------------------------------------
  318. | 3/16 of error | 5/16 of error | 1/16 of error |  <-- next line
  319. -------------------------------------------------
  320.  
  321. The results are usually better than when using 'Simple' error spreading, but
  322. to which degree depends heavily on the type of image. Digitised images will
  323. usually benefit much less than 'drawn' images. The penalty is that it is
  324. computationally much more expensive than 'Simple' error spreading, so you'll
  325. have to wait a few seconds longer.
  326.  
  327. 'Black and white'
  328.  
  329. Clicking this icon toggles the 'black and white' flag. When it is ON (i.e.
  330. ticked), Translator translates colour images to grey images. In >16-colour
  331. images, this gives very good results when used in combination with error
  332. spreading. For images with 16 or less colours, only the palette is changed
  333. to the closest greys.
  334.  
  335. 'Zig zag'
  336.  
  337. Clicking this icon will toggle the 'zig zag' flag. When it is ON, and error
  338. spreading is also ON, every other line will be plotted in the opposite
  339. direction, i.e. left to right, then right to left, then left to right again,
  340. etc.. This reduces the chances of patterning effects in the final image.
  341. Sometimes, however, the effect is not so pleasing, so you may switch it off.
  342. When OFF, lines are always plotted left to right.
  343.  
  344. 'RGB resolution'
  345.  
  346. This icon gives access to a window in which the amount of red, green and blue
  347. in the resulting image can be defined. The slider values for red, green and
  348. blue represent the number of bits (0-8) of the corresponding primary colour
  349. that are 'let through' in the final image. You can drag the sliders to change
  350. the number of bits (a full bar is 8 bits).
  351. For example, red=8, green=0, blue=0 will give a red seperation of the input
  352. image, i.e. only the red components of the colours are let through. Depending
  353. on how many bits are reserved for each of the primary colours in each graphics
  354. format (mostly 8 bits giving 24-bit RGB, but sometimes 4 bits or less), a
  355. large range of effects and colour seperations can be achieved.
  356.  
  357. 'Screen blanking'
  358.  
  359. Clicking on this icon toggles the 'Screen blanking' flag. When it is ON (i.e.
  360. ticked), the screen will be blanked while unpacking an image. This may speed
  361. up the unpacking considerably when working in high resolution modes (with high
  362. video DMA overheads). When it is OFF (default), the screen will not be blanked
  363. while unpacking (so you'll have to wait a bit longer...).
  364.  
  365. 'Invert RGB'
  366.  
  367. Clicking on this icon toggles the 'Invert RGB' flag. When it is ON (i.e.
  368. ticked), the colours in the image will be processed 'inverted'. This results
  369. in 'negative' images for both colour and black and white images.
  370.  
  371. 'GIF scan'
  372.  
  373. Clicking on this icon toggles the 'GIF scan' flag. When it is ON (i.e. ticked),
  374. GIF files are scanned to count the number of pictures in them. This number will
  375. appear in the image information. When the GIF image contains more than one
  376. image (which is rare), you may select one by using the 'Image number' option
  377. (see below). When OFF, GIF files are NOT scanned, and are assumed to contain a
  378. single image (which is usually so). This has the advantage of substantially
  379. reducing the loading time. The image info will reflect the unknown number of
  380. images in the file by displaying a '?' instead of the image count.
  381.  
  382. 'Image number'
  383.  
  384. GIF image files may contain more than one image, and Archimedes sprite files
  385. may contain more than one sprite. When this is the case, the image info window
  386. will indicate this. By default the first image or sprite is displayed, but,
  387. by altering this writable icon to 'n', the n-th image or sprite will be
  388. chosen when the file is (re)loaded into Translator. When the nth image is
  389. not present, Translator will complain (except when dealing with GIF files and
  390. the 'GIF scan' flag is OFF).
  391.  
  392. 'Percentage'
  393.  
  394. Clicking on this icon toggles the 'Percentage' flag. When it is ON (i.e.
  395. ticked), the hourglass shows a percentage indicating the amount of rows
  396. that have been 'built' so far. It does not always indicate how much of the
  397. processing is done, for example, GIF first decompresses all the image data
  398. before building the rows.
  399.  
  400.  
  401. -----------------
  402. | Image Palette |
  403. -----------------
  404.  
  405. Clicking on this icon selects the currently loaded image's own (or 'output')
  406. palette. It is selected by default when the 'Auto palette select' flag is
  407. on, after the image is loaded. Note that this MAY make things badly (or not
  408. at all!) visible (e.g. menu's, etc.). Re-selecting the image's palette may
  409. be necessary after using the desktop's palette utility (e.g. 'Default') or
  410. when some other application changes the palette.
  411.  
  412.  
  413. --------------
  414. | Zoom image |
  415. --------------
  416.  
  417. This icon gives access to a submenu of zoom options :
  418.  
  419. 'In', 'Out'
  420.  
  421. These icons give access to zoom in and zoom out options respectively. Zooming
  422. takes place in steps of 2 (i.e. 2 times, 4 times, 8 times enlarged/reduced,
  423. etc.). By clicking one of the icons given in their submenu's, zooming can be
  424. performed in x ('x') or y ('y') directions individually, or both at the same
  425. time ('Both').
  426.  
  427. '1:1'
  428.  
  429. Clicking this icon will reset the zoom factors to 1 (i.e. the image is neither
  430. enlarged nor scaled down).
  431.  
  432.  
  433. -------------
  434. | Magnifier |
  435. -------------
  436.  
  437. Clicking on this icon pops up the magnifier window. The magnifier window shows
  438. a (magnified) part of the image. By clicking either SELECT or ADJUST within
  439. the image window, the area around the point clicked on will appear in the
  440. magnifier window, with the point itself in the middle. You can shift through
  441. the image by holding the button down and moving the pointer.
  442. The magnifier window starts up at 1:1, and the magnification may be increased
  443. by clicking SELECT or decreased by clicking ADJUST, within the magnifier
  444. window. The MENU button will select 1:1 magnification.
  445. The magnifier enables you to examine image areas with ease.
  446.  
  447.  
  448. ----------------
  449. | Rotate image |
  450. ----------------
  451.  
  452. This will rotate the image clockwise by 90 degrees. This may be convenient with
  453. high-and-narrow images (especially on normal monitors), so more of the image
  454. can be on-screen without you having to use the scroll bars.
  455.  
  456.  
  457. ----------------
  458. | Mirror image |
  459. ----------------
  460.  
  461. This icon gives access to two mirror options. Clicking 'x' will mirror the
  462. image horizontally, while 'y' will mirror it vertically.
  463.  
  464.  
  465. -------------------
  466. | Include palette |
  467. -------------------
  468.  
  469. Clicking this icon will toggle the 'include palette' flag. When it is ON (i.e.
  470. ticked) any saves will save the current palette with the sprite. When OFF, no
  471. palette is saved with the image.
  472.  
  473.  
  474. --------------
  475. | Save image |
  476. --------------
  477.  
  478. This icon gives access to a submenu of five ways in which (part of) the
  479. image may be saved :
  480.  
  481. 'Full'
  482.  
  483. This will save the whole image as a single sprite, exactly as it is stored
  484. internally (i.e. without losing pixels). The sprite can then be used
  485. in full (e.g. dumped to a printer with suitable software), or scaled as
  486. required by another application (e.g. a DTP package). The palette saved
  487. (when the 'include palette' flag is ON) will always be the image's own
  488. palette (not the current one, as with the other 'saves').
  489. NOTE : In 256 colour modes, the palette will NOT be saved, regardless of
  490. the 'Include palette' flag, as Translator never changes the palette in
  491. these modes.
  492.  
  493. 'Whole', 'Whole (scaled)', 'Part', 'Part (scaled)'
  494.  
  495. These will display the image on the current mode's screen, using the
  496. currently selected palette, and save an editable part of the on-screen
  497. image to a sprite file.
  498. By selecting one of these four 'saves', you can choose whether or not you
  499. want to scale the image (the '(scaled)' saves will let you do this), and
  500. whether or not to cut out a specific piece (the 'Part' saves will let you
  501. do this, the 'Whole' saves won't), prior to saving.
  502. The palette saved (if the 'include palette' flag is ON) will be the
  503. current one, i.e. a la *SCREENSAVE. While scaling and/or cutting, the mouse
  504. pointer will continuously show the size of the scaled or cut-out image in
  505. pixels, or the pixel coordinates of the mouse pointer before clicking on
  506. the top left corner of a cut-out.
  507.  
  508. Saving is done by dragging the sprite file icon (which appears before any
  509. scaling or cutting is done) to a directory viewer. Alternatively, you may
  510. save the image sprite directly into another application (e.g. !Paint), by
  511. dragging it to the application's iconbar icon or one of its windows.
  512.  
  513.  
  514. ----------
  515. | Status |
  516. ----------
  517.  
  518. This icon gives access to a submenu of status handling functions. A default
  519. status can be created, which contains the Auto mode select, Auto palette
  520. select, Error spreading, Black and white, Auto zoom, View mode, Screen
  521. blanking, Invert RGB, GIF scan, Include palette and Zig zag flags and the
  522. Mode set.
  523.  
  524. The 'Save' option will save the current status of the abovementioned items as
  525. the default. This default status file (when present) will be loaded on
  526. startup, or explicitly with the 'Load' option in the submenu (to override
  527. the current ones). The 'Kill' option will remove the default status file,
  528. so the 'standard' (Translator) defaults will be used on the next startup.
  529.  
  530.  
  531. -------------
  532. | Hourglass |
  533. -------------
  534.  
  535. The hourglass is normally displayed when any processing is done. In addition,
  536. during image processing, the top 'LED' will be 'on' when data is being
  537. loaded from disc. It will be 'off' when processing is taking place. Also,
  538. when the 'Percentage' flag is on, during buildup of the image rows the
  539. percentage of rows done so far will show in the hourglass.
  540.  
  541.  
  542. ---------------
  543. | Clear files |
  544. ---------------
  545.  
  546. Translator can output its own graphics file format, called 'Clear' (filetype
  547. &690). I devised this (simple to use) new filetype because of several
  548. shortcomings of Archimedes sprite files (which were the only output) :
  549.  
  550. - Pure RGB input (Amiga IFF HAM, QRT, ArVis) at best ends up in a 256 colour
  551.   sprite with standard palette on which error spreading has been applied.
  552.   This loses a lot of image information.
  553. - 'Palette and pixel value' input (i.e. the rest of the formats) always lose
  554.   any extra bits in their palette definitions if they use more than 4 per
  555.   primary colour (which is the maximum on the Archimedes). In addition, output
  556.   in 256 colour sprites will always lose palette definition because of the
  557.   inability to fully define all 256 colours (and thus the error spreading
  558.   makes the best out of the standard palette).
  559.  
  560. Without being able to output a 'fully accurate' filetype, it would thus be
  561. impossible, in most cases, to retain the full resolution (both in terms of
  562. pixels and colour definition) of input images. This may be essential if
  563. the images that Translator can read are to be put to more serious use, for
  564. example image manipulation, or conversion to other formats (!MakeGIF and
  565. !MakeTIFF !).
  566.  
  567. Also, I envisaged that it should be very easy to extract the image data from
  568. this 'fully accurate' format, so people can quickly and easily write simple
  569. programs to process it (i.e. no compression, no 'pixel value packing', etc.).
  570.  
  571. The 'Clear' graphics format was devised because of all this, and holds either
  572. pure 24-bit RGB data or byte-wide pixel values with a 24-bit RGB palette (one
  573. entry per pixel value). The full format is as follows (the descriptions
  574. are necessarily 'formal' to avoid misinterpretation, the format is actually
  575. extremely simple) :
  576.  
  577. Offset  Bytes   Description
  578. ----------------------------------------------------------------------------
  579. 0       m       Maker (string, e.g. 'Translator')
  580. m       1       0 (string terminator)
  581. m+1     4       Version number (600 currently, i.e. 6.00)
  582. m+5     4       Width of image in pixels (w)
  583. m+9     4       Height of image in pixels (h)
  584. m+13    4       Bits per pixel (bpp)
  585.                 If 1<=bpp<=8, then 24-bit palette entries for all colours
  586.                 follow (i.e. n=3*2^bpp, and l (bytes per pixel) is 1).
  587.                 If bpp>8, then pure 24-bit RGB is stored, which needs no
  588.                 palette (i.e. n=0, and l (bytes per pixel) is 3)
  589. m+17    n       Palette entries for all colours (only if 1<=bpp<=8), which
  590.                 are triples of byte values (0=off, up to 255=full intensity)
  591.                 per primary colour, red first, then green, then blue.
  592.                 For example, when 'Rx','Gx' and 'Bx' represent the intensities
  593.                 of red, green and blue respectively for colour x, the palette
  594.                 for 4 colours (bpp=2) would be stored :
  595.                 R0,G0,B0, R1,G1,B1, R2,G2,B2, R3,G3,B3.
  596. m+17+n  w*h*l   Pixel values, representing the image rows from top to bottom
  597.                 and every row from left to right.
  598.                 If l=1, every pixel value is a byte representing the colour
  599.                 number/index.
  600.                 If l=3 (pure 24-bit RGB), data is stored like the palette
  601.                 entries, i.e. red first, then green, finally blue, all
  602.                 byte values (0-255) representing the intensity of the
  603.                 corresponding primary colour for that pixel.
  604. ----------------------------------------------------------------------------
  605.  
  606. In the case of pure 24-bit RGB storage (i.e. bpp>8), bpp represents the
  607. bits of RGB resolution of the original image (i.e. 12 for Amiga IFF HAM mode,
  608. 15 for ArVis and 24 for QRT currently). If there are less than 8 bits per
  609. primary colour, lower bits are set to 0 (but do not try to deduce how
  610. many per primary colour if you don't know what the original image was).
  611. For example, in the case ofáArVis' 15 bits RGB (5 bits each for red, green
  612. and blue), the lower three bits of each pixel value are set to 0 when
  613. Translator creates the Clear file.
  614.  
  615. When 1<=bpp<=8, only the lower 2^bpp pixel values of the 256 available
  616. are used.
  617.  
  618. Clear files are always 'pure' representations of the input images, i.e.
  619. error spreading, black and white conversions, etc. are NEVER applied,
  620. even if they are 'on'.
  621.  
  622. Clear files DO obey the scaling factors you have set however, so that you
  623. may easily create Clear files of, for example, a specified number of pixels.
  624. For example, you may scale images to 256x256 pixel Clear files and then let a
  625. simple program (calculating greyvalues out of the pixels' RGB values) turn
  626. them into AIM files.
  627.  
  628.  
  629. -----------------------
  630. | Memory requirements |
  631. -----------------------
  632.  
  633. Translator starts up taking a minimum amount of RAM. As and when images
  634. are loaded/discarded, extra memory is claimed/released, as follows :
  635.  
  636. - When an image is loaded, all available memory is grabbed (to ensure maximum
  637. file buffer sizes), and an attempt is made to load the image. When there is
  638. too little memory available, Translator will complain. After loading (which
  639. may or may not be succesful), all memory that is not needed anymore (i.e. all
  640. but the internal image sprite) is returned to the system.
  641.  
  642. - When an image is discarded, i.e. by closing the image window, the memory
  643. taken up by the internal image sprite is also released.
  644.  
  645. This memory allocation strategy ensures that
  646.  
  647. a) all available memory is used to speed up processing
  648. b) Translator runs in the minimum amount of memory needed
  649. c) you do not need to worry about how much memory to allocate to Translator
  650.  
  651.  
  652. ---------------------
  653. | Mode independance |
  654. ---------------------
  655.  
  656. When the 'ideal' mode cannot be selected (usually because of screen memory
  657. shortage), a beep will sound and succesively lower resolution modes with the
  658. right number of colours are tried by Translator (as, within the WIMP
  659. environment, there is no telling how much memory can and will be allocated
  660. to the screen by the WIMP/desktop system).
  661.  
  662. Once an image has been created, it can be displayed in any mode. In modes
  663. with the 'wrong' number of colours, Translator attempts to display the
  664. image as well as possible, as follows :
  665. - If the number of available colours is larger than the required number of
  666. colours for the image, the 'lower' part of the palette is set (<=16 colour
  667. modes) or (256 colour modes) the closest available standard colours are
  668. selected.
  669. - If there are too few colours (i.e. only in <=16 colour modes), the most
  670. frequently used colours (the 'base' colours) in the image will determine
  671. the palette, and the remaining colours will be mapped to the closest base
  672. colour. This gives acceptable results for most images (for 256-colour images
  673. in 16, 16 in 4, or 4 in 2 colour modes), up to perfect results for 256-colour
  674. grey images (for example with the black and white option on) in 16 colour
  675. modes (as it is only ever possible to display 16 different greyvalues, also
  676. in 256 colour modes).
  677.  
  678. Of course, if you really want a non-ideal mode to save your image in,
  679. selecting it as the output mode in the first place (see 'Output mode'
  680. and 'Output palette') gives much better results !
  681.  
  682.  
  683. ----------------
  684. | Sprite files |
  685. ----------------
  686.  
  687. Archimedes sprites may not have a palette. If they don't, the standard
  688. palette settings in the sprite's mode is used. The palette of 256-colour
  689. sprites is always ignored (the standard one is always used). Also, if the
  690. mode contained in the sprite is a valid one (i.e. it is a valid WIMP mode
  691. and it is available on your monitor), then this is used by default. If
  692. the mode is not valid, then the 'closest' mode is determined and used as
  693. usual.
  694.  
  695.  
  696. -----------
  697. | The end |
  698. -----------
  699.  
  700. If you have praise, complaints, comments, bugs(!) or information about other
  701. formats to offer me, do not hesitate to write to
  702.  
  703. John Kortink
  704. Middelhuisstr. 17
  705. 7482 EL Haaksbergen
  706. The Netherlands
  707.  
  708. New versions are available from the same address : just send some money
  709. to cover postage and a self-addressed envelope containing a 3.5" disc. As
  710. this application is under continuous development, you are very likely to
  711. get a more recent version !
  712.  
  713. Happy imaging !!!
  714.  
  715. _______________________________________________________________________________
  716.  
  717. !!! NOTE !!!
  718.  
  719. You may NOT change this application or use ANY part of it in other products
  720. without my approval. You may spread it freely (with *ALL* files included), but
  721. not for any profit. This software is provided 'as is'. Using it is entirely at
  722. your own risk.
  723.  
  724. _______________________________________________________________________________
  725.  
  726.