File group

The inclusion of an image is triggered by ticking the Assign filename from attribute box. If this is not done (the default) then no image is requested. Note that the name of the image file must be included, with any extension, as an attribute of the calling tag. If this is not the case (e.g. filename included as content, extension not supplied), you must call the image via a custom marker that has an attribute of the required form.

The attribute value can be either an absolute path, or a path relative to the search directory (described below). TopLeaf first attempts to interpret the path using the syntax of the host operating system. If the graphic file cannot be located, the path is interpreted using URI syntax, where special characters may be escaped using the %NN sequence. This means that the following two elements give the same results on a Windows system:

<graphic file="draft graphics\logo.png"/>
<graphic file="draft%20graphics/logo.png"/>

The format of the graphics is determined by the extension of the file name (the characters after the ‘.’). See below for a list of the extensions that are recognized, and the corresponding graphic format. Both upper and lower case extensions are recognized.

If you need to search for the image in a particular folder, enter its absolute path in the Look in: field or press the Browse... button to select one. If this field is not specified the value set by the closest ancestor mapping is used.