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