home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / graphics / utilities / imagelab_452 / imagelab.help < prev    next >
Text File  |  1991-02-13  |  17KB  |  574 lines

  1. . Credits
  2.     \uImageLab V2.4\u
  3.  
  4.     (C) Copyright 1991
  5.     by  Gary Milliorn
  6.  
  7.     This program is copyrighted, but 
  8. is freely redistributable excluding
  9. commercial concerns.
  10.  
  11.     Send suggestions, bugs, complaints,
  12. to:
  13.  
  14.     mail: 5915 Shanghai Pierce Rd.
  15.           Austin, Texas 78749-1927
  16.     bix:  gmill
  17.  
  18. Last revision: 3 February, 1991
  19. . Overview
  20.     \uImageLab V2.4\u
  21.  
  22.     \uImageLab\u is a program that
  23. performs functions on image files.  It
  24. is principally oriented towards greyscaled
  25. images, though there are some color
  26. functions provided.
  27.  
  28.     \uImageLab\u only works on IFF files.
  29.  
  30.     All operations can be limited to
  31. areas by drag-selecting an area on the file
  32. opened: just click at one corner and drag
  33. to the opposite; only the selected area
  34. will be affected.
  35. .Convolution
  36.     \iConvolution\i (the graphical or
  37. spatial form) is a general purpose image
  38. processing transform that can be used to
  39. extract or enhance features of the image,
  40. under control of a matrix called the
  41. \ikernel\i.
  42.  
  43.     \uImageLab\u V2.x is limited to a
  44. 3 x 3 kernel, but there are many operations
  45. which can be performed with this small
  46. kernel, such as smoothing, edge detection,
  47. etc.
  48. .Area
  49.     Operations may be applied to the
  50. whole screen or to a sub-area.
  51.  
  52.     To select an area, click the mouse
  53. on the picture and drag to outline the
  54. desired area. 
  55. .Clipboard
  56.     The clipboard functions can be used
  57. to import or export graphical data, or to
  58. hold data temporarily when moving between
  59. screens you open.
  60. .Project
  61.     The \iProject\i menu contains general
  62. information selections: About and
  63. Information.
  64.  
  65.     Note: if the `checkmark' option is set
  66. and the special font is available, then 
  67. \uImageLab\u will convert the Project menu into
  68. an Amiga-style checkmark.
  69. .File
  70.     The \iFile\i menu contains all File I/O
  71. operations, as well as the Quit option.
  72. .Edit
  73.     The \iEdit\i menu contains the clipboard
  74. functions, plus general purpose editing
  75. facilities (such as Paint, Flip, Erase, etc.)
  76. .Transform Menu
  77.     The \iTransform\i menu contains various
  78. picture/area modification functions,
  79. including the FFT menus, the Convolution
  80. and Averaging menus, and the Filters menus.
  81. .Picture Menu
  82.     The \iPicture\i menu contains various
  83. global picture operations, including color
  84. table manipulations and screen parameter
  85. editing (change size, etc.)
  86. .Other Menu
  87.     The \iOther\i menu contains miscellaneous
  88. functions, including:
  89.  
  90.     Position          - screen positioning
  91.     Save Mode         - compression type and
  92.                       FFT inclusion.
  93.     Restrict Palette- limit color range.
  94.     Bell               - controls bell usage.
  95.     Icons              - controls icon
  96.                       creation.
  97. .About
  98.     \iAbout\i displays information about
  99. \uImageLab\u, including the copyright
  100. information, current memory availability
  101. (\uImageLab\u can use quite a bit)
  102. and provides access to \iHelp\i.
  103.  
  104.     Note: Help is also available using the
  105. `Help' key.
  106. .Picture Info 
  107.     \iPicture Info\i shows information about
  108. the current open picture, including:
  109.  
  110.     Filename.
  111.     File size.
  112.     Display modes.
  113.     Select size and area.
  114.     FFT memory usage.
  115. .Open
  116.     \iOpen\i opens an \bIFF\b picture file.
  117. If a screen is currently open already, it
  118. will be closed first (if it has been
  119. modified, a warning will be issued).
  120.  
  121.     If the \bALT\b key is held while \iOpen\i
  122. is selected, when the IFF file is opened,
  123. the most-significant bit plane will be
  124. stripped away.  This is useful in
  125. processing \iDigiView\i files, which
  126. create extra bitplanes that can adversely
  127. affect \uImageLab\u's operation.
  128.  
  129.     See also: \iRestrict Palette\i
  130. and \iEdit Parameters\i.
  131. .Revert
  132.     \iRevert\i re-opens the previously opened
  133. IFF picture file, undoing any changes that
  134. have been made.
  135.  
  136.     This option is disabled if you have not
  137. made any changes to your file.
  138. .Close
  139.     \iClose\i closes the current picture screen.
  140. If the picture has been modified, you will be
  141. warned.
  142. .Save
  143.     \iSave\i saves the current picture back to
  144. the filename used when the picture was
  145. loaded.
  146.  
  147.     The `Save' option is disabled when the
  148. picture's screen modes have been altered
  149. (by the \iEdit Parameters\i command).
  150. .Save As
  151.     \iSave As\i saves the current picture to
  152. a filename specified using a file requester.
  153. .Delete
  154.     \iDelete\i brings up a file requester
  155. allowing you to specify files to be deleted.
  156. .Quit
  157.     \iQuit\i leaves \uImageLab\u.  If the
  158. current picture has been altered but not
  159. saved, you will be warned first.
  160. .Undo
  161.     \iUndo\i undoes most operations, even if
  162. it has to re-load the picture from disk.
  163. .Cut
  164.     \iCut\i copies the selected area to the
  165. clipboard, then erases the area to the
  166. background color (color #0).
  167.  
  168.     If the \bALT\b key is held down, the
  169. area is cleared to the foreground color
  170. (the maximum color register).
  171. .Copy
  172.     \iCopy\i copies the selected area to the
  173. clipboard as an IFF picture.  Selected areas
  174. can be exported to other programs by the
  175. clipboard.
  176. .Paste
  177.     \iPaste\i pastes the IFF graphics area
  178. to the current picture.  If the clipboard
  179. contains an IFF compatible picture, the
  180. picture screen will be brought up and a
  181. select box will be active.
  182.  
  183.     Position the box to the desired location
  184. and press the left mouse button.
  185.  
  186.     To abort a \ipaste\i in-progress, press
  187. the \bESC\b key.
  188. .Clear
  189.     \iClear\i erases the selected area (or
  190. the entire screen) by setting it to the
  191. background color (color #0).
  192.  
  193.     If the \bALT\b key is held down, the
  194. area is cleared to the foreground color
  195. (the maximum color register).
  196. .Unselect
  197.     \iUnselect\i removes the selected area
  198. from the picture.  Alternately, just click
  199. once on the picture without moving the
  200. mouse.
  201. .Move
  202.     \iMove\i allows you to reposition a
  203. selected area.  To use, select an area, then
  204. the \iMove\i option.  The screen is brought
  205. up, with the selected area shown.
  206.  
  207.     To move that area, click the left mouse
  208. button to drag the area to the new location,
  209. and release the button when the area is
  210. positioned properly.
  211.  
  212.     To abort a move in-progress, press the
  213. \bESC\b key before releasing the right
  214. mouse button, or press the left mouse
  215. button.
  216. .Resize
  217.     The \iResize\i option allows to you to
  218. change the size of a selected area.  The
  219. first two options, \iCopy\i and
  220. \iInterpolate\i control whether pixels
  221. which must be created are simply copied
  222. or are produced by a two-dimensional
  223. averaging technique.
  224.  
  225.     To use those methods, you select
  226. them and then select a new area.  \iResize\i
  227. will expand and/or contract your image
  228. as needed to fit the available area.
  229.  
  230.     The second two options, \iHalve\i
  231. and \iDouble\i, do not require you to
  232. specify the target area.
  233.  
  234.     \bNote:\b \iDouble\i always interpolates,
  235. so it is somewhat slower.
  236. .Flip
  237.     The \iFlip\i option produces mirror images
  238. of selected areas.  The suboptions allow you
  239. to flip around an imaginary center vertical
  240. axis (making horizontal flips) or around an
  241. imaginary center horizontal axis (making
  242. vertical flips).
  243. .Invert
  244.     The \iInvert\i option produces negatives
  245. of selected areas (the Palette Negative
  246. function pruduces negatives of the entire
  247. image).
  248. .Paint
  249.     The \iPaint\i functions allow you to
  250. modify areas on the screen.  When any
  251. paint mode is selected, the pointer changes
  252. to a cross hair, and the image data under
  253. the center of the pointer changes in the
  254. following ways:
  255.  
  256.     Draw   - draw using last palette color.
  257.     Trace  - draw, but connect between dots.
  258.     Xor    - exclusive-or (invert) pixels.
  259.     Random - draw with random pixels.
  260.  
  261.     To select the color to paint with in
  262. the Draw or Trace modes, use the Palette
  263. function and select a color.
  264.  
  265.     The Function keys F6..F10 map to the
  266. drag-select/paint modes as follows:
  267.  
  268.     F6    - no paint, drag select.
  269.     F7    - draw.
  270.     F8    - Trace.
  271.     F9    - Xor.
  272.     F10    - Random.
  273. .Position
  274.     The submenus of the \iPosition\i menu
  275. allow control over the position of the open
  276. picture screen, which has no drag bar.
  277.  
  278.     The \iHigh\i, \iMiddle\i, and \iLittle\i
  279. selections put the screen at the top, halfway
  280. down, or near the bottom.
  281.  
  282.     Since menu selections are made from the
  283. WorkBench screen, the last two allow easy
  284. access to the ImageLab window.
  285.  
  286.     The command key mnemonics were chosen
  287. for convienent access using the right Amiga,
  288. not for some bizarre meaning.
  289. .Save Type
  290.     The \iSave Type\i menu allows you to
  291. select whether pictures will be compressed
  292. or not, and whether FFT data (if any)
  293. will be saved as well.
  294.  
  295.     The "Compress Picture" menu selection is
  296. checked to reflect the compression mode of
  297. the currently open picture, if any.
  298. .Bell
  299.     The \ibell\i menu, if checked, causes a
  300. bell to be sounded when an operation is
  301. complete.  This is handy with some of the
  302. lengthy functions, such as FFT's.
  303. .Icons
  304.     The \iIcons\i menu, if checked, allows
  305. controlling whether icons are generated with
  306. saved picture files.  The default is OFF if
  307. \uImageLab\u was started from the CLI,
  308. or ON if it was started from WorkBench.
  309. .FFT
  310.     The \iFFT\i menu contains the main FFT
  311. transform function, \iTransform\i, \iInverse\i
  312. and \iDisplay\i.
  313. .Color to B&W
  314.     The \iColor to B&W\i menu converts the color
  315. palette to a greyscale.  It does this using
  316. the EIA weighting factors.  This is one step
  317. in converting a color picture for \uImageLab\u
  318. use.
  319.  
  320.     Note: if the palette is not in order
  321. after using this command, use \iLinearize\i.
  322. .Linearize
  323.     The \iLinearize\i menu sorts the palette,
  324. and rewrites all pixel values on the screen
  325. so that no change in appearance occurs.
  326.  
  327.     \uImageLab\u requires a linearly increasing
  328. palette for most operations to perform as
  329. expected.
  330. .Negative
  331.     The \iNegative\i menu inverts the order of
  332. the palette.  If you have a standard
  333. greyscale, this will produce a negative
  334. image.  If not, unpredictable results will
  335. occur.
  336. .Saturate
  337.     The \iSaturate\i menu saturates all colors
  338. in the palette.  If the \bALT\b key is held,
  339. then the intensity levels are forced to their
  340. maximum values also; this produces a palette
  341. of primary colors.
  342. .Pseudo Color
  343.     The \iPseudo Color\i menu converts a grey-
  344. scaled palette to a "thermographic" palette,
  345. where blue represents coldest (darkest) and
  346. red represents hottest (whitest).  Values in-
  347. between are scaled accordingly.
  348.  
  349.     If the \bALT\b key is held while selecting
  350. \iPseudo Color\i, the palette is given random
  351. colors.  This serves no useful purpose,
  352. except for hours of enjoyment.
  353. .Delete Color
  354.     The \iDelete Color\i menu brings up a window
  355. containing selection gadgets, one per color.
  356. Selecting the gadgets changes them to an 'X',
  357. and when "OK" is selected, all marked colors
  358. are deleted from the palette and their pixels
  359. are deleted from the picture.
  360.  
  361.     Unchanged colors and pixels are moved
  362. down, freeing up space in the palette/image.
  363. .Map Color
  364.     The \iMap Color\i menu brings up a window
  365. containing selection gadgets, one per color.
  366. Selecting the gadgets changes them to an 'X',
  367. and when "OK" is selected, the two (and only
  368. two) marked colors are exchanged in the
  369. palette and their pixels are exchanged in the
  370. picture.
  371.  
  372.     Warning: this is a slow operation.
  373. .Sobel
  374.     The \iSobel\i transform is a specialized,
  375. highly effective edge detecting transform.
  376. Areas processed by the \iSobel\i transform
  377. will be replaced with bright pixels in area
  378. of greatest change, and dark where there is
  379. little change.
  380. .Roberts
  381.     The \iRoberts\i transform is a specialized,
  382. effective edge detecting transform.  Areas
  383. processed by the \iRoberts\i transform will
  384. be replaced with bright pixels in area of
  385. greatest change, and dark where there is
  386. little change.
  387. .Binary
  388.     The \iBinary\i function converts the
  389. selected area to white or black, depending
  390. upon whether the pixel are greater than or
  391. less than a supplied value.
  392. .Threshold
  393.     The \iThreshold\i function limits the
  394. selected area.  Pixels outside a specified
  395. pair of limits are forced to be within that
  396. range.
  397. .Pixelize
  398.     The \iPixelize\i function converts a group
  399. of <n> pixels into their average value.
  400. This produces blocky images (i.e.,
  401. "computerized" ones).
  402. .Transform
  403.     The \iTransform\i function begins an FFT
  404. transform.  The selected area must be a
  405. power of two in size (2, 32, 128, etc.);
  406. if not, a modification requester is
  407. brought up.
  408.  
  409.     When ready, the FFT operation begins.
  410. A bar chart monitors its progress.  When
  411. the FFT completes, the data is saved in
  412. memory and is associated with the image.
  413. Select the \iDisplay\i function to view the
  414. results.
  415. .Inverse
  416.     The \iInverse\i function begins an inverse
  417. FFT transform.  This converts the data back
  418. to an image.  When done, the data can be
  419. displayed via \iDisplay\i.  Theoretically,
  420. if no changes have occured to the raw FFT
  421. data, you should get your picture back.
  422.  
  423.     The \iPaint\i option also modifies any FFT
  424. data.
  425. .Display
  426.     The \iDisplay\i function displays a screen
  427. image using the FFT data.  The options
  428. \iLog Display\i and \iNo Display\i control
  429. whether a logarithmic enhancement is applied
  430. to the data.
  431. .Intensity
  432.     The \iIntensity\i function alters the
  433. apparent brightness of an area up or down in
  434. steps.  The \iBrighten\i and \iDarken\i area
  435. additive operations, while the \iScale\i
  436. operations are multiplicative.
  437.  
  438.     Note that Brighten and Darken affect the
  439. appearance of the background color (0),
  440. while Scaling does not have this problem.
  441. .Merge
  442.     The \iMerge\i function merges two pictures.
  443. The options are:
  444.  
  445.     Overlay - copy new picture to current,
  446.               wherever the current pixel
  447.               is black.
  448.     Add        - add the pixel values
  449.               together.
  450.     Subtract- subtract the pixel values
  451.               together.
  452.     And        - logically AND the pixel
  453.               values together.
  454.     Or        - logically OR the pixel
  455.               values together.
  456.     XOR        - logically XOR the pixel
  457.               values together.
  458.  
  459.     Other...- do a custom blitter
  460.               operation.
  461. .Average
  462.     The \iAverage\i function smooths a selected
  463. area by replacing each pixel by the weighted
  464. average of its neighboring pixels.  Different
  465. suboptions select which neighbors to use.
  466.  
  467.     If the \bALT\b key is held while selecting
  468. \iAverage\i, you can edit the control matrix.
  469. .Convolve
  470.     The \iConvolve\i function alters a pixel
  471. based upon factors weighted by selected
  472. neighboring pixels.
  473.  
  474.     By varying the kernel used, smoothing,
  475. enhancing, or edge detection can be
  476. performed.
  477.  
  478.     If the \bALT\b key is held while selecting
  479. \iConvolve\i, you can edit the control matrix.
  480. .Histogram
  481.     The \iHistogram\i function counts pixels in
  482. a selected area, and shows a graph from that
  483. data.
  484.  
  485.     The \iBar Graph\i menu option, if checked,
  486. instructs ImageLab to create a Bar Graph;
  487. otherwise, a line graph is displayed.
  488. .Equalize
  489.     The \iEqualize\i function adjusts the values
  490. in the palette so normalize the greyscale to
  491. a Gaussian distribution, producing a more
  492. normal appearance.
  493.  
  494.     \bNote\b: a \iHistogram\i function \bmust\b have
  495. been invoked first.
  496. .HAM Conversion
  497.     The \iHAM Conversion\i function is enabled
  498. only when a HAM picture has been loaded.  It
  499. converts the picture or selected area to a
  500. 16-color greyscaled image.
  501.  
  502.     \bNote\b: this function \bdoes\b work correctly
  503. for selected areas which do not start at the
  504. left edge.
  505. .Halftone
  506.     The \iHalftone\i function converts the
  507. selected area or picture to a halftoned
  508. image.  A halftone cell size of 2 or 3
  509. can be selected, which increases the
  510. size of the resulting image by 2 or 3,
  511. respectively.
  512. .Restrict Palette
  513.     The \iRestrict Palette\i function
  514. prevents \uImageLab\u from using the upper
  515. half of a palette.  This is needed to
  516. process DigiView pictures properly.
  517. .Greyscale
  518.     The \iGreyscale\i function converts the
  519. palette to a linearly increasing greyscale.
  520. .Median
  521.     The \iMedian\i filter replaces each pixel
  522. in an area with the median value of its
  523. eight surrounding pixels.
  524. .Minimum
  525.     The \iMinimum\i filter replaces each pixel
  526. in an area with the minimum value of its
  527. eight surrounding pixels.
  528. .Maximum
  529.     The \iMaximum\i filter replaces each pixel
  530. in an area with the maximum value of its
  531. eight surrounding pixels.
  532. .Distort
  533.     The \iDistort\i function randomly distorts
  534. a selected area.  A probability of 0% to 100%
  535. can be set.
  536. .Noise
  537.     The \iNoise\i function randomly produces
  538. impulse noise in an area.  A probability of
  539. 0% to 100% can be set.
  540.  
  541.     If the \bALT\b key is held while selecting
  542. \iNoise\i, the noise generated is 0, instead
  543. of the maximum color.
  544. .Palette
  545.     The \iPalette\i function places a color
  546. palette on the screen.  You can select each
  547. color, and alter its RGB components using
  548. the provided sliders.  Select "OK" to make
  549. the changes permanent, or "CANCEL" to restore
  550. the old values.
  551. .Edit Screen
  552.     The \iEdit Screen\i function changes the
  553. size and modes of the display screen,
  554. producing a new screen.  A window allows
  555. you to edit the screen width, depth, and
  556. height.  You can select HAM, Interlace, HIRES,
  557. and EHB (Extra-Half-Bright) modes as well.
  558.  
  559.     If the \bALT\b key is held while
  560. selecting \iEdit Screen\i, it change the
  561. screen width and height values to the
  562. currently selected area.
  563. .Edit Image
  564.     The \iEdit Image\i function changes the
  565. size of the image, which may be larger or
  566. smaller than the display screen.
  567.     A window allows you to edit the screen
  568. width, height, or depth.
  569.  
  570.     If the \bALT\b key is held while
  571. selecting \iEdit Image\i, it change the
  572. image width and height values to the
  573. currently selected area.
  574.