7.6

Table Of Contents

If you want to create a reference to a text document (for example a sample data file), replace "external" by "cleartext.”

Argument

resname

String value specifying the alias to use to refer to this resource file.

path

String value specifying the path of the resource file.

Code Sample Example

This example creates the alias 'photo' that refers to the resource file c:\images\employees\JAdler.bmp.

Example

instream external photo

c:\images\employees\JAdler.bmp

endinstream()

%You can then reference the resource using the alias

showbitmap('photo',72,1,1)

ShowBitmap (procedure)

Displays a bitmap resource.

Syntax

showbitmap( resname, resolution, width, height[, transparent[, duotone]] )

Arguments

resname

String value containing either the name of the bitmap resource within the document, or the path to a bitmap file.

resolution

Integer value specifying the resolution, in pixels per inch, at which the bitmap displays. A larger number yields a smaller,

clearer image, since more pixels are squeezed into a smaller space. But the bitmap then requires more memory. Except in

some very specific applications, it is rarely desirable to use resolutions exceeding 100 ppi.

width, height

Measure values specifying the width/height, in inches, the bitmap occupies when it displays. Specifying a value of zero for one

but not both of the two dimensions scales the bitmap to fit the non-zero dimension. Specifying both a width and a height scales

the bitmap to the best fit possible with that width and height, while maintaining its aspect ratio. Specifying both a width and a

height of zero displays the bitmap at its default resolution.

transparent