home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / i / image / !Image / Docs / P17 < prev    next >
Encoding:
Text File  |  1994-08-15  |  5.3 KB  |  123 lines
  1.  
  2. The Kernel Operation Control Window
  3. -----------------------------------
  4.  
  5. The Kernel Operation Control Window allows you to create and perform
  6. kernel operations (see 'Kernels' for a description of a kernel
  7. operation).
  8.  
  9. On the left of the window is an area for displaying the current kernel
  10. operation. It contains the name of the current kernel at the top, and
  11. below this are nine icons (arranged in a 3x3 grid) which contain the
  12. kernel mask.
  13.  
  14. Below the mask are two further icons, one for the multiplier and one
  15. for the divider. To the right of these is an icon marked 'Auto' which
  16. (as described in 'Kernels') automatically sets the multiplier and
  17. divider values to produce an operation which maintains overall intensity.
  18.  
  19. On the top right of the window is a scrollable list of all kernel
  20. operations known to Image. If you select any of the listed names, the
  21. kernel operation is copied into the display icons on the left of the
  22. window.
  23.  
  24. Below this list are icons marked 'Create' and 'Save'. These icons
  25. allow add new kernel operations to the list, and also save them for
  26. future use.
  27.  
  28. When you select the 'Create' icon the current kernel operation (as
  29. defined on the left hand side of the window) is added to the list of
  30. operations (unless it already exists, in which case it is updated).
  31. Selecting 'Save' will save the whole list so that the list of kernels
  32. will be preserved when you quit 'Image'.
  33.  
  34. Finally to the left of the 'Create' and 'Save' icons is an icon marked
  35. 'Run'. This icon, when selected, makes Image take the current mask
  36. operation and perform it on the input image bank, placing the output
  37. in the output image bank (and displaying the result).
  38.  
  39. Notes:
  40.  
  41. The nine kernel mask positions can accept values between -255 and 255.
  42. The central mask value can also be proceeded be either '<' or '>' (see
  43. 'Kernels' for the meaning of these options) in which case the value
  44. following should be a value between 0 and 255. Only whole numbers are
  45. allowed.
  46.  
  47. The multiplier and divider values can be any value from -255 to 255 -
  48. note the value 0 as a multiplier will produce a meaningless operation,
  49. and a divider of 0 will not be accepted (a value of 1 will be used
  50. instead).
  51.  
  52. The outside pixels of an image will not be affected by a kernel
  53. operation, this is due to the fact that these pixels don't have enough
  54. neighbours. Also masked areas of an image will be preserved during a
  55. kernel operation.
  56.  
  57. You can not permanently alter the default kernel definitions from within Image
  58. (the 'Save' operation only saves user defined kernels). In fact there are two
  59. files used to store kernels, one supplied with Image (in the resources
  60. directory within the Image application) and a user defined file which is
  61. located inside Image's 'Working' directory. Both files are called 'Kernels'
  62. and can be edited by the user if they require (this is currently the only way
  63. to delete kernels, or alter the supplied kernels).
  64.  
  65.  
  66. The Kernel File format
  67. ----------------------
  68.  
  69. If you feel the need to edit the internal kernel files the format is as
  70. follows. The file is a text file containing one definition per text line.
  71. Each definition is made up of a name followed by 11 values (all separated by
  72. commas). The first nine values are the values of the kernel positions
  73. (starting top left and moving horizontally along the 3 rows), these are then
  74. followed by the divider value and finally the multiplier.
  75.  
  76.  
  77. The 'Fuzzy Wuzzy' Feature
  78. -------------------------
  79.  
  80. If you click on the toggle window size icon on the Kernel Control Window's
  81. title bar the window will expand to show the 'Fuzzy Wuzzy' function control
  82. options.
  83.  
  84. The Fuzzy Wuzzy operation takes a source image and produces a result image
  85. where a set proportion of pixels have not been taken from the same location
  86. in the source image, but from a random position from an area around the
  87. source location.
  88.  
  89. The result of this operation will be a fuzzy picture. The options available
  90. are x and y values which define the area around the pixel to take the random
  91. pixel from (a value of 4 means that the pixel can come from any 4 either side
  92. of the pixel location).
  93.  
  94. The other value is a percentage, which defines the proportion of pixels to
  95. get randomly, a value of 100 means all pixels will come from random
  96. locations, a value of 0 will mean none.
  97.  
  98.  
  99. The 'Outlines' Feature
  100. ----------------------
  101.  
  102. The outlines feature is located below the 'Fuzzy Wuzzy' feature (see above)
  103. and provides a simple way of locating all edges within a picture. As an
  104. operation is makes no changes to the image, it simply creates a mask
  105. (ignoring completely any existing mask) where pixels that are on an edge are
  106. left unmasked, all other pixels are masked out.
  107.  
  108. This operation takes a single parameter (value) which dictates the
  109. sensitivity of the operation which locates pixels which appear to be on the
  110. edge of an object.
  111.  
  112. The value defines an intensity threshold whereby a pixel in a source image is
  113. masked out if that pixel's neighbours intensities are similar to the pixel in
  114. question's intensity.
  115.  
  116. By supplying a positive threshold the brighter pixels at an edge boundary
  117. will be left unmasked; a negative threshold will make the darker pixels be
  118. the ones left unmasked. Thus to locate the edges of an item which is brighter
  119. than its background use a positive value.
  120.  
  121. The supplied value should be between -255 and 255 (the nearer the value is to
  122. zero the more of the image will be left unmasked).
  123.