256-Color Bitmaps (DIB Format)

Embedded bitmap windows display a bitmap (up to 256 colors) in a window embedded within a topic.

In the Title

The embedded bitmap window appears as shown in the following illustration:

In the Topic File

Embedded-window references are placed using the ewc (embedded window character), ewl (embedded window left), and ewr (embedded window right) references. These references have the following forms:

{ewc mvbmp, ViewerBmp, bitmapfile}
{ewl mvbmp, ViewerBmp, bitmapfile}
{ewr mvbmp, ViewerBmp, bitmapfile}

In each reference, bitmapfile is the name of the file being positioned in the topic. The following is how one of these references might appear in the topic file:

{ewr MVBMP, ViewerBmp, dibs_land.bmp}

RTF Format

\{ew[c, l, r] MVBMP, ViewerBmp, [[commands]][!]bitmapfile\}

Parameters

The RTF, including the embedded window reference (ewc, ewl, or ewr), appears exactly as shown except for the bitmap filename.

commands

One or more commands controlling how the bitmap is displayed. All commands must be enclosed in brackets ([]). See “Bitmap Commands,” later in this chapter, for a list of commands and their effects.

bitmapfile

Name of the file containing the bitmap (up to 256 colors).

If this filename does not have an exclamation point (!) prefix, the filename should include the path from the project directory to the bitmap.

If this filename has an exclamation point (!) prefix, the bitmap data is located within the .MVB file for the Viewer title, and the [BAGGAGE] section of the project file must list a reference to this file. (See the description of the [BAGGAGE] section in Chapter 17, “Project File Format,” for more information.)

Example

The following example positions an embedded window containing the bitmap WA_FLOWR.DIB in a topic, aligning the window along the left margin:

\{ewl MVBMP, ViewerBmp, dibs\wa_flowr.dib\