home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma01.dms / ma01.adf / wasp / misc / PARAMETERS < prev    next >
Text File  |  1991-12-29  |  4KB  |  92 lines
  1. explanation of the parameter options:
  2.  
  3. -cmeth:
  4.  
  5. possible values:
  6. COUNTMETH_ALL_1        all1
  7. COUNTMETH_ALL_DIF    alldif
  8. COUNTMETH_ALL_FIXDIF    allfdif
  9. COUNTMETH_JUMP_1    j1
  10. COUNTMETH_JUMP_21    j21
  11. COUNTMETH_JUMP_DIF    jdif
  12. COUNTMETH_JUMP_DIFSH    jdifsh
  13. COUNTMETH_JUMP_FIXDIF    jfdif
  14. COUNTMETH_JUMP_FIXDIFSH    jfdifsh
  15. YET TO EXPLAIN        hmgs
  16. YET TO EXPLAIN        hmcubic
  17.  
  18. defaults:
  19. #define DEF_HAMCOUNTMETH        COUNTMETH_ALL_FIXDIF
  20. #define DEF_NONHAMCOUNTMETH     COUNTMETH_ALL_1
  21.  
  22. COUNTMETH_ALLs count all pixels, COUNTMETH_JUMPs count only pixels
  23. whose color differs from the color of the previous pixel in at least two
  24. of the components red, green and blue.
  25. COUNTMETH_.._1s count all pixels as 1, COUNTMETH_.._DIFs and 
  26. COUNTMETH_.._FIXDIFs take the absolute difference of the color of the current
  27. pixel and the color of the previous pixel, in the red, green and blue components,
  28. eg. greendif=abs((curcolor&0x0f0)-(prevcolor&0x0f0)),
  29. COUNTMETH_.._DIFs count as greendif+reddif+bluedif, COUNTMETH_.._FIXDIFs count as
  30. the sum of the least two of greendif, reddif and bluedif.
  31. COUNTMETH_JUMP_21, 421, 8421, DIFSH and FIXDIFSH all use shifting, for example
  32. COUNTMETH_JUMP_421 counts the pixel where the jump occurs as 4, the next one as 2,
  33. the next one as 1, even when no further jump occurs. If two jumps occur right behind
  34. each other, the shift value is reset, so the first jump would count as 4, the second
  35. jump as 4 too, and the next two pixels as 2 and 1.
  36. DIFSH and FIXDIFSH count the first jump pixel in the same way as their non-shifting
  37. pals DIF and FIXDIF do, then dividing this value by two (shifting it a pixel) for each
  38. successive pixel, until the shift value becomes 0.
  39.  
  40. -threshold:
  41.  
  42. possible values: 0 .. MAX_UNSIGNED_LONG
  43. default: 1
  44.  
  45. Only colors which occur at least threshold times are used by the color distribution,
  46. except when doing so would cause a number of color registers to be unused, in that
  47. case wasp will try to find the lowest possible threshold resulting in at least 16
  48. different colors, in ham or hires mode, or at least 32 different colors, in lores
  49. mode.
  50.  
  51. -dmeth:
  52.  
  53. possible values:
  54. DISTRMETH_MOSTUSED    mu
  55. DISTRMETH_WORSTFIRST    wf
  56. DISTRMETH_EHB        ehb
  57. YET TO EXPLAIN        mue
  58. DISTRMETH_HAMSHARP    hs
  59. DISTRMETH_CONTRACTION    con
  60.  
  61. default:
  62. #define DEF_DISTRMETH         DISTRMETH_WORSTFIRST
  63.  
  64. When the number of different colors is larger than the number of color registers
  65. available, colors will have to be distributed between the color registers.
  66. DISTRMETH_MOSTUSED fills the nregs color registers with the nregs colors which
  67. occur most.
  68. DISTRMETH_WORSTFIRST assigns the two first color registers to the
  69. two colors with the largest (manhattan) distance between them, the next color
  70. register is filled with the color with the largest distance to any of the used
  71. color registers, this process is repeated until all color registers are filled.
  72. Then it goes on to group all colors according to closest color register,
  73. the weighted average of all colors belonging to a certain color register forms the 
  74. new contents of the color register.
  75. DISTRMETH_EHB is a modification of DISTRMETH_WORSTFIRST, to be used for conversion
  76. to EHB only, and the only distribution method that can be used to convert to EHB.
  77. Basically it does the same as DISTRMETH_WORSTFIRST, but when it has found a color
  78. that has the largest distance to any of the used color registers at that moment it
  79. fills one color register with this color, and another color register with the same
  80. color with the red, green and blue values each shifted one bit to the right, or with
  81. the red, green and blue values each shifted one bit to the left. In this way the color
  82. registers are filled in pairs.
  83. DISTRMETH_HAMSHARP computes x, the number of different colors used in the picture
  84. divided by the number of color registers, then fills the first color register with
  85. the color which has the smallest total difference to x used colors, including itself.
  86. It then marks these x colors as done and repeats the process until all color registers
  87. have been filled. It recomputes the color registers by grouping and averaging in 
  88. exactly the same way DISTRMETH_WORSTFIRST does.
  89. DISTRMETH_CONTRACTION repeatedly contracts the two colors closest to each other to
  90. a new color, by weighted averaging the two colors, until the number of remaining colors
  91. equals the number of color registers.
  92.