home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: Product
/
Product.zip
/
PMDRAW.ZIP
/
PMDRAW.HLP
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1990-02-27
|
13KB
|
580 lines
ΓòÉΓòÉΓòÉ 1. Extended Help for PM Draw ΓòÉΓòÉΓòÉ
The PM Draw program is a graphics program that allows you to create and edit
OS/2 Presentation Manager bitmaps. There are two primary modes of operation:
graphics mode and text mode.
Graphics Mode
The graphics mode of operation is in effect whenever the Text Mode option in
the Options menu is not selected. In this mode, you can create graphics images
using both the keyboard and mouse interfaces.
PM Draw provides two types of graphics items: curves and solid figures. Curves
are single-line graphics such as straight lines, circular arcs, parabolic
curves, Bezier splines, and fillets. Solid figures consist of such items as
pentagons, hexagons, circles, ellipses, hearts, and stars. There are also three
graphics items which can behave as either curves or solid figures: rectangles,
diamonds and triangles. The behavior of these items is determined by the Fill
Solid Figures option in the Options menu.
Whenever an item is created while in the graphics mode, it is automatically
saved in a memory bitmap, which maintains an image of the screen workspace. If
item chain construction is enabled, the item is also saved in the item chain.
Note: Any text characters entered while in the graphics mode are ignored.
Text Mode
The text mode of operation is in effect whenever the Text Mode option in the
Options menu is selected. In this mode, you can create both graphics and
character images, using the mouse interface for graphics items and the keyboard
interface for character items.
While in text mode, you can set the current font in two ways: use one of the
currently loaded fonts (Available Fonts in the Options menu), or create a new
font based on one of the currently loaded fonts (Create Font in the Options
menu). The second method allows you to add such features as italics,
underscore, and strike-out to your font.
ΓòÉΓòÉΓòÉ 2. Menus ΓòÉΓòÉΓòÉ
Provides help for the individual menus and submenus available for the PM Draw
program.
ΓòÉΓòÉΓòÉ 2.1. Help for 'File' Menu ΓòÉΓòÉΓòÉ
Use these choices to perform operations which affect the current bitmap file in
memory.
New
Erase the current bitmap from memory and start a new one.
Open
Load a bitmap from a file.
Save
Save the current bitmap to a file, using the current file name.
Save As
Save the current bitmap to a file, using a new file name.
Bitcount 1
Set bits-per-pel count to 1 (Monochrome bitmaps).
Bitcount 4
Set bits-per-pel count to 4 (16-color bitmaps).
Bitcount 8
Set bits-per-pel count to 8 (256-color bitmaps).
Bitcount 24
Set bits-per-pel count to 24 (Full-color bitmaps).
About
Display release information for PM Draw.
ΓòÉΓòÉΓòÉ 2.1.1. Help for 'New' ΓòÉΓòÉΓòÉ
Use this choice to create a new bitmap, specifying a name for the bitmap file.
This brings up a simple dialog box containing a prompt string ("File Name:"),
an entry field, and two pushbuttons ("Enter" and "Cancel"). If "Enter" is
selected, the screen is cleared and a new bitmap is created. "Cancel" restores
the bitmap to its previous state.
ΓòÉΓòÉΓòÉ 2.1.2. Help for 'Open' ΓòÉΓòÉΓòÉ
Use this choice to load a bitmap file into the work space.
This brings up a dialog box containing an entry field for the file search
template, a list box for all files in the current or selected directory which
match the search template, a list box for all drives and directories available
from the current or selected directory, and two pushbuttons ("Enter" and
"Cancel").
The file search template is initialized to find all bitmap files with the
default file extension ("*.bmp").
Note: Any changes made to the search template or directory selection will be
saved between calls to this dialog.
ΓòÉΓòÉΓòÉ 2.1.3. Help for 'Save' ΓòÉΓòÉΓòÉ
Use this choice to save the bitmap in the work space to a file, using the
current file name.
If there is no file name associated with the current bitmap, then a dialog
appears prompting for one.
ΓòÉΓòÉΓòÉ 2.1.4. Help for 'Save As' ΓòÉΓòÉΓòÉ
Use this choice to save the bitmap in the work space to a file, using a new
file name.
If there is a file name associated with the current bitmap, the dialog appears
with the current file name in the name entry field.
ΓòÉΓòÉΓòÉ 2.1.5. Help for 'Bitcount 1' ΓòÉΓòÉΓòÉ
Use this choice to set the current bitmap to a monochrome format, consisting of
1 bit per pel and 1 color plane. In this format, the bitmap color data consists
of 2 values, which map to the RGB color information for each pel.
ΓòÉΓòÉΓòÉ 2.1.6. Help for 'Bitcount 4' ΓòÉΓòÉΓòÉ
Use this choice to set the current bitmap to a 16-color format, consisting of 4
bits per pel and 1 color plane. In this format, the bitmap color data consists
of 16 values, which map to the RGB color information for each pel.
ΓòÉΓòÉΓòÉ 2.1.7. Help for 'Bitcount 8' ΓòÉΓòÉΓòÉ
Use this choice to set the current bitmap to a 256-color format, consisting of
8 bits per pel and 1 color plane. In this format, the bitmap color data
consists of 256 values, which map to the RGB color information for each pel.
ΓòÉΓòÉΓòÉ 2.1.8. Help for 'Bitcount 24' ΓòÉΓòÉΓòÉ
Use this choice to set the current bitmap to a full color format, consisting of
24 bits per pel and 1 color plane. In this format, the bitmap color data
contains no values, since the full RGB color information is contained in the
bits for each pel.
ΓòÉΓòÉΓòÉ 2.1.9. Help for 'About' ΓòÉΓòÉΓòÉ
Use this choice to see information relating to the current release of the PM
Draw program.
Selecting this option displays a small message box containing the name of the
program, the version level, and the copyright notice for the program.
ΓòÉΓòÉΓòÉ 2.2. Help for 'Edit' Menu ΓòÉΓòÉΓòÉ
Use this choice for information of the 'Edit' menu.
ΓòÉΓòÉΓòÉ 2.3. Help for 'Options' Menu ΓòÉΓòÉΓòÉ
Use this choice for information of the 'Options' menu.
ΓòÉΓòÉΓòÉ 2.4. Help for 'Graphics' Menu ΓòÉΓòÉΓòÉ
Use these choices to set the current graphics drawing mode for the PM Draw
program.
Curves
Provides a list of single-line graphics drawing modes, including lines
and curves.
Figures
Provides a list of solid graphics drawing items, including circles,
stars, pentagons, hexagons, and hearts.
Special
Provides a list of special graphics drawing modes, whose behavior depends
on the state of the Fill Solid Figures flag in the Options menu.
ΓòÉΓòÉΓòÉ 2.4.1. Help for 'Curves' Submenu ΓòÉΓòÉΓòÉ
Use this choice for information of the 'Curves' menu.
ΓòÉΓòÉΓòÉ 2.4.2. Help for 'Figures' Submenu ΓòÉΓòÉΓòÉ
Use this choice for information of the 'Figures' menu.
ΓòÉΓòÉΓòÉ 2.4.3. Help for 'Special' Submenu ΓòÉΓòÉΓòÉ
Use this choice for information of the 'Special' menu.
ΓòÉΓòÉΓòÉ 2.5. Help for 'Colors' Menu ΓòÉΓòÉΓòÉ
Use these choices to set the foreground and background color values for text
and graphics drawing.
Pre-defined
Provides a list of pre-defined color values for quick selection of the
foreground drawing color.
Gray-scale
Provides a list of monochrome color values, including black, white, and
two shades of gray.
RGB
Initiates a dialog which allows you to set the exact foreground color by
selecting indices for red, green and blue intensity.
Background
Provides a list of pre-defined color values for the background drawing
color. This value only has meaning when drawing text.
ΓòÉΓòÉΓòÉ 2.6. Help for 'Exit' Menu ΓòÉΓòÉΓòÉ
Use these choices to exit the program or return to the graphics creation
environment.
Exit PM Draw
Terminate the program.
Resume
Return to graphics creation (do nothing).
ΓòÉΓòÉΓòÉ 2.6.1. Help for 'Exit PM Draw' ΓòÉΓòÉΓòÉ
Use this choice to end a PM Draw graphics session. If the image has been
modified since the last file save, a confirmation box is presented before
program termination.
ΓòÉΓòÉΓòÉ 2.6.2. Help for 'Resume' ΓòÉΓòÉΓòÉ
Use this choice to return to the PM Draw program without any alterations to the
graphics creation environment. Selecting this option causes the program to
behave as if you did not do anything (it has no effect).
ΓòÉΓòÉΓòÉ 2.7. Help for 'Help' Menu ΓòÉΓòÉΓòÉ
Use these choices to find out how to use help, to get extended help, to go to a
list of keys, or to go to the help index.
Help for help
Provides detailed information on the kinds of help available and how to
use help.
Extended help
Displays general help.
Keys help
Displays a list of keys.
Help index
Displays the help index.
ΓòÉΓòÉΓòÉ 2.7.1. Help for 'Help for Help' ΓòÉΓòÉΓòÉ
Use this choice to obtain information on how to use the Help facility.
ΓòÉΓòÉΓòÉ 2.7.2. Help for 'Extended Help' ΓòÉΓòÉΓòÉ
Use this choice to obtain general information on the tasks you can perform
while you are viewing a help window.
ΓòÉΓòÉΓòÉ 2.7.3. Help for 'Keys Help' ΓòÉΓòÉΓòÉ
Use this choice to see a list of keys and a description of the function of the
keys.
ΓòÉΓòÉΓòÉ 2.7.4. Help for 'Help Index' ΓòÉΓòÉΓòÉ
Use this choice to display the help index.
The help index lists the titles of the help information that is available.
ΓòÉΓòÉΓòÉ 3. Keyboard Accelerators ΓòÉΓòÉΓòÉ
The list of keys is arranged in groups.
ACCELERATOR KEYS
Ctrl+b
Start/Stop building item chain
Ctrl+f
Toggle solid figure fill
Ctrl+k
Toggle click position marking
Ctrl+x
Toggle graphics/text mode
Shift+F2
Restore bitmap from memory
Alt+a
Set circular arc drawing mode
Alt+c
Set solid circle drawing mode
Alt+d
Set diamond drawing mode
Alt+e
Erase entire bitmap
Alt+f
Draw a fillet curve
Alt+h
Set solid heart drawing mode
Alt+i
Set solid ellipse drawing mode
Alt+l
Set straight line drawing mode
Alt+n
Draw a Bezier spline curve
Alt+p
Set solid pentagon drawing mode
Alt+r
Set rectangle drawing mode
Alt+t
Set triangle drawing mode
Alt+v
Set parabolic curve drawing mode
Alt+x
Set solid hexagon drawing mode
Alt+1
Erase Quadrant I (upper-right corner of bitmap)
Alt+2
Erase Quadrant II (upper-left corner of bitmap)
Alt+3
Erase Quadrant III (lower-left corner of bitmap)
Alt+4
Erase Quadrant IV (lower-right corner of bitmap)
Alt+5
Set solid 5-pointed star drawing mode
Alt+6
Set solid 6-pointed star drawing mode
Alt+7
Set solid 7-pointed star drawing mode
Alt+8
Set solid 8-pointed star drawing mode
Alt+9
Set solid 9-pointed star drawing mode
Alt+F2
Draw the item chain in the bitmap
Alt+F3
Save the current bitmap to a file
F3
Exit program
F12
Select foreground color
CLIPBOARD KEYS
Ctrl+Ins
Copy selected area to clipboard
Shift+Ins
Paste bitmap image from clipboard
Shift+Del
Cut selected area to clipboard
Del
Clear selected area
HELP KEYS
F1
Get help
F2
Get extended help (from within any help window)
Alt+F4
End help
F9
Go to a list of keys (from within any help window)
F11
Go to the help index (from within any help window)
Esc
Previous Help Panel, or End help if only one panel
Alt+F6
Go to/from help and programs
Shift+F10
Get help for help
SYSTEM KEYS
Alt+F6
Switch to the next windowed program
Alt+Esc
Switch to the next program, including full-screen programs
Ctrl+Esc
Switch to the Task List
WINDOW KEYS
F3
Close a window
F10
Go to/from the action bar
Arrow keys
Move among choices
End
Go to the last choice in a pull-down
Esc
Cancel a pull-down or the system menu
Home
Go to the first choice in a pull-down
PgUp
Scroll the contents of the window up one page
PgDn
Scroll the contents of the window down one page
Underlined letter
Move among the choices on the action bar and pull-downs
Alt+F10
Go to/from the action bar
Alt+F4 or F3
Close the window
Alt+F5
Restore the window
Alt+F7
Move the window
Alt+F8
Size the window
Alt+F9
Minimize the window
Alt+F10
Maximize the window
Ctrl+PgDn or Shift+F8
Scroll the contents of the window right one page
Ctrl+PgUp or Shift+F7
Scroll the contents of the window left one page
Shift+Esc or Alt+Spacebar
Go to/from the system menu
Shift+Esc or Alt
Go to/from the system menu of a text window
ΓòÉΓòÉΓòÉ 4. File Load Dialog (PMDRWFIL.DLL) ΓòÉΓòÉΓòÉ
The dialog which is used by the PM Draw program to retrieve a file name can
also be used by other applications, if the proper functions are called at the
proper time.
There are three functions which must be used by your program:
PSZ APIENTRY InitFileOpenDlg( /* initialization routine */
PHAB phab, /* ptr to anchor block handle */
PHWND phwnd, /* ptr to main window handle */
PSZ szTitle, /* dialog window title */
PSZ szMask ); /* search string mask */
MRESULT EXPENTRY FileOpenDlg( /* dialog window procedure */
HWND hwndDlg, /* dialog window handle */
USHORT msg, /* dialog window message */
MPARAM mp1, /* message parameter 1 */
MPARAM mp2 ); /* message parameter 2 */
VOID APIENTRY TermFileOpenDlg(VOID); /* termination routine */
InitFileOpenDlg
The InitFileOpenDlg function should be called during your program's WM_CREATE
processing, to ensure that it will only be called once for each invocation of
your program. The returned pointer gives you acces to a string buffer in the
dialog window dynamic link library's data segment, which will contain the fully
qualified file name which was selected through the dialog. This is how it is
called in the main window routine for PM Draw:
case WM_CREATE:
::
::
szFileOpenString = InitFileOpenDlg(&hab, &hwnd, "File", "*.bmp");
::
::
FileOpenDlg
The FileOpenDlg function is used when the file open dialog window is invoked.
Since the dialog window is entirely self-contained, the handle to the
PMDRWFIL.DLL dynamic link library must be given at invocation time, as in the
following:
case WM_CREATE:
::
::
DosLoadModule((PSZ)0, 0, "PMDRWFIL", &hmodFileOpen);
::
::
case WM_COMMAND:
::
::
if (WinDlgBox(HWND_DESKTOP, hwndFrame, FileOpenDlg,
hmodFileOpen, 1000, (PVOID)0) != DID_CANCEL )
load_file(szFileOpenString);
::
::
TermFileOpenDlg
The TermFileOpenDlg function should be called during your program's WM_DESTROY
processing, to ensure that it will only be called once for each invocation of
your program. It releases storage which was allocated during the initialization
routine processing.