home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / graphic / pmdraw3 / pmdraw.hlp (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1990-02-27  |  12.8 KB  |  580 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Extended Help for PM Draw ΓòÉΓòÉΓòÉ
  3.  
  4. The PM Draw program is a graphics program that allows you to create and edit 
  5. OS/2 Presentation Manager bitmaps. There are two primary modes of operation: 
  6. graphics mode and text mode. 
  7.  
  8. Graphics Mode 
  9.  
  10. The graphics mode of operation is in effect whenever the Text Mode option in 
  11. the Options menu is not selected. In this mode, you can create graphics images 
  12. using both the keyboard and mouse interfaces. 
  13.  
  14. PM Draw provides two types of graphics items: curves and solid figures. Curves 
  15. are single-line graphics such as straight lines, circular arcs, parabolic 
  16. curves, Bezier splines, and fillets. Solid figures consist of such items as 
  17. pentagons, hexagons, circles, ellipses, hearts, and stars. There are also three 
  18. graphics items which can behave as either curves or solid figures: rectangles, 
  19. diamonds and triangles. The behavior of these items is determined by the Fill 
  20. Solid Figures option in the Options menu. 
  21.  
  22. Whenever an item is created while in the graphics mode, it is automatically 
  23. saved in a memory bitmap, which maintains an image of the screen workspace. If 
  24. item chain construction is enabled, the item is also saved in the item chain. 
  25.  
  26. Note:  Any text characters entered while in the graphics mode are ignored. 
  27.  
  28. Text Mode 
  29.  
  30. The text mode of operation is in effect whenever the Text Mode option in the 
  31. Options menu is selected. In this mode, you can create both graphics and 
  32. character images, using the mouse interface for graphics items and the keyboard 
  33. interface for character items. 
  34.  
  35. While in text mode, you can set the current font in two ways: use one of the 
  36. currently loaded fonts (Available Fonts in the Options menu), or create a new 
  37. font based on one of the currently loaded fonts (Create Font in the Options 
  38. menu). The second method allows you to add such features as italics, 
  39. underscore, and strike-out to your font. 
  40.  
  41.  
  42. ΓòÉΓòÉΓòÉ 2. Menus ΓòÉΓòÉΓòÉ
  43.  
  44. Provides help for the individual menus and submenus available for the PM Draw 
  45. program. 
  46.  
  47.  
  48. ΓòÉΓòÉΓòÉ 2.1. Help for 'File' Menu ΓòÉΓòÉΓòÉ
  49.  
  50. Use these choices to perform operations which affect the current bitmap file in 
  51. memory. 
  52.  
  53.  New 
  54.       Erase the current bitmap from memory and start a new one. 
  55.  
  56.  Open 
  57.       Load a bitmap from a file. 
  58.  
  59.  Save 
  60.       Save the current bitmap to a file, using the current file name. 
  61.  
  62.  Save As 
  63.       Save the current bitmap to a file, using a new file name. 
  64.  
  65.  Bitcount 1 
  66.       Set bits-per-pel count to 1 (Monochrome bitmaps). 
  67.  
  68.  Bitcount 4 
  69.       Set bits-per-pel count to 4 (16-color bitmaps). 
  70.  
  71.  Bitcount 8 
  72.       Set bits-per-pel count to 8 (256-color bitmaps). 
  73.  
  74.  Bitcount 24 
  75.       Set bits-per-pel count to 24 (Full-color bitmaps). 
  76.  
  77.  About 
  78.       Display release information for PM Draw. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 2.1.1. Help for 'New' ΓòÉΓòÉΓòÉ
  82.  
  83. Use this choice to create a new bitmap, specifying a name for the bitmap file. 
  84.  
  85. This brings up a simple dialog box containing a prompt string ("File Name:"), 
  86. an entry field, and two pushbuttons ("Enter" and "Cancel"). If "Enter" is 
  87. selected, the screen is cleared and a new bitmap is created. "Cancel" restores 
  88. the bitmap to its previous state. 
  89.  
  90.  
  91. ΓòÉΓòÉΓòÉ 2.1.2. Help for 'Open' ΓòÉΓòÉΓòÉ
  92.  
  93. Use this choice to load a bitmap file into the work space. 
  94.  
  95. This brings up a dialog box containing an entry field for the file search 
  96. template, a list box for all files in the current or selected directory which 
  97. match the search template, a list box for all drives and directories available 
  98. from the current or selected directory, and two pushbuttons ("Enter" and 
  99. "Cancel"). 
  100.  
  101. The file search template is initialized to find all bitmap files with the 
  102. default file extension ("*.bmp"). 
  103.  
  104. Note:  Any changes made to the search template or directory selection will be 
  105. saved between calls to this dialog. 
  106.  
  107.  
  108. ΓòÉΓòÉΓòÉ 2.1.3. Help for 'Save' ΓòÉΓòÉΓòÉ
  109.  
  110. Use this choice to save the bitmap in the work space to a file, using the 
  111. current file name. 
  112.  
  113. If there is no file name associated with the current bitmap, then a dialog 
  114. appears prompting for one. 
  115.  
  116.  
  117. ΓòÉΓòÉΓòÉ 2.1.4. Help for 'Save As' ΓòÉΓòÉΓòÉ
  118.  
  119. Use this choice to save the bitmap in the work space to a file, using a new 
  120. file name. 
  121.  
  122. If there is a file name associated with the current bitmap, the dialog appears 
  123. with the current file name in the name entry field. 
  124.  
  125.  
  126. ΓòÉΓòÉΓòÉ 2.1.5. Help for 'Bitcount 1' ΓòÉΓòÉΓòÉ
  127.  
  128. Use this choice to set the current bitmap to a monochrome format, consisting of 
  129. 1 bit per pel and 1 color plane. In this format, the bitmap color data consists 
  130. of 2 values, which map to the RGB color information for each pel. 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 2.1.6. Help for 'Bitcount 4' ΓòÉΓòÉΓòÉ
  134.  
  135. Use this choice to set the current bitmap to a 16-color format, consisting of 4 
  136. bits per pel and 1 color plane. In this format, the bitmap color data consists 
  137. of 16 values, which map to the RGB color information for each pel. 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 2.1.7. Help for 'Bitcount 8' ΓòÉΓòÉΓòÉ
  141.  
  142. Use this choice to set the current bitmap to a 256-color format, consisting of 
  143. 8 bits per pel and 1 color plane. In this format, the bitmap color data 
  144. consists of 256 values, which map to the RGB color information for each pel. 
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 2.1.8. Help for 'Bitcount 24' ΓòÉΓòÉΓòÉ
  148.  
  149. Use this choice to set the current bitmap to a full color format, consisting of 
  150. 24 bits per pel and 1 color plane. In this format, the bitmap color data 
  151. contains no values, since the full RGB color information is contained in the 
  152. bits for each pel. 
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ 2.1.9. Help for 'About' ΓòÉΓòÉΓòÉ
  156.  
  157. Use this choice to see information relating to the current release of the PM 
  158. Draw program. 
  159.  
  160. Selecting this option displays a small message box containing the name of the 
  161. program, the version level, and the copyright notice for the program. 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 2.2. Help for 'Edit' Menu ΓòÉΓòÉΓòÉ
  165.  
  166. Use this choice for information of the 'Edit' menu. 
  167.  
  168.  
  169. ΓòÉΓòÉΓòÉ 2.3. Help for 'Options' Menu ΓòÉΓòÉΓòÉ
  170.  
  171. Use this choice for information of the 'Options' menu. 
  172.  
  173.  
  174. ΓòÉΓòÉΓòÉ 2.4. Help for 'Graphics' Menu ΓòÉΓòÉΓòÉ
  175.  
  176. Use these choices to set the current graphics drawing mode for the PM Draw 
  177. program. 
  178.  
  179.  Curves 
  180.       Provides a list of single-line graphics drawing modes, including lines 
  181.       and curves. 
  182.  
  183.  Figures 
  184.       Provides a list of solid graphics drawing items, including circles, 
  185.       stars, pentagons, hexagons, and hearts. 
  186.  
  187.  Special 
  188.       Provides a list of special graphics drawing modes, whose behavior depends 
  189.       on the state of the Fill Solid Figures flag in the Options menu. 
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ 2.4.1. Help for 'Curves' Submenu ΓòÉΓòÉΓòÉ
  193.  
  194. Use this choice for information of the 'Curves' menu. 
  195.  
  196.  
  197. ΓòÉΓòÉΓòÉ 2.4.2. Help for 'Figures' Submenu ΓòÉΓòÉΓòÉ
  198.  
  199. Use this choice for information of the 'Figures' menu. 
  200.  
  201.  
  202. ΓòÉΓòÉΓòÉ 2.4.3. Help for 'Special' Submenu ΓòÉΓòÉΓòÉ
  203.  
  204. Use this choice for information of the 'Special' menu. 
  205.  
  206.  
  207. ΓòÉΓòÉΓòÉ 2.5. Help for 'Colors' Menu ΓòÉΓòÉΓòÉ
  208.  
  209. Use these choices to set the foreground and background color values for text 
  210. and graphics drawing. 
  211.  
  212.  Pre-defined 
  213.       Provides a list of pre-defined color values for quick selection of the 
  214.       foreground drawing color. 
  215.  
  216.  Gray-scale 
  217.       Provides a list of monochrome color values, including black, white, and 
  218.       two shades of gray. 
  219.  
  220.  RGB 
  221.       Initiates a dialog which allows you to set the exact foreground color by 
  222.       selecting indices for red, green and blue intensity. 
  223.  
  224.  Background 
  225.       Provides a list of pre-defined color values for the background drawing 
  226.       color. This value only has meaning when drawing text. 
  227.  
  228.  
  229. ΓòÉΓòÉΓòÉ 2.6. Help for 'Exit' Menu ΓòÉΓòÉΓòÉ
  230.  
  231. Use these choices to exit the program or return to the graphics creation 
  232. environment. 
  233.  
  234.  Exit PM Draw 
  235.       Terminate the program. 
  236.  
  237.  Resume 
  238.       Return to graphics creation (do nothing). 
  239.  
  240.  
  241. ΓòÉΓòÉΓòÉ 2.6.1. Help for 'Exit PM Draw' ΓòÉΓòÉΓòÉ
  242.  
  243. Use this choice to end a PM Draw graphics session. If the image has been 
  244. modified since the last file save, a confirmation box is presented before 
  245. program termination. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 2.6.2. Help for 'Resume' ΓòÉΓòÉΓòÉ
  249.  
  250. Use this choice to return to the PM Draw program without any alterations to the 
  251. graphics creation environment. Selecting this option causes the program to 
  252. behave as if you did not do anything (it has no effect). 
  253.  
  254.  
  255. ΓòÉΓòÉΓòÉ 2.7. Help for 'Help' Menu ΓòÉΓòÉΓòÉ
  256.  
  257. Use these choices to find out how to use help, to get extended help, to go to a 
  258. list of keys, or to go to the help index. 
  259.  
  260.  Help for help 
  261.       Provides detailed information on the kinds of help available and how to 
  262.       use help. 
  263.  
  264.  Extended help 
  265.       Displays general help. 
  266.  
  267.  Keys help 
  268.       Displays a list of keys. 
  269.  
  270.  Help index 
  271.       Displays the help index. 
  272.  
  273.  
  274. ΓòÉΓòÉΓòÉ 2.7.1. Help for 'Help for Help' ΓòÉΓòÉΓòÉ
  275.  
  276. Use this choice to obtain information on how to use the Help facility. 
  277.  
  278.  
  279. ΓòÉΓòÉΓòÉ 2.7.2. Help for 'Extended Help' ΓòÉΓòÉΓòÉ
  280.  
  281. Use this choice to obtain general information on the tasks you can perform 
  282. while you are viewing a help window. 
  283.  
  284.  
  285. ΓòÉΓòÉΓòÉ 2.7.3. Help for 'Keys Help' ΓòÉΓòÉΓòÉ
  286.  
  287. Use this choice to see a list of keys and a description of the function of the 
  288. keys. 
  289.  
  290.  
  291. ΓòÉΓòÉΓòÉ 2.7.4. Help for 'Help Index' ΓòÉΓòÉΓòÉ
  292.  
  293. Use this choice to display the help index. 
  294.  
  295. The help index lists the titles of the help information that is available. 
  296.  
  297.  
  298. ΓòÉΓòÉΓòÉ 3. Keyboard Accelerators ΓòÉΓòÉΓòÉ
  299.  
  300. The list of keys is arranged in groups. 
  301.  
  302. ACCELERATOR KEYS 
  303.  
  304.  Ctrl+b 
  305.       Start/Stop building item chain 
  306.  
  307.  Ctrl+f 
  308.       Toggle solid figure fill 
  309.  
  310.  Ctrl+k 
  311.       Toggle click position marking 
  312.  
  313.  Ctrl+x 
  314.       Toggle graphics/text mode 
  315.  
  316.  Shift+F2 
  317.       Restore bitmap from memory 
  318.  
  319.  Alt+a 
  320.       Set circular arc drawing mode 
  321.  
  322.  Alt+c 
  323.       Set solid circle drawing mode 
  324.  
  325.  Alt+d 
  326.       Set diamond drawing mode 
  327.  
  328.  Alt+e 
  329.       Erase entire bitmap 
  330.  
  331.  Alt+f 
  332.       Draw a fillet curve 
  333.  
  334.  Alt+h 
  335.       Set solid heart drawing mode 
  336.  
  337.  Alt+i 
  338.       Set solid ellipse drawing mode 
  339.  
  340.  Alt+l 
  341.       Set straight line drawing mode 
  342.  
  343.  Alt+n 
  344.       Draw a Bezier spline curve 
  345.  
  346.  Alt+p 
  347.       Set solid pentagon drawing mode 
  348.  
  349.  Alt+r 
  350.       Set rectangle drawing mode 
  351.  
  352.  Alt+t 
  353.       Set triangle drawing mode 
  354.  
  355.  Alt+v 
  356.       Set parabolic curve drawing mode 
  357.  
  358.  Alt+x 
  359.       Set solid hexagon drawing mode 
  360.  
  361.  Alt+1 
  362.       Erase Quadrant I (upper-right corner of bitmap) 
  363.  
  364.  Alt+2 
  365.       Erase Quadrant II (upper-left corner of bitmap) 
  366.  
  367.  Alt+3 
  368.       Erase Quadrant III (lower-left corner of bitmap) 
  369.  
  370.  Alt+4 
  371.       Erase Quadrant IV (lower-right corner of bitmap) 
  372.  
  373.  Alt+5 
  374.       Set solid 5-pointed star drawing mode 
  375.  
  376.  Alt+6 
  377.       Set solid 6-pointed star drawing mode 
  378.  
  379.  Alt+7 
  380.       Set solid 7-pointed star drawing mode 
  381.  
  382.  Alt+8 
  383.       Set solid 8-pointed star drawing mode 
  384.  
  385.  Alt+9 
  386.       Set solid 9-pointed star drawing mode 
  387.  
  388.  Alt+F2 
  389.       Draw the item chain in the bitmap 
  390.  
  391.  Alt+F3 
  392.       Save the current bitmap to a file 
  393.  
  394.  F3 
  395.       Exit program 
  396.  
  397.  F12 
  398.       Select foreground color 
  399.  
  400.  CLIPBOARD KEYS 
  401.  
  402.  Ctrl+Ins 
  403.       Copy selected area to clipboard 
  404.  
  405.  Shift+Ins 
  406.       Paste bitmap image from clipboard 
  407.  
  408.  Shift+Del 
  409.       Cut selected area to clipboard 
  410.  
  411.  Del 
  412.       Clear selected area 
  413.  
  414.  HELP KEYS 
  415.  
  416.  F1 
  417.       Get help 
  418.  
  419.  F2 
  420.       Get extended help (from within any help window) 
  421.  
  422.  Alt+F4 
  423.       End help 
  424.  
  425.  F9 
  426.       Go to a list of keys (from within any help window) 
  427.  
  428.  F11 
  429.       Go to the help index (from within any help window) 
  430.  
  431.  Esc 
  432.       Previous Help Panel, or End help if only one panel 
  433.  
  434.  Alt+F6 
  435.       Go to/from help and programs 
  436.  
  437.  Shift+F10 
  438.       Get help for help 
  439.  
  440.  SYSTEM KEYS 
  441.  
  442.  Alt+F6 
  443.       Switch to the next windowed program 
  444.  
  445.  Alt+Esc 
  446.       Switch to the next program, including full-screen programs 
  447.  
  448.  Ctrl+Esc 
  449.       Switch to the Task List 
  450.  
  451.  WINDOW KEYS 
  452.  
  453.  F3 
  454.       Close a window 
  455.  
  456.  F10 
  457.       Go to/from the action bar 
  458.  
  459.  Arrow keys 
  460.       Move among choices 
  461.  
  462.  End 
  463.       Go to the last choice in a pull-down 
  464.  
  465.  Esc 
  466.       Cancel a pull-down or the system menu 
  467.  
  468.  Home 
  469.       Go to the first choice in a pull-down 
  470.  
  471.  PgUp 
  472.       Scroll the contents of the window up one page 
  473.  
  474.  PgDn 
  475.       Scroll the contents of the window down one page 
  476.  
  477.  Underlined letter 
  478.       Move among the choices on the action bar and pull-downs 
  479.  
  480.  Alt+F10 
  481.       Go to/from the action bar 
  482.  
  483.  Alt+F4 or F3 
  484.       Close the window 
  485.  
  486.  Alt+F5 
  487.       Restore the window 
  488.  
  489.  Alt+F7 
  490.       Move the window 
  491.  
  492.  Alt+F8 
  493.       Size the window 
  494.  
  495.  Alt+F9 
  496.       Minimize the window 
  497.  
  498.  Alt+F10 
  499.       Maximize the window 
  500.  
  501.  Ctrl+PgDn or Shift+F8 
  502.       Scroll the contents of the window right one page 
  503.  
  504.  Ctrl+PgUp or Shift+F7 
  505.       Scroll the contents of the window left one page 
  506.  
  507.  Shift+Esc or Alt+Spacebar 
  508.       Go to/from the system menu 
  509.  
  510.  Shift+Esc or Alt 
  511.       Go to/from the system menu of a text window 
  512.  
  513.  
  514. ΓòÉΓòÉΓòÉ 4. File Load Dialog (PMDRWFIL.DLL) ΓòÉΓòÉΓòÉ
  515.  
  516. The dialog which is used by the PM Draw program to retrieve a file name can 
  517. also be used by other applications, if the proper functions are called at the 
  518. proper time. 
  519.  
  520. There are three functions which must be used by your program: 
  521.  
  522.  
  523. PSZ APIENTRY InitFileOpenDlg(          /* initialization routine     */
  524.                      PHAB   phab,      /* ptr to anchor block handle */
  525.                      PHWND  phwnd,     /* ptr to main window handle  */
  526.                      PSZ    szTitle,   /* dialog window title        */
  527.                      PSZ    szMask );  /* search string mask         */
  528.  
  529. MRESULT EXPENTRY FileOpenDlg(          /* dialog window procedure    */
  530.                      HWND    hwndDlg,  /* dialog window handle       */
  531.                      USHORT  msg,      /* dialog window message      */
  532.                      MPARAM  mp1,      /* message parameter 1        */
  533.                      MPARAM  mp2 );    /* message parameter 2        */
  534.  
  535. VOID APIENTRY TermFileOpenDlg(VOID);   /* termination routine        */
  536.  
  537. InitFileOpenDlg 
  538.  
  539. The InitFileOpenDlg function should be called during your program's WM_CREATE 
  540. processing, to ensure that it will only be called once for each invocation of 
  541. your program. The returned pointer gives you acces to a string buffer in the 
  542. dialog window dynamic link library's data segment, which will contain the fully 
  543. qualified file name which was selected through the dialog. This is how it is 
  544. called in the main window routine for PM Draw: 
  545.  
  546. case WM_CREATE:
  547.     ::
  548.     ::
  549.     szFileOpenString = InitFileOpenDlg(&hab, &hwnd, "File", "*.bmp");
  550.     ::
  551.     ::
  552.  
  553. FileOpenDlg 
  554.  
  555. The FileOpenDlg function is used when the file open dialog window is invoked. 
  556. Since the dialog window is entirely self-contained, the handle to the 
  557. PMDRWFIL.DLL dynamic link library must be given at invocation time, as in the 
  558. following: 
  559.  
  560. case WM_CREATE:
  561.     ::
  562.     ::
  563.     DosLoadModule((PSZ)0, 0, "PMDRWFIL", &hmodFileOpen);
  564.     ::
  565.     ::
  566. case WM_COMMAND:
  567.     ::
  568.     ::
  569.     if (WinDlgBox(HWND_DESKTOP, hwndFrame, FileOpenDlg,
  570.                   hmodFileOpen, 1000, (PVOID)0) != DID_CANCEL )
  571.        load_file(szFileOpenString);
  572.     ::
  573.     ::
  574.  
  575. TermFileOpenDlg 
  576.  
  577. The TermFileOpenDlg function should be called during your program's WM_DESTROY 
  578. processing, to ensure that it will only be called once for each invocation of 
  579. your program. It releases storage which was allocated during the initialization 
  580. routine processing.