home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / palmaker / !PalMaker / !Help < prev    next >
Text File  |  1993-06-03  |  15KB  |  354 lines
  1. PalMaker 1.14 (3 Jun 1993) Copyright Ferdinand Oeinck
  2. ------------------------------------------------------
  3.  
  4. New in this version:
  5.  
  6. - the octree datastructure is moved entirely into flexblocks. Because
  7.   the Octree algorithm is used in all quantization routines (the
  8.   colours are so nicely sorted in an octree), the wimpslot, after
  9.   !PalMaker is ready with it's calculation, is decreased further from
  10.   approx. 192 Kb to approx. 96 Kb. when using Heckbert quantization.
  11.   When using Octree or Variance quantization the wimpslot will mostly
  12.   stay at 64Kb.
  13.  
  14. - !PalMaker is now a real RISC OS 3.10 task.
  15. - Iconbar icon is a 256 colour sprite.
  16.   
  17.  
  18. PalMaker 1.13 (24 May 1993) Copyright Ferdinand Oeinck
  19. ------------------------------------------------------
  20.  
  21. New in this version:
  22.  
  23. - When the 'GiveBox' menu entry is chosen, PalMaker waits for the input
  24.   of the 'area of interest' rectangle. In previous versions there was no
  25.   way to abort this waiting, in the case the menu entry was chosen
  26.   premature or by accident.
  27.   In this version one can press the 'Adjust' mouse button to abort the
  28.   'waiting for a rectangle process'.
  29.   This holds too, when the dragging of the rectangle has already started.
  30.   Instead of releasing the 'Select' button to stop the drag, one presses
  31.   the 'Adjust' button while still pressing 'Select'.
  32.   
  33.  
  34. PalMaker 1.12 (24 Apr 1993) Copyright Ferdinand Oeinck
  35. ------------------------------------------------------
  36.  
  37. New in this version:
  38.  
  39. - New iconbar icon!
  40. - Moved more memory into flexblocks.
  41.   Wimpslot now is maximal 192Kb (was 288Kb in version 1.11).
  42. - mouse clicks during redraw sequences and calculation are filtered out,
  43.   so no user intervention possible during multi-tasking redraw sequences. 
  44.   This is because when the MENU button is pressed by accident, the menu
  45.   will open over the window of interest (we cannot see that because
  46.   VDU output is swiched), and so the palette is not optimal.
  47.  
  48. - Bug in 1.11: Test sprites were saved in <PalMaker$Dir>.stmp (cured)
  49. - Bug in 1.09 - 1.11: Removing of pane(tool)-window(s) from ArtWorks crashed
  50.   PalMaker (cured)
  51.  
  52. PalMaker 1.11 (23 Apr 1993) Copyright Ferdinand Oeinck
  53. ------------------------------------------------------
  54.  
  55. New in this Version:
  56.  
  57. - another colour quantization routine added. It can be selected
  58.   from the Control submenu by choosing 'Variance'.
  59.  
  60.   It uses always a 5 bit histogram (32 * 32 * 32 * 4 = 128 Kb) and
  61.   needs about 110 Kb extra space for holding statictical information.
  62.  
  63.   This variance algorithm is based on:
  64.  
  65.         Wan, Wong, and Prusinkiewicz,
  66.         "An Algorithm for Multidimensional Data Clustering",
  67.         Transactions on Mathematical Software, Vol. 14 #2 (June, 1988), pp. 153-162.
  68.  
  69.   The results a better than the Octree or Heckbert approach. Although it is
  70.   somewhat slower in execution because of lots of floating point operations.
  71.   (No problem when the FPA arrives, then it will be approx. 40 times faster!)
  72.  
  73.   Important is that it makes virtually no difference to the resulting palette
  74.   if the anti-aliasing option from ArtWorks is on or off. And this is certainly
  75.   not the case with the two other quantization algorithms, which give a worser
  76.   palette with anti-alisaing on. 
  77.  
  78.  
  79. PalMaker 1.10 (19 Apr 1993) Copyright Ferdinand Oeinck
  80. ------------------------------------------------------
  81.  
  82. New in this Version:
  83.  
  84. - When using !PalMaker on a non-Artworks non-Draw programme in 24 bpp
  85.   mode, the programme could not know that a palette change had occured.
  86.   This is now cured. !PakMaker now issues a message_palettechanged to the
  87.   programme, so it can update it's own internal colourtables for use in
  88.   for example sprite plotting.
  89.  
  90.  
  91. PalMaker 1.09 (15 Apr 1993) Copyright Ferdinand Oeinck
  92. ------------------------------------------------------
  93.  
  94. New in this Version:
  95.  
  96. - when using !PalMaker on an ArtWorks window and the window has
  97.   any tool(pane)-windows attached to it, !PalMaker will remove
  98.   the tool-windows, so you don't have to remove them anymore before
  99.   using !PalMaker. This is not the case for !Draw!
  100.  
  101.  
  102. PalMaker 1.08 (13 Apr 1993) Copyright Ferdinand Oeinck
  103. ------------------------------------------------------
  104.  
  105. In this new version (1.08) there are some very important improvements:
  106.  
  107. - Rendering of window-area of interest forced in a sprite (by using the
  108.   'switch output to sprite' approach), so no annoying palette changes
  109.   anymore for the monitor.
  110. - No user clicks anymore needed to signal end of redraw.
  111. - Works in all monitor screen modes.
  112. - New fast 15 bit per pixel 32000 colour option (only for Artworks or
  113.   Artworks file viewers).
  114. - New Heckbert 5 or 6 bits chroma switch.
  115. - Choices can be saved.
  116.  
  117.  
  118. How to do:
  119.  
  120. The procedure to get a 256 colour palette is still the same. Get the
  121. interesting part of the document visible in it's window.
  122.  
  123. IMPORTANT: remove any PANE-WINDOW(S) from the window of interest!
  124.  
  125. Now choose the number of bpp (24 or 15, 15 only with ArtWorks) and the
  126. quantization routine (Octree, Heckbert6 or Heckbert5) from the Control
  127. submenu. Fastest setting is 15 bpp and Heckbert5 quantization.
  128.  
  129. Choose the 'givebox' menuentry from PalMakers main-menu. And drag a
  130. rectangle to mark the area.
  131.  
  132. IMPORTANT: the start and endpoint of the drag has to be INSIDE the
  133.            window of interest, otherwise PalMaker will issue an error!
  134.  
  135. Now wait until the Hourglass stops and the palette is ready. If you are
  136. in a non 256 colour mode, switch to one and choose 'set' from PalMaker's
  137. main-menu.
  138.  
  139. What happens internally:
  140.  
  141. Immedialty after the rectangle drag has finished PalMaker switches the
  142. VDU output to a sprite and re-opens the window of interest translated
  143. so, that the bottom-left corner of the rectangle lies on point (0,0) in
  144. the sprite. A 'forceredraw' is issued for the window. Any open pane-
  145. window(s) will cover the window of interest because they are not opened
  146. outside the screen! So be sure there are no pane-windows connected to
  147. the left or bottom side of the window of interest!
  148.  
  149. 15, 24 bpp:
  150.  
  151. Depending on the bpp mode PalMaker is in (15 or 24) see main-menu item:
  152. 'Control->' redraw will be forced one or three times. See the Houglass
  153. changing colour from red, green to blue when in 24 bpp mode.
  154.  
  155. The 24 bpp mode can be used for any document drawing package. The 15 bpp
  156. mode can only be used when an Artworks file renderer is reponsible for
  157. the image rendered in the window of interest (!ArtWorks, !Impression or
  158. !AWViewer). When using !ArtWorks or !AWViewer be carefull about the
  159. fonts in 15 bpp mode. Make first shapes of any texts you want the correct
  160. colour for. When there are no blended objects in the file this can be done
  161. fast by selecting all objects and choosing the menuentry 'MakeShapes'.
  162.  
  163. IMPORTANT: !ArtWorks uses the RISC OS fontmanager and that doesn't
  164.            understand 15 bpp screenmodes, so the output palette is not
  165.            correct. When ArtWorks itself is in 'Preview' mode, the display
  166.            of fonts is correct and I suspect, when ArtWorks knows it is in
  167.            a 32000 colour preview mode it does a trick to display the fonts
  168.            correct. PalMaker cannot tell ArtWorks directly about the 32000
  169.            colour mode, but can only tell the low-level 'DitherExtend' and
  170.            other modules about the forced mode change by issuing a
  171.            'Service_ModeChange' after the VDU output was switched to a
  172.            sprite. This service call has no effect at all on the 'FontManager'
  173.            and 'FontDraw' modules, so they think they are still in a 4 or 8
  174.            bpp screenmode! CC has to do something about this.
  175.  
  176. Multi-tasking:
  177.  
  178. When PalMaker forces the remote redraws it signals this with the top led
  179. in the hourglass pointer. Be carefull what you do with the mouse pointer
  180. during the redraws. Because !Artworks can render multi-tasking PalMaker has
  181. to call the WIMP poll loop. Any mouse clicks during the remote redraws can
  182. pop up window(s) over the window of interest! This can not be seen as the
  183. VDU output is switched to a sprite. So be carefull.
  184.  
  185. Heckbert quantization:
  186.  
  187. One can choose now between 'Heckbert6' and 'Heckbert5' quantization routines.
  188. The difference is: Heckbert6 uses a 6 bits luminance and 6 bits chroma histogram.
  189. This r