home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / suite.zip / warpaint.zip / warpaint.hlp (.txt) < prev   
OS/2 Help File  |  2000-01-05  |  68KB  |  348 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. WarPaint 
  5.  
  6. WarPaint is a basic paint program for OS/2. It allows the user to work with 
  7. existing bitmaps or to create bitmaps from scratch. We consider it to be a 
  8. pixel paint program. One of the handier aspects of it is that you can zoom in 
  9. to a very high degree to do pixel by pixel changes. The OverView allows you to 
  10. select a small area to zoom in on as well.
  11.  
  12. WarPaint has been knocking around PillarSoft for about three years but has been 
  13. held from release by a couple of issues that may or may not affect most users. 
  14. If it is a major part of the reason you would be interested in purchasing the 
  15. PillarSoft Suite, please be sure it works satisfactorily in your case before 
  16. making any commitment.
  17.  
  18. Major bitmap formats supported by WarPaint are:
  19.  
  20. o   BMP
  21.  
  22. o   GIF
  23.  
  24. o   PCX
  25.  
  26. o   TIF
  27.  
  28. o   TGA
  29.  
  30. There are other lesser known formats that WarPaint will work with but most are 
  31. so obscure that we won't mention them here.
  32.  
  33. The JPG format is not supported internally but because it is such an important 
  34. format we have made provisions for WarPaint to use cjpeg.exe and djpeg.exe (if 
  35. present) to convert JPG's into a temporary BMP file for viewing and editing. 
  36. The file may be saved as a JPG after editing but the quality is very poor at 
  37. this time. You will notice that it isn't quite seamless and native by the extra 
  38. time it takes to load the jpg's.
  39.  
  40.  
  41. ΓòÉΓòÉΓòÉ 2. Menu items ΓòÉΓòÉΓòÉ
  42.  
  43. Menu items 
  44.  
  45. File 
  46.  
  47. Edit 
  48.  
  49. Selected 
  50.  
  51. View 
  52.  
  53. Tools 
  54.  
  55. Help 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 2.1. File ΓòÉΓòÉΓòÉ
  59.  
  60. File 
  61.  
  62. New - Start a new editing session with a clean canvas.
  63.  
  64. Open - Open a bitmap and load it.
  65.  
  66. Save - Save the current bitmap.
  67.  
  68. Save as - Save the current bitmap under a new name or format.
  69.  
  70. Print - Print the bitmap.
  71.  
  72. Capture screen - more...
  73.  
  74. Convert to B/W - Convert currently loaded bitmap to a two color (black and 
  75. white) bitmap.
  76.  
  77. Exit - Exit the program 
  78.  
  79.  
  80. ΓòÉΓòÉΓòÉ 2.2. Edit ΓòÉΓòÉΓòÉ
  81.  
  82. Edit 
  83.  
  84. Undo - Undoes last operation 
  85.  
  86. Cut - Cuts currently selected area to clipboard 
  87.  
  88. Copy - Copies currently selected area to clipboard 
  89.  
  90. Paste - Pastes currently selected area from clipboard 
  91.  
  92. Clear - Deletes currently selected area 
  93.  
  94. Select all - Selects all of the canvas area 
  95.  
  96. Select none - Deselects any previous selection 
  97.  
  98. Font - Sets font to be used with the "Text" tool 
  99.  
  100.  
  101. ΓòÉΓòÉΓòÉ 2.3. Selected ΓòÉΓòÉΓòÉ
  102.  
  103. Selected 
  104.  
  105. Crop - Removes all areas outside of the currently selected area and resets the 
  106. canvas to show only the selected area as the current graphic.
  107.  
  108. Flip - Allows the user to flip the selected area horizontally or vertically.
  109.  
  110. Rotate - Allows the user to rotate the selected area 90, 180 or 270 degrees.
  111.  
  112.  
  113. ΓòÉΓòÉΓòÉ 2.4. View ΓòÉΓòÉΓòÉ
  114.  
  115. View 
  116.  
  117. Tool Palette - Turns the Tool Palette on or off. (more on the Tool Palette)
  118.  
  119. Color Palette - Turns the Color Palette on or off. (more on the Color Palette)
  120.  
  121. Image Settings - Opens the Image Settings window. (more on Image Settings)
  122.  
  123. Full Screen - Selecting this or pressing F3 stretches the loaded bitmap to a 
  124. full screen view. Press <escape> to close this view and return to WarPaint.
  125.  
  126. OverView - Opens the OverView window where the user can select any area of the 
  127. loaded bitmap to zoom in on by drawing a box around it.
  128.  
  129. Zoom in - Zooms the view of the loaded bitmap by 2 times it's present size.
  130.  
  131. Zoom out - Zooms the view out on the loaded bitmap by half it's present size.
  132.  
  133. Actual size - Returns the loaded bitmap to it's actual size in the editing window.
  134.  
  135.  
  136. ΓòÉΓòÉΓòÉ 2.5. Tools ΓòÉΓòÉΓòÉ
  137.  
  138. Tools Menu 
  139.  
  140. The Tools menu selection is much like the Tool Palette with the added option of 
  141. choosing Brush, eraser and spray styles and shapes.
  142.  
  143. The tools are selected by clicking on them, like any other menu item would be 
  144. selected. Your cursor should change to whatever tool you have chosen.
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 2.6. Help ΓòÉΓòÉΓòÉ
  148.  
  149. Help 
  150.  
  151. Not much to tell you here. Pretty much self-explanatory.
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 3. General help ΓòÉΓòÉΓòÉ
  155.  
  156. General help 
  157.  
  158. Tool Palette 
  159.  
  160. Color Palette 
  161.  
  162. Image Settings 
  163.  
  164. Screen Capture 
  165.  
  166.  
  167. ΓòÉΓòÉΓòÉ 3.1. Tool Pallette ΓòÉΓòÉΓòÉ
  168.  
  169. Tool Palette 
  170.  
  171. The Tool Palette allows the user to select the tool he would like to be active 
  172. while he is making his next change to the current graphic.
  173.  
  174. Like the Color Palette you may resize the Tool Palette to your preference and 
  175. the size should be saved for future reference when you close the application.
  176.  
  177. The Tool Palette selections are:
  178.  
  179. Select - The selector tool. Used to outline areas for other operations. A 
  180. single click of the selector tool will automatically outline irregular areas if 
  181. the are a constant color.
  182.  
  183. Lasso - Another selection tool that allows drawing and irregular area to be 
  184. copied or moved etc.
  185.  
  186. Pen - Used to draw lines or separate pixels.
  187.  
  188. Brush - Used to draw in a larger scale. Brush sizes and shapes may be selected 
  189. from the "Tools" menu.
  190.  
  191. Erase - Erases an area. Eraser sizes and shapes may be selected from the 
  192. "Tools" menu.
  193.  
  194. Extract - The eyedropper is used to retrieve the exact color being used in any 
  195. given area.
  196.  
  197. Spray - Works like a can of spray paint. Patterns may be selected from the 
  198. "Tools" menu.
  199.  
  200. Text - Allows the user to type text into a graphic. Text size and font may be 
  201. selected from the "Edit" --> "Font" menu items.
  202.  
  203. Fill - Flood fills an area on the canvas. This doesn't always seem to work to 
  204. well unless it is filling over white.
  205.  
  206. Line - Draws a line. Mouse button down, move to line end and release the mouse button.
  207.  
  208. Rect - Draws a rectangle. Mouse button down, move to opposite corner and 
  209. release the mouse button.
  210.  
  211. Round - Draws a rectangle with rounded corners. Mouse button down, move 
  212. opposite corner and release the mouse button.
  213.  
  214. Diam - Draws a diamond shape. Mouse button down, move to diamond end and 
  215. release the mouse button.
  216.  
  217. Ellipse - Draws circles and ellipses. Mouse button down for center, move mouse 
  218. give desired shape and size and release the mouse button.
  219.  
  220. Line Attr - Opens the Line Attributes dialog. Set your line width, choose a 
  221. line type or select an arrow end for a line.
  222.  
  223.  
  224. ΓòÉΓòÉΓòÉ 3.2. Color Pallette ΓòÉΓòÉΓòÉ
  225.  
  226. Color Palette 
  227.  
  228. The color Palette contains a color wheel or a sixteen color value set depending 
  229. on how it is toggled by the button at the base of the Palette.
  230.  
  231. Any click on either of these palettes will change the working color in use to 
  232. whatever is selected.
  233.  
  234. Like the Tool Palette you may resize the Color Palette to your preference and 
  235. the size should be saved for future reference when you close the application.
  236.  
  237. The "Pattern selector" on the bottom half of the Palette allows the user to 
  238. choose whether a square or circle tool, for example, will draw in a solid 
  239. color, an outline with the selected color or some type of hash with the 
  240. selected color.
  241.  
  242. The Pattern selector has been a bone of contention in some of our tests. It 
  243. works fine on some machines but on a machine with an S3 ViRGE it has been very troublesome.
  244.  
  245. For this reason, it is not turned on by default but is available to be tested 
  246. or used by using the /P parameter when starting WarPaint.
  247.  
  248. To do this you must:
  249.  
  250. Open the WarPaint desktop object properties by right clicking the icon and 
  251. selecting "Properties."
  252.  
  253. Enter /P in the "Optional Parameters" field.
  254.  
  255. Close the desktop object.
  256.  
  257. Start the program.
  258.  
  259. Note: It has shown itself to be troublesome here after a fresh reboot but seems 
  260. to work OK after some unspecified period of time. We are baffled by the 
  261. behavior and wish to avoid problems but wanted it to be available to those of 
  262. you that may have no problems with it. (as it is on every other machine we 
  263. tested on)
  264.  
  265.  
  266. ΓòÉΓòÉΓòÉ 3.3. Image Settings ΓòÉΓòÉΓòÉ
  267.  
  268. Image Settings 
  269.  
  270. There are three pages in the Image settings notebook.
  271.  
  272. o   Attributes - Sets the image size and bits per pixel. You may set any size 
  273.     in the fields and the program will stretch or squish the bitmap to the size 
  274.     desired. The bit per pixel settings are:
  275.  
  276.     1 bit - 2 color (Black and white)
  277.  
  278.     4 bit - 16 color 
  279.  
  280.     8 bit - 256 color 
  281.  
  282.     16 bit - 65k color 
  283.  
  284. o   Grid - Overlays a grid on the canvas to aid in spacing things properly. 
  285.     Snap to grid will make all new work start and end on the gridlines.
  286.  
  287. o   Line styles - Allows the user to set a line type, line size, use arrow ends 
  288.     and set arrow sizes on all new lines.
  289.  
  290.  
  291. ΓòÉΓòÉΓòÉ 3.4. Screen Capture ΓòÉΓòÉΓòÉ
  292.  
  293. Screen Capture 
  294.  
  295. This is a very simple screen capture. When selected, WarPaint will minimize 
  296. itself and after a three second wait, it will snap a picture of the screen and 
  297. return you to the program with the screen capture loaded.
  298.  
  299.  
  300. ΓòÉΓòÉΓòÉ 4. Known Problems ΓòÉΓòÉΓòÉ
  301.  
  302. Known problems 
  303.  
  304. The pattern selector can be quite flaky and does not work on at least one 
  305. machine here with an S3 card immediately after a clean boot.
  306.  
  307. After a fresh reboot, any programmatic selection of the pattern selector causes 
  308. a trap in PmMerge.dll. If we do not select it programmatically, it will run but 
  309. manually selecting a pattern can cause the program to become unresponsive. 
  310. After some unknown amount of time it seems to work fine but we have disabled it 
  311. to avoid problems.
  312.  
  313. It can be enabled by starting WarPaint with the /P parameter. This can be 
  314. accomplished by doing the following:
  315.  
  316. 1.  Open the WarPaint desktop object properties by right clicking the icon and 
  317.     selecting "Properties."
  318.  
  319. 2.  Enter /P in the "Optional Parameters" field.
  320.  
  321. 3.  Close the desktop object.
  322.  
  323. 4.  Start the program.
  324.  
  325. The pattern selector is actually an important tool because it is the only way 
  326. for the user to toggle between drawing outlines of circles, squares etc or 
  327. drawing them filled with color.
  328.  
  329. If you happen to select a pattern and the cursor disappears or the program 
  330. becomes unresponsive, press the Control-Escape key combination and end the 
  331. program immediately. The more time you try to make it work, the longer it will 
  332. take to kill it.
  333.  
  334. More about it in Color Palette. 
  335.  
  336. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  337.  
  338. The Fill tool works fine on an empty canvas but seems to have trouble filling 
  339. over any color. 
  340.  
  341. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  342.  
  343. When doing a Screen Capture, the Tool Palette and the Color Palette will move. 
  344. We will be addressing this in upcoming releases but please keep in mind that 
  345. the "standard" applications in the suite will probably receive attention 
  346. earlier than any of the "Bonus" type apps like WarPaint.
  347.  
  348.