:artwork. (Artwork)

Identifies a bit map to be placed into the user's file.

┌───────────────┬───────────────┬───────────────┬───────────────┐
│Tag            │Element        │Attributes     │End            │
├───────────────┼───────────────┼───────────────┼───────────────┤
│:artwork.      │Artwork        │name=' '       │               │
├───────────────┼───────────────┼───────────────┼───────────────┤
│               │               │align=         │               │
├───────────────┼───────────────┼───────────────┼───────────────┤
│               │               │linkfile=' '   │               │
├───────────────┼───────────────┼───────────────┼───────────────┤
│               │               │runin          │               │
├───────────────┼───────────────┼───────────────┼───────────────┤
│               │               │fit            │               │
└───────────────┴───────────────┴───────────────┴───────────────┘

Attributes

name='filename.ext'

Identifies the file containing the bit map (artwork). This attribute is required and must specify a complete file name.
align=left│right│center
Specifies how the artwork is to align with the current margins. It can be to the left, to the right, or centered.
linkfile='filename.ext'
Identifies the file with the link definitions. This file begins with :artlink. and ends with :eartlink.. The linkfile= attribute enables you to link from whole or segmented bit maps. It can be omitted if the artwork file does not require links, or if the links are enclosed by :artlink. and :eartlink. immediately following the artwork tag.
runin
Specifies that the artwork is to be placed within the line of text. You enter :artwork. and its attributes in the line of text where you want the artwork to appear.
fit
Causes the artwork to fill the window in which it is displayed. If the user resizes the window, IPF redisplays the graphic so that it fits the new window size.

When the initial size of the window is specified, the ratio between its width and height should be approximately the same as that of the graphic; otherwise, the artwork may appear distorted.

The fit attribute is most often used when artwork is to be displayed in a split window, where one window contains a bit map, and another contains text that is displayed beside the graphic.

If the artwork tag has fit, and you include text in the same window, the text will be displayed briefly, but will then be covered by the painting of the bit map in the window.

Description

Use :artwork. to include bit maps such as vectors and scanned images, in the text file. The artwork tag and its attributes enable you to merge whole or segmented bit maps and position them in the window. A bit map can be created by an application or by a bit-map editing tool, such as the Presentation Manager Icon Editor. A metafile can be created using a GPI function.

Conditions

• If a path name is not specified for either name= or linkfile=, IPF looks for the file in the current directory.

• If linkfile= is not specified, IPF looks for the artlink tag on the line immediately following the artwork tag.

• The artwork tag requires the name= attribute.

Example 1

This example shows how to include artwork that does not require a hypergraphic link. The artwork is to be placed within the line of text that contains the artwork tag.

Click on the :artwork name='gopi.art' runin. symbol to close the file.

Example 2

This example shows how to include artwork that fills the window in which it is displayed.

:artwork name='c:\main\world.bmp' fit.

---

[Back: :artlink. (Art Link)]
[Next: :caution. (Caution)]