home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / xpaint-247 / help.txt < prev    next >
Text File  |  1996-06-25  |  37KB  |  1,196 lines
  1. #BEGIN introduction "Introduction" "$Id: Help.txt,v 1.9 1996/06/03 07:36:18 torsten Exp $"
  2. Welcome to the latest version of XPaint.
  3.  
  4. XPaint is a color image-editing tool that features most standard paint
  5. program options.
  6. It allows for the editing of multiple images simultaneously and supports
  7. various formats, including PPM, XBM, TIFF, etc.
  8.  
  9. The functionality of XPaint is divided into a toolbox area for selecting
  10. the current paint operation and paint windows for modifying/creating
  11. images.  Each paint window has access to its own color palette and set
  12. of patterns, although the paint operation in use is globally selected
  13. for all windows.
  14.  
  15. XPaint runs on a variety of displays.  Saving
  16. images will adapt them to the current display type (e.g., a color image
  17. loaded on a greyscale screen will be saved as a grey image).  This can
  18. result in the loss of data; see the Possible Data Loss section for details.
  19.  
  20. More information is available under the specific topics.  Enjoy!
  21.  
  22. #BEGIN data_loss    "Possible Data Loss"
  23. XPaint uses the native display format for storing image info while editing;
  24. the original image information is thrown away.  This means that, in general,
  25. color information is irretrievably lost when using any display depth
  26. less than 24 bits.
  27.  
  28. More specifically, for depths less than 8 bits, both
  29. 24-bit (true-color) and 8-bit (palette) images will be reduced to the display
  30. depth; for 8-bit displays, standard color-mapped images are safe but 12-bit
  31. color-mapped and 24-bit true-color images will lose color information;
  32. for 15- and 16-bit displays (typically RGB 555 and 565, respectively), in
  33. general both 8-bit and 24-bit images will suffer data loss; and for 24- or
  34. 32-bit displays, only very deep images such as 16-bit grayscale or 48-bit
  35. true-color will lose data.
  36.  
  37. Also note that any ancillary information associated with the original
  38. image (embedded comments, time stamp, copyright, etc.) will always be lost.
  39. #BEGIN command    "Command Line Options"
  40. xpaint [-popped] [-nowarn] [-size WIDTHxHEIGHT] [-rcFile FILE] [-12] [-24] [<files>...]",
  41. #NL
  42.     -size        default width and height for new images
  43. #NL
  44.     -12            use a 12-bit PseudoColor visual
  45. #NL
  46.     -24            use a 24-bit TrueColor visual
  47. #NL
  48.     -popped        pop up an empty canvas on startup
  49. #NL
  50.     -nowarn        skip data-loss warnings
  51. #NL
  52.     -rcFile        use FILE instead of default .XPaintrc
  53. #NL
  54.     <files>        image filenames to open
  55. #NL
  56. #BEGIN toolbox "Toolbox"
  57. The toolbox is used to set those options that are applicable to all
  58. XPaint canvases.
  59. #PUSH
  60. #BEGIN tool_file "File Menu"
  61. The file menu is used to create a new canvas or load an image from a file.
  62.  
  63. New Canvas
  64. #NL
  65.     Create a new blank canvas (default size:
  66. #NL
  67.     640x480).  See "Command Line Options" for
  68. #NL
  69.     changing the default size.
  70.  
  71. New with Size...
  72. #NL
  73.     Create a new canvas with the specified
  74. #NL
  75.     dimensions.
  76.  
  77. Open...
  78. #NL
  79.     Open an image file for painting.  Images can
  80. #NL
  81.     be opened in a variety of formats.  If none
  82. #NL
  83.     of the specific formats is selected, XPaint
  84. #NL
  85.     will attempt to perform a "Best Guess" as to
  86. #NL
  87.     the image format.  Unknown formats will result
  88. #NL
  89.     in an error message.
  90.  
  91. Load Clipboard...
  92. #NL
  93.     Open an image file into the XPaint clipboard
  94. #NL
  95.     for pasting.  Images that have been saved in
  96. #NL
  97.     a format supporting odd-shaped regions will be
  98. #NL
  99.     loaded as they were selected, otherwise all
  100. #NL
  101.     images are rectangular.  See "Paste" and
  102. #NL
  103.     "Save Region..." under the Edit and File menus
  104. #NL
  105.     of the Painting Window for more information.
  106.  
  107. Quit
  108. #NL
  109.     Exit XPaint, closing all windows.
  110. #BEGIN tool_line "Line Menu"
  111. The line menu sets the value of the line width.  This value is used by all
  112. operations that paint any type of line, including the borders of boxes,
  113. ovals and polygons.
  114. #BEGIN tool_font "Font Menu"
  115. This menu selects the current font to use for the text operation.  There are
  116. a few specific fonts choices listed, but all fonts are available through
  117. the font browser.
  118.  
  119. Note:  Changing a font while inserting will not allow backspacing over text
  120. in a previous font.
  121.  
  122. See "Font Browser" for more information on its use.
  123. #PUSH
  124. #BEGIN font_browser "Font Browser"
  125. The font browser is designed to allow any available font to be used for
  126. painting with the text operation.  A font is selected by choosing an item
  127. from each of the given lists until the font is displayed in the "selection"
  128. area.  As items are selected, all lists will adjust to reflect existing
  129. fonts with the selected characteristics.  Clicking in the blank area
  130. of a item list will reset that list to all available options (i.e., unselect
  131. the current one).
  132.  
  133. If the X server supports variable sized fonts, the point size list will
  134. contain a "0" entry, which will use the value specified in the
  135. "Point Size" field.
  136.  
  137. #POP
  138. #BEGIN tools "Painting Tools"
  139. The painting tool icons set the current painting operation for all canvases.
  140.  
  141. Operations are selected with mouse button one.  Pressing mouse button three
  142. while over any of the icons will bring up a menu of options available for
  143. that tool.  Some icons also allow double-clicking as a faster method of
  144. bringing up style options.
  145.  
  146. See the specific paint operation for more information.
  147. #PUSH
  148. #BEGIN arc "Arc"
  149. The arc operation paints an arc between two selected points in the primary
  150. color/pattern, using the current line width.  Arcs are generally a
  151. quarter of an ellipse, but may be restricted to a circular shape by
  152. pressing the shift key while painting.
  153.  
  154. See "Line Menu" under the toolbox for more information about line width.
  155. #BEGIN box "Boxes"
  156. The box operations paint either rectangles or squares using the current line
  157. width. Pressing shift while moving the mouse after selecting the first point
  158. will constrain the box to a square.
  159.  
  160. Selecting the 'center' option from the menu found by pressing button three on
  161. the icon will define the first point as the center of the square with
  162. the second point being on the perimeter.
  163.  
  164. Filled boxes are painted in the primary color/pattern and filled
  165. with the secondary color/pattern for the canvas.
  166.  
  167. See "Line Menu" under the toolbox for more information about line width.
  168. #BEGIN brush "Brush"
  169. The brush operation uses the current brush to paint on the canvas(es).
  170. Painting is accomplished by holding down the mouse button and
  171. moving the mouse in the canvas area.  Button one paints in the selected primary
  172. color/pattern, while button two uses the secondary one.
  173.  
  174. If the 'transparent' option is selected from the menu found by pressing button
  175. three on the icon, the selected color is blended with the color already on the
  176. canvas. You can change the opacity of the brush using the 'Parameters..'
  177. option. Zero percent means that the canvas is not changed at all, while 100
  178. percent gives the same result as using a non-transparent brush.
  179.  
  180. The current brush style may be changed through the brush chooser available
  181. on the button three menu for either the brush or erase operation icons.
  182. #BEGIN cline "Connected Line"
  183. The connected line operation paints a series of straight lines connected at
  184. selected vertices.  Each new vertex is selected using the first mouse button.
  185. The second mouse button ends this operation, without forming a new vertex.
  186.  
  187. All painting is done in the primary color/pattern using the currently defined
  188. line width.
  189.  
  190. See "Line Menu" under the toolbox for more information about line width.
  191. #BEGIN dotPencil "Dot Pencil"
  192. The dot pencil operation paints a series of dots on the canvas, following the
  193. cursor while the mouse button is pressed.
  194.  
  195. Button one paints in the primary color/pattern, button two the secondary
  196. color/pattern.
  197.  
  198. See "Pencil" for painting connected lines.
  199. #BEGIN erase "Erase"
  200. The erase operation is designed to either erase a section of the painting to
  201. the set background color for the canvas or to revert the erased area to
  202. the originally loaded image.  (Note:  This is not the last saved image!)
  203.  
  204. The eraser is the style of the current brush, and the brush selection
  205. window is accessible through the menu found by clicking mouse button
  206. three on either the erase or brush icons.
  207.  
  208. See help on the "Brush" or on "Change Background..." under the Image menu of
  209. the Painting Window for more information.
  210. #BEGIN fill "Fill"
  211. The fill operation will paint an area around a selected pixel the current
  212. primary or secondary color/pattern (based on which mouse button used).  The
  213. area is determined by matching adjacent pixel values until a variation is
  214. found.  Diagonal pixels are not considered adjacent.
  215.  
  216. Selecting the 'Change' option from the menu found by pressing button three on
  217. the icon will enter Change Mode. In this mode, all pixels in the image that
  218. have the same color as the selected one will be changed to the primary or
  219. secondary color.
  220.  
  221. Selecting the 'Fill Range' option causes XPaint to consider not only pixels of
  222. the exact same color as the selected one, but also pixels within the variance
  223. (delta) set from the color selector found under the 'Select Range...' popup
  224. menu item.
  225. #BEGIN tfill "Gradient Fill"
  226. The gradient fill operation will paint an area around a selected pixel with a
  227. range of colors obtained by mixing the primary and secondary colors.
  228. The area is determined by matching adjacent pixel values until a variation is
  229. found.  Diagonal pixels are not considered adjacent.
  230.  
  231. The 'Fill', 'Change' and 'Fill Range' options in the popup menu work the same
  232. as for the ordinary fill operation.
  233.  
  234. Linear, Radial, Conical or Square gradient fill can be selected by clicking
  235. mouse button three on the Gradient Fill icon. Also, several parameters can be
  236. adjusted using the 'Parameters' item here:
  237.  
  238. Angle
  239. #NL
  240.     Defines the tilting of the pattern. Valid range is
  241. #NL
  242.     -360 to 360 degrees.
  243.  
  244. Pad    If this value is positive, the area where one color
  245. #NL
  246.     blends into the other will be compressed, yielding
  247. #NL
  248.     a sharper transition. If negative, the transition
  249. #NL
  250.     will be smoother. Valid range is -49 % to 49 %.
  251.  
  252. Horizontal/Vertical offset
  253. #NL
  254.     Defines the center of the pattern. Valid range is
  255. #NL
  256.     -100 % to 100 %.
  257. #NL
  258.     This parameter has no effect for the Linear pattern.
  259.  
  260. Steps 
  261. #NL
  262.     The maximum number of colors that will be used
  263. #NL
  264.     for the transition from one color to the other.
  265. #NL
  266.     For non-TrueColor displays, it can be useful to
  267. #NL
  268.     limit the number of colors used to avoid running
  269. #NL
  270.     out of palette entries.  Very small numbers can
  271. #NL
  272.     also be used to get a 'blocky' effect. Valid range
  273. #NL
  274.     is 1 trough 300.
  275. #BEGIN ffill "Fractal Fill"
  276. The fractal fill operation will paint an area around a selected pixel with a
  277. range of colors obtained by mixing the primary and secondary colors.
  278. The area is determined by matching adjacent pixel values until a variation is
  279. found.  Diagonal pixels are not considered adjacent.
  280.  
  281. The 'Fill', 'Change' and 'Fill Range' options in the popup menu work the same
  282. as for the ordinary fill operation.
  283.  
  284. Several different fractal patterns can be selected by clicking
  285. mouse button three on the Fractal Fill icon.
  286. #BEGIN smear "Smear"
  287. The smear operation paints each pixel under the brush the average color
  288. of all the pixels.
  289. Smearing is done by holding down the mouse button and
  290. moving the mouse in the canvas area.
  291.  
  292. The current brush style may be changed through the brush chooser available
  293. on the button three menu.
  294. #BEGIN line "Line"
  295. The line operation paints a straight line in the primary color/pattern
  296. between two selected points on the canvas, using the global line width.
  297.  
  298. See "Line Menu" under the toolbox for more information about line width.
  299.  
  300. Lines may also be restricted to increments of 45 degrees (i.e.,
  301. horizontal, vertical, or diagonal) by holding down the shift key while
  302. painting.
  303. #BEGIN oval "Ovals"
  304. The oval operations paint either circles or ovals using the current line width.
  305. Ovals/circles are painted by selecting two points that inherently define
  306. a box around the area for the oval.  Pressing shift while moving the mouse will
  307. constrain the oval to a circle.
  308.  
  309. Selecting the 'center' option from the menu found by pressing button three on
  310. the icon will define the first point as the center of the circle with the
  311. second point being the radius.
  312.  
  313. Filled ovals and circles are painted in the primary color/pattern and filled
  314. with the secondary color/pattern for the canvas.
  315.  
  316. See "Line Menu" under the toolbox for more information about line width.
  317. #BEGIN pencil "Pencil"
  318. The pencil operation paints a connected line on the canvas, following the
  319. cursor while the mouse button is pressed.  The global line width is used
  320. to determine the width of this line.
  321.  
  322. Button one paints in the primary color/pattern, button two the secondary
  323. color/pattern.
  324.  
  325. See "Line Menu" under the toolbox for more information about line width.
  326. #BEGIN poly "Polygons"
  327. Polygon operations paint polygons as defined by a series of straight lines
  328. between selected vertices.  Each new vertex is selected using the first mouse
  329. button.  Ending this operation (done through pressing the second mouse
  330. button) does not create a new vertex and results in the last created
  331. vertex being joined to the first.
  332.  
  333. All painting is done in the primary color/pattern using the currently defined
  334. line width.  Filled polygons are filled in the secondary color/pattern.
  335.  
  336. See "Line Menu" under the toolbox for more information about line width.
  337. #BEGIN ray "Ray"
  338. The ray operation paints rays from the first selected point to all
  339. subsequent points in the primary color/pattern.  Button two ends this
  340. operation without selecting a new ray point.  Rays may also be restricted
  341. to slopes based on a 45 degree increment (i.e., horizontal, vertical,
  342. or diagonals) by pressing the shift key while painting.
  343.  
  344. The width of the rays is determined by the global value for the line
  345. width, set via the "Line" menu.
  346.  
  347. See "Line Menu" under the toolbox for more information about line width.
  348. #BEGIN select "Select Regions"
  349. There are three operations for selecting regions:  Select Box, Lasso and
  350. Select Polygon.
  351. "Select Box" will select a rectangular or ellipse-shaped region (holding down
  352. shift while pressing the mouse button with constrain the region to a
  353. square or a circle, respectively).  "Lasso" selects an arbitrary region.
  354. "Select Polygon" selects a region bounded by straight lines.
  355.  
  356. The three possible modes used by these operations are set by the options on
  357. the button three menu for either icon:
  358.  
  359. All Colors             Select the entire region.
  360. #NL
  361. Omit Color Range    Select the region, excluding the
  362. #NL
  363.                 specified range of colors.
  364. #NL
  365. Only Color Range    Select only the specified color range
  366. #NL
  367.                 in the region.
  368. #NL
  369. Select Range...        Brings up a window to select the
  370. #NL
  371.                 range of colors for these operations.
  372.  
  373. See "Range Selection" for more information on choosing a range of colors
  374. for these operations.
  375.  
  376. Operations that may be performed on selected regions include the ability
  377. to move and resize them.  Holding shift down during resizing will constrain
  378. the region to its original aspect ratio.  Holding shift down during moving
  379. will constrain movement to horizontal or vertical.  
  380.  
  381. Note that moving a region will result in the original location being painted
  382. in the current background color. See "Background Color..." under the Image
  383. menu of the Paint Window for more information.
  384.  
  385. You can also use the cursor keys to move the region one pixel at a time (hold
  386. down the Control key to move in larger steps).
  387. #PUSH
  388. #BEGIN range_select "Range Selection"
  389. This window is designed for selecting a range of colors for use with
  390. the select region operations.  The color range is determined by setting a
  391. base color and the amount of variance in each of the RGB values around
  392. this color.  Colors are considered in this range if they match a value based
  393. on the base color +/- the given variance.   Default base color is white.
  394.  
  395. The "Pixel Delta" button allows the user to choose another color that will
  396. be used to calculate the variance from the base color.
  397.  
  398. More information on colors and the use of the color wheel may be found
  399. under the "Pattern Editor on the "Painting Window".
  400. #POP
  401. #BEGIN blob "Shape"
  402. Shape operations allow the user to draw closed objects with a 
  403. pencil-like operation.  When the mouse button is released, the last drawn 
  404. point is connected to the starting point. 
  405.  
  406. Painting can either be done in the primary color/pattern with button one or
  407. in the secondary color/pattern with button two.  Filled shapes are filled in
  408. the other palette color/pattern.  Border width is determined by the current
  409. setting for line width.
  410.  
  411. See "Line Menu" under the toolbox for more information about line width.
  412. #BEGIN spray "Spray"
  413. The spray operation is designed to emulate a spray can.  It will paint
  414. a random set of dots within a given radius.
  415.  
  416. It is possible to change the attributes of the spray operation to
  417. achieve the desired effect.   There are three parameters that will
  418. modify the configuration of the spray tool:
  419. #NL
  420.     radius    how large of a circle to fill
  421. #NL
  422.     density    number of dots in the given area
  423. #NL
  424.     rate        speed to fill the area in tenths of a second
  425.  
  426. Additionally, it is possible to change the distribution of the dots to
  427. be either even or gaussian (usually only noticeable at large radii).
  428. These options are found in the menu brought up by clicking button three
  429. on the spray icon.
  430.  
  431. As with many other operations, the spray operation can make use of either
  432. the primary or secondary color/pattern based on which button (one or two,
  433. respectively) is held down while painting on the canvas.
  434. #BEGIN text "Text"
  435. The text operation allows for typing in the currently selected font.
  436. Pressing mouse button two in the canvas area while inserting text
  437. will paste text from the X clipboard at the current insertion point.
  438.  
  439. See the "Font Menu" for information on changing the selected font.
  440.  
  441. Note:  Changing a font while inserting will not allow backspacing over text
  442. in a previous font.
  443. #POP
  444. #POP
  445. #BEGIN canvas "Painting Window"
  446. The painting window holds a canvas area for painting the displayed image,
  447. menus for performing operations on this image, and primary and secondary
  448. color/pattern palettes along with buttons for adding to these.
  449.  
  450. Painting on the image is accomplished by selecting a operation from
  451. the global toolbox and applying it in the canvas area.  See help on the
  452. specific paint operation for its use.
  453.  
  454. #PUSH
  455. #BEGIN fileMenu "File Menu"
  456. The file menu on the painting window is for saving information associated
  457. with the image displayed on the current paint canvas. 
  458.  
  459. XPaint runs on a variety of displays.  Saving
  460. images will adapt them to the current display type (i.e., a color image 
  461. loaded on a greyscale screen will be saved as a grey image).
  462.  
  463. See "Image Formats" for a description of the image formats usable
  464. by XPaint.
  465.  
  466. Save
  467. #NL
  468.     Save the current image with the original
  469. #NL
  470.     filename and format.  If this is a new
  471. #NL
  472.     image, perform the "Save As" operation.
  473.  
  474. Save As
  475. #NL
  476.     Save the current image with the specified
  477. #NL
  478.     filename and format (default is TIFF).
  479.  
  480. Save Region...
  481. #NL
  482.     Save the selected region, in the original
  483. #NL
  484.     form that it was selected (width, height and
  485. #NL
  486.     rotation).  Odd-shaped regions will be saved
  487. #NL
  488.     as rectangles filled with the background
  489. #NL
  490.     color.  If the output format supports image
  491. #NL
  492.     masks (e.g., TIFF, PNG, XPM), then this
  493. #NL
  494.     information will also be saved.  See "Load
  495. #NL
  496.     Clipboard..." under the toolbox file menu
  497. #NL
  498.     for more information about odd-shaped
  499. #NL
  500.     images.
  501.  
  502. Save Palette...
  503. #NL
  504.     Save the current palette. See "Palette
  505. #NL
  506.     Area" for more information on how
  507. #NL
  508.     patterns are loaded.
  509.  
  510. Revert...
  511. #NL
  512.     Reloads the last saved image. This is
  513. #NL
  514.     equivalent to closing without saving
  515. #NL
  516.     and then opening the original file.
  517. #NL
  518.     You are asked for confirmation. If
  519. #NL
  520.     the image has not been changed since
  521. #NL
  522.     the last save, this operation does
  523. #NL
  524.     nothing.
  525.  
  526. Close
  527. #NL
  528.     Close the current painting window, saving
  529. #NL
  530.     the image if desired.
  531.  
  532. #BEGIN editMenu "Edit Menu"
  533. The edit menu provides for a set of operations that interact with the
  534. current selection and the paint clipboard.  The six first items in this menu
  535. is also accessible through button three on the painting canvas.  
  536. The clipboard is an off-screen image that is loaded either from a selected
  537. region via these operations or from a file.
  538.  
  539. See "Load Clipboard..." on the toolbox "File Menu" for more information
  540. about loading images from a file and "Change Background..." under the
  541. "Image Menu" for more information on the background color.
  542.  
  543. Undo
  544. #NL
  545.     Reverse the last performed operation.
  546. #NL
  547.     Multiple undos are possible; see 'Undo Levels..'
  548. #NL
  549.     in the 'Image' menu.
  550. #NL
  551.     If a region is selected, and you have not moved
  552. #NL
  553.     or resized it, the last region operation is undone.
  554. #NL
  555.  
  556. Redo
  557. #NL
  558.     Cancel the effect of the last undo.
  559. #NL
  560.     This must be done immediately after an undo or
  561. #NL
  562.     redo (before drawing anything new on the canvas).
  563. #NL
  564.  
  565. Cut
  566. #NL
  567.     Load the originally selected region into both 
  568. #NL
  569.     the XPaint and X server clipboards and
  570. #NL
  571.     change the area on the screen to the background
  572. #NL
  573.     color.
  574.  
  575. Copy
  576. #NL
  577.     Load the originally selected region into the
  578. #NL
  579.     XPaint and X server clipboards.
  580.  
  581. Paste
  582. #NL
  583.     Place the image in the clipboard onto the
  584. #NL
  585.     canvas at the last position where button one
  586. #NL
  587.     or two was pressed.  Images are first searched
  588. #NL
  589.     for in the X server clipboard and then the
  590. #NL
  591.     internal XPaint clipboard.
  592.  
  593. Clear
  594. #NL
  595.     Remove the current selection from the paint    
  596. #NL
  597.     canvas.
  598.  
  599. Duplicate
  600. #NL
  601.     Perform both the copy and paste operations in one.
  602.     
  603. Select All
  604. #NL
  605.     Select the entire image on the canvas.
  606. #NL
  607.     (Note:  This does not use the color range options
  608. #NL
  609.     that the select-area operators from the toolbox do!)
  610. #NL
  611.     
  612.  
  613. #BEGIN regionMenu "Region Menu"
  614. This menu provides operations that can be applied to the currently
  615. selected region.  See the "Select Regions" item under the toolbox
  616. Painting tools for information on how to select regions.
  617.  
  618. Note:  The 'undo' operation found under the Edit menu does not work
  619. on these operations!
  620.  
  621. Flip X Axis
  622. #NL
  623.     Flip the current region horizontally.
  624.  
  625. Flip Y Axis
  626. #NL
  627.     Flip the current region vertically.
  628.  
  629. Rotate By
  630. #NL
  631. Rotate...
  632. #NL
  633.     Both of these operations allow for rotating
  634. #NL
  635.     the current image by a specified number of
  636. #NL
  637.     degrees.  Rotation may also be done
  638. #NL
  639.     by pressing button two on the selection.
  640. #NL
  641.     Pressing the Shift button while doing this
  642. #NL
  643.     constrains the rotation to multiples of
  644. #NL
  645.     15 degrees.
  646.  
  647. Crop to region...
  648. #NL
  649.     Discard all portions of the image outside the region.
  650. #NL
  651.     This operation cannot be undone; therefore, you are
  652. #NL
  653.     required to confirm it.
  654.  
  655. Reset
  656. #NL
  657.     Return the current image to its original
  658. #NL
  659.     size and orientation.  Note:  None of the
  660. #NL
  661.     image processing operations will be undone.
  662.  
  663.     
  664. #BEGIN filterMenu  "Filter Menu"
  665. The filter menu provides a set of image processing operations
  666. that can be applied to the currently selected region.  See
  667. the "Select Regions" item under the toolbox Painting tools
  668. for information on how to select regions.
  669.  
  670. Repeat Last
  671. #NL
  672.     This applies the last filter you used again, without
  673. #NL
  674.     querying for any parameters.
  675.  
  676. Invert
  677. #NL
  678.     Inverts the colors of the selected region
  679. #NL
  680.     (e.g., black to white).
  681.  
  682. Sharpen
  683. #NL
  684.     Applies an image processing algorithm in an
  685. #NL
  686.     attempt to increase the detail on the
  687. #NL
  688.     selected region.
  689.  
  690. Smooth
  691. #NL
  692.     Attempts to blend the colors of the region
  693. #NL
  694.     by averaging the pixel's color values with
  695. #NL
  696.     those of its neighbors.
  697.  
  698. Directional Smooth
  699. #NL
  700.     Similar to Smooth, but avoids smearing edges
  701. #NL
  702.     by applying a more sophisticated algorithm.
  703. #NL
  704.     The effect is less pronounced than for Smooth.
  705.  
  706. Despeckle...
  707. #NL
  708.     Tries to remove scanning artifacts etc. by replacing 
  709. #NL
  710.     each pixel by the median of the pixels inside the
  711. #NL    
  712.     n x n mask centered around that pixel. You are
  713. #NL    
  714.     queried for the mask size; this must be odd and
  715. #NL
  716.     larger than 1.
  717.  
  718. Edge Detect
  719. #NL
  720.     Performs an image processing edge
  721. #NL
  722.     detection.
  723.  
  724. Emboss
  725. #NL
  726.     Converts the selected region to a grey image
  727. #NL
  728.     that is highlighted such that the details
  729. #NL
  730.     appear to stand out from the screen.
  731.  
  732. Oil paint...
  733. #NL
  734.     Does an effect similar to an oil painting.
  735. #NL
  736.     You are queried for the mask size, which must
  737. #NL
  738.     be an odd integer. Recommended values range
  739. #NL
  740.     from 3 to 15. Higher values result in a more
  741. #NL
  742.     pronounced effect.
  743.  
  744. Add Noise...
  745. #NL
  746.     Add random noise to the image, giving a 'grainy'
  747. #NL
  748.     appearance. You are queried for the maximum
  749. #NL
  750.     noise value. Recommended values range from 
  751. #NL
  752.     5 to 50. Higher values result in a more
  753. #NL
  754.     pronounced effect.
  755.  
  756. Spread...
  757. #NL
  758.     This operation swaps each pixel in the region with
  759. #NL
  760.     a random pixel near it, giving an effect similar to
  761. #NL
  762.     frosted glass. You are queried for the maximum
  763. #NL
  764.     distance. Good values range from 1 to 10.
  765. #NL
  766.     You can also specify how many iterations you want
  767. #NL
  768.     performed. This is equivalent to manually selecting
  769. #NL
  770.     the operation that many times.
  771.  
  772. Pixelize...
  773. #NL
  774.     Makes the image look low resolution. This works by
  775. #NL
  776.     replacing each 'megapixel' with the average color 
  777. #NL
  778.     within that region. You are queried for the megapixel
  779. #NL
  780.     size; this can be specified as square (e.g., '5') or 
  781. #NL
  782.     rectangular (e.g., '2x4').
  783.  
  784. Blend
  785. #NL
  786.     This operation colors each pixel in the region
  787. #NL
  788.     with a weighted average of the center color and
  789. #NL
  790.     the color on the edge that intersects a line drawn
  791. #NL
  792.     from the center to the pixel in question.
  793. #NL
  794.     The result is to 'blend the region out of existence'.
  795.  
  796. Solarize...
  797. #NL
  798.     Inverts pixels with a value larger than the 
  799. #NL
  800.     specified threshold. This simulates what happens
  801. #NL
  802.     to a photographic film that is exposed to light
  803. #NL
  804.     during development. Works best for greyscale
  805. #NL
  806.     images. You are queried for the threshold (1-99 %).
  807.  
  808. Normalize Contrast
  809. #NL
  810.     Normalizes the contrast by forcing the lightest pixels
  811. #NL
  812.     to white, the darkest pixels to black, and linearly
  813. #NL
  814.     rescaling the ones in between.
  815. #NL
  816.     You are queried for Black and White levels in %.
  817. #NL
  818.     Pixels darker than the Black level will become black,
  819. #NL
  820.     and pixels brighter than the White level will become
  821. #NL
  822.     white. The pixels in between will be rescaled linearly.
  823. #NL
  824.     '100 %' refers to the brightest pixel in the image.
  825.  
  826. Quantize Colors...
  827. #NL
  828.     Reduces the number of colors in the image. The
  829. #NL
  830.     algorithm selects the set of colors that gives
  831. #NL
  832.     the best result and then replaces the original
  833. #NL
  834.     colors with the best match in the new color set.
  835. #NL
  836.     You can choose the number of colors to use,
  837. #NL
  838.     from 2 to 256.
  839.  
  840. Turn into Greyscale
  841. #NL
  842.     Converts all colors in the image to greyscale.
  843.  
  844. #BEGIN imageMenu  "Image Menu"
  845. The image menu provides a set of operations that are applied to
  846. the current image/paint canvas. 
  847.  
  848. Fat Bits
  849. #NL
  850.     Brings up the Fat Bits editor, which allows
  851. #NL
  852.     for editing an enlarged area of the current
  853. #NL
  854.     image without having to enlarge the entire
  855. #NL
  856.     image.
  857.  
  858. Visible Grid
  859. #NL
  860.     Turns on and off a visible black grid
  861. #NL
  862.     between the original pixels on images with a
  863. #NL
  864.     scale greater than 1 (i.e., zoomed).  This
  865. #NL
  866.     grid is only for painting purposes.  It does
  867. #NL
  868.     not affect the actual image.
  869.  
  870. Snap
  871. #NL
  872.     Turns on/off restriction of the current x
  873. #NL
  874.     and y position for most operations to an
  875. #NL
  876.     invisible grid.
  877.  
  878. Snap Spacing...
  879. #NL
  880.     Sets the distance between points on the
  881. #NL
  882.     invisible snap grid.
  883.  
  884. Change Background...
  885. #NL
  886.     This operation changes the background color
  887. #NL
  888.     for the current image (default color is
  889. #NL
  890.     white).  This is only used when a region is
  891. #NL
  892.     erased or cut from the current image and
  893. #NL
  894.     when odd-shaped regions are saved. See
  895. #NL
  896.     "Color Wheel" under the "Pattern Editor" for
  897. #NL
  898.     more information on selecting a color.
  899.  
  900. Change Size...
  901. #NL
  902.     Changes the size of the current canvas by
  903. #NL
  904.     cutting away or adding area on the right and
  905. #NL
  906.     lower sides.  This operation is not
  907. #NL
  908.     reversible (except by 'Revert') and affects
  909. #NL
  910.     the actual image size.
  911.  
  912. Undo Levels...
  913. #NL
  914.     Changes the number of consecutive changes
  915. #NL
  916.     that can be undone or redone. Note that each
  917. #NL
  918.     undo level uses as much memory as the image
  919. #NL
  920.     itself, so large numbers can use up a lot of
  921. #NL
  922.     memory.
  923.  
  924. Autocrop...
  925. #NL
  926.     Changes the size of the current canvas by
  927. #NL
  928.     cutting away any borders. The border color
  929. #NL
  930.     is defined as the color common to at least
  931. #NL
  932.     two corners. If no two corners have the same
  933. #NL
  934.     color, nothing is done.
  935. #NL
  936.     This operation is not reversible and 
  937. #NL
  938.     affects the actual image size.
  939. #NL
  940.  
  941. Change Zoom...
  942. #NL
  943.     Enlarges the working image by the specified
  944. #NL
  945.     scale.  This does not affect the size of the
  946. #NL
  947.     image for saving, etc.
  948.     
  949. #BEGIN patBox   "Palette Area"
  950. There are two palette areas found on the painting window to
  951. select the primary and secondary colors or patterns. These two
  952. selections are accessible by many of the painting tools through
  953. use of either mouse button one or button two, respectively.   See the
  954. specific tool for more information.  All filled objects (i.e., boxes,
  955. ovals, and polygons) are always filled in the secondary color/pattern,
  956. with a border of the primary color/pattern.
  957.  
  958. Colors or patterns may be modified by double-clicking on the icon.
  959. On a colormapped display (i.e., using less than 24-bit colors), changes
  960. to a selected color will change that color in all locations on the
  961. paint canvas as well.  Color selection is done through a color
  962. wheel similar to that used under the "Pattern Editor".  See help on
  963. the "Pattern Editor" for more details as well as for information
  964. on editing patterns.
  965.  
  966. Colors and patterns are loaded from information merged
  967. from the following files each time a canvas is created:
  968. #NL
  969.     .XPaintrc in the user's home directory
  970. #NL
  971.     .XPaintrc in the current directory
  972.  
  973. A quick method for adding a new color is found by using the "Lookup"
  974. button.  This button allows the user to select any color available
  975. on the screen and will either locate it in the current palette or
  976. add it.   Once the color is found in the palette, it is selected.
  977.  
  978. Note:  Color/pattern changes affect both primary and secondary palettes.
  979.  
  980. All of the patterns and colors can be saved with the "Save Palette..."
  981. item in the file menu.
  982. #PUSH
  983. #BEGIN pattern "Pattern Editor"
  984. The pattern editor creates new patterns or modifies existing ones
  985. for use on the painting canvas.
  986.  
  987. The window contains the current pattern and (depending on display
  988. type) the current colormap and a color selection area.
  989.  
  990. Patterns are by default 24x24 in size, but may be set to any size
  991. through the "Size" menu.  The other menus available provide
  992. similar functionality to those in the paint window and pattern
  993. editing uses the normal paint operations.
  994.  
  995. Patterns may be individually saved through the "Save As" option in
  996. the "File" menu or saved with the palette.  See "Save Palette..."
  997. under the Paint Window.  When loading an individual pattern, only
  998. the portion of the pattern that fits in the pattern area will be
  999. included.
  1000.  
  1001. The "Grab" button allows the user to select a portion of the current
  1002. screen to fill the pattern area. 
  1003. #PUSH
  1004. #BEGIN colormap "Colormap Area"
  1005. When using a colormapped display, selecting a colormap entry will
  1006. allow the user to change the value of that entry.  This will change
  1007. all pixels on the canvas that share this colormap index.
  1008.  
  1009. The "Lookup" button allows the user to select any color available on
  1010. the screen and will locate the colormap entry for this color value.
  1011.  
  1012. Note:  Manipulating colormap entries effects the canvas immediately
  1013. and does not revert when "Cancel" is chosen.
  1014.  
  1015. #BEGIN colorwheel "Color Wheel"
  1016. The XPaint color selection allows access to both the HSV or RGB color
  1017. space models.  The color wheel along with the value
  1018. slider represents HSV, while the red, green, and blue sliders are for
  1019. manipulating the color in an RGB space.  Modifications in either of
  1020. these color spaces will effect the other.
  1021.  
  1022. Colors can be selected on the color wheel by using the mouse to drag
  1023. the selection circle or to click on a desired color.   Changes
  1024. to value will determine the brightness of the chosen color.  Colors
  1025. can also be modified through the red, green, or blue sliders or by
  1026. entering values in the text fields.
  1027.  
  1028. The "Match" button will set the current color by allowing the user to
  1029. select any color on the screen.  The exact color will be determined
  1030. using the colormap of the selected window.
  1031. #POP
  1032. #POP
  1033. #POP
  1034. #BEGIN fileformat    "Image Formats"
  1035. XPaint can support a variety of image file formats, based on
  1036. library availability at compile time.  Some of these formats may not
  1037. be accessible in the current running version.
  1038.  
  1039. The table below provides a short summary of the features of each image
  1040. format and support provided by XPaint.  Note that not all formats are
  1041. supported for both read and write operations.
  1042.  
  1043. Color depth is given in terms of the number of bits used to store the
  1044. colors in the image.  This means that a color depth of 1-bit can only
  1045. store black/white images, while 24-bit color formats can store images
  1046. containing up to 2**24 (or approx. 16 million) colors.  Regardless of
  1047. the image format, saved images always reflect the ability of current 
  1048. display type (i.e., a color image loaded on a greyscale screen will be 
  1049. saved as a grey image).  See the Possible Data Loss section for more
  1050. details.
  1051.  
  1052. The image mask feature of an image format provides the ability to
  1053. save/load odd-shaped regions (i.e., regions are not required to be 
  1054. rectangular and may have "holes" in them).   See "Save Region" and 
  1055. "Load Clipboard..." for more information.
  1056.  
  1057. Detailed information about each format is at the end of this section.
  1058.  
  1059.                         Color        Image
  1060. #NL
  1061.         Read    Write    depth        mask
  1062. #NL
  1063. GIF        yes        yes        8-bit            no
  1064. #NL
  1065. JPEG    yes        yes        24-bit        no
  1066. #NL
  1067. PNG        yes        yes        8, 24-bit        yes
  1068. #NL
  1069. PPM        yes        yes        24-bit        no
  1070. #NL
  1071. PS        no        yes        24-bit        no
  1072. #NL
  1073. SGI        yes        yes        24-bit        no
  1074. #NL
  1075. TIFF    yes        yes        8, 24-bit        yes
  1076. #NL
  1077. XBM    yes        yes        1-bit            no
  1078. #NL
  1079. XPM    yes        yes        8-bit            yes
  1080. #NL
  1081. XWD    yes        yes        24-bit        no
  1082.  
  1083. GIF - Graphics Interchange Format
  1084. #NL
  1085.     A popular image format used across a variety
  1086. #NL
  1087.     of platforms, including PCs.
  1088.  
  1089. JPEG - Joint Photographic Experts Group Format
  1090. #NL
  1091.     A standardized, lossy format for storing
  1092. #NL
  1093.     compressed color and greyscale images
  1094. #NL
  1095.     of natural scenes.
  1096.  
  1097. PNG - Portable Network Graphics Format
  1098. #NL
  1099.     A new format designed to replace GIF and,
  1100. #NL
  1101.     to some extent, TIFF.  It has a better
  1102. #NL
  1103.     compression engine than either GIF or TIFF
  1104. #NL
  1105.     and is a lossless format (unlike JPEG).
  1106.  
  1107. PPM - Portable PixMap Format
  1108. #NL
  1109.     Image format provided by the PBMPlus/NetPBM
  1110. #NL
  1111.     toolkit that allows for converting to a wide variety
  1112. #NL
  1113.     of other formats.
  1114.  
  1115. PS - PostScript Format
  1116. #NL
  1117.     PostScript images are normally used by most
  1118. #NL
  1119.     printers and text-processing packages.
  1120.  
  1121. SGI - Silicon Graphics, Inc., Format
  1122. #NL
  1123.     An SGI-specific image format, supported by the
  1124. #NL
  1125.     libraries on SGI machines.  This format is not
  1126. #NL
  1127.     available on other platforms.
  1128.  
  1129. TIFF - Tagged Image File Format
  1130. #NL
  1131.     A large, complex image format used by XPaint
  1132. #NL
  1133.     as its default format.
  1134.  
  1135. XBM - X Window BitMap
  1136. #NL
  1137.     A black and white image format used by the
  1138. #NL
  1139.     X Window System.
  1140.  
  1141. XPM - X Window PixMap
  1142. #NL
  1143.     XPM images are stored in an ASCII text
  1144. #NL
  1145.     format that can be included in programs.
  1146.  
  1147. XWD - X Window Dump
  1148. #NL
  1149.     Used for screen dumps by the X Window
  1150. #NL
  1151.     System.
  1152.  
  1153. #BEGIN about        "About XPaint"
  1154. NOTE: This (beta) version of XPaint is released and maintained by Torsten
  1155. Martinsen (bullestock@dk-online.dk), except for the PNG code, which is
  1156. written and maintained by Greg Roelofs (newt@uchicago.edu).  It is
  1157. based on XPaint 2.1.1, which was written by David Koblas.  Please do NOT
  1158. send bug reports, etc., to David Koblas.
  1159.  
  1160. The message below is the original 'About' message from version 2.1.1.
  1161.  
  1162.                ----------------------------
  1163.  
  1164. Hopefully, you find this software useful. If you find any bugs or have
  1165. any comments, feel free to contact me.
  1166.  
  1167. This software is created as DonateWare. If you enjoy using XPaint,
  1168. it would be appreciated if you would make a donation to the
  1169. author in the form of cookies, money, employment, or whatever.
  1170.  
  1171. If you or your firm is looking to hire a skilled consultant, contact
  1172. me for more details.
  1173.  
  1174. David Koblas (koblas@netcom.com)
  1175. #NL
  1176. Extra Mile Consulting
  1177. #NL
  1178. PO Box 1352
  1179. #NL
  1180. Mountain View, CA 94042-1352 USA
  1181.  
  1182. #BEGIN copyright    "Copyright Information"
  1183. Copyright (C) 1993, David Koblas
  1184.  
  1185. Copyright (C) 1995, 1996, Torsten Martinsen
  1186. #NL
  1187. Copyright (C) 1996, Greg Roelofs
  1188.  
  1189. Permission to use, copy, modify, and to distribute this software and
  1190. its documentation for any purpose is hereby granted without fee,
  1191. provided that the above copyright notice appear in all copies and that
  1192. both that copyright notice and this permission notice appear in
  1193. supporting documentation.  There are no representations about the
  1194. suitability of this software for any purpose.  This software is
  1195. provided "as is" without express or implied warranty.
  1196.