EMBH is a Windows DLL designed to extend Windows Help by adding animated
bullets, right arrows and a modem. The DLL is completely self-contained and
all that needs to be done is reference the DLL with parameters from within
your Winhelp RTF file. To use EMBH, copy EMBH.DLL to a directory where the
Winhelp system can find it, such as the Windows directory or where you keep
your help projects.

   Included in this file is TEST.RTF, an example of how to include EMBH in
your own help files. The RTF directive "EW?" is the key to the whole thing.
"EW" is short for "Embedded Window" and the last letter, represented by the
"?" above, depends on the justification. Three available types are:

EWL - Left Justified
EWC - Center Justified
EWR - Right Justified

The directive is added to the RTF file directly. An example, using Winword:

{EWL DLL,CLASS,PARAMS}

Three parameters are suppied to EMBH, as seen above. They are:

DLL:    Name of the DLL file. In this case, "EMBH.DLL"
CLASS:  Window class to use. EMBH supports "BULLET", "ARROW" and "MODEM"
PARAMS: Parameters to pass to the window created. More on this below.

Parameters are optional and, with the Modem, not required. The Bullet and
Arrow windows, however, require the color to use and a cycle direction. Thus,
parameters must be passed to these windows. The parameters consist of:

DRGB

D: Direction.  "F" cycles forward, "B" cycles backward, "A" prevents cycling.
R: Red inclusion. 1 if Red is to be included, 0 if not.
G: Green inclusion. 1 if Green is to be included, 0 if not.
B: Blue inclusion. 1 if Blue is to be included, 0 if not.

Since the colors are cycled, you cannot set an absolute RGB value. Instead,
you simply specify whether the color is to be included. If a window is not
cycled, the full luminence is used for included colors.

   Putting all this together, you can add windows such as:

{EWL EMBH.DLL,BULLET,F111}   - Forward cycling white bullet.
{EWL EMBH.DLL,BULLET,B100}   - Backward cycling red bullet.
{EWL EMBH.DLL,ARROW,A000}    - Non-cycling black arrow.
{EWL EMBH.DLL,ARROW,F001}    - Forward cycling blue bullet.
{EWL EMBH.DLL,MODEM,0}       - Modem

Easy, huh? Take a look at the example if still stumped.


*****  NOTES AND GOTCHAS....

   Each embedded window set to cycle and the modem require a system timer to
keep the cycle active. Since there are a limited number of system timers
available (16 I think), you should try to keep the number of animated windows
per page to a minimum. Generally, 4 to 6 is a fairly safe number. If a window
is started and no more timers are left, the window will display but will not
cycle and no error is given.


   EMBH is not Public Domain, but may be freely distributed and used in your
own projects at no charge. In using EMBH, the user assumes responsibility for
proper use of the file and shall hold harmless the software and author from
any damages incurred, whether real or imaginary.