XFA Specification
Chapter 15, Template Specification
Template Reference
549
The image element
A content element that describes a single image.
<image
Properties:
aspect="fit
|
none
|
actual
|
width
|
height"
contentType="cdata"
href="cdata"
id="xml-id"
name="xml-id"
transferEncoding="base64
|
none"
use="cdata"
usehref="cdata"
>
...pcdata...
</image>
The image element is used within the following other elements:
desc exObject extras items proto value variables
Content
This element may enclose image-data which is PCDATA representing the actual image data content of the
image, encoded in base64 encoding (see [RFC2045] for more information). If the image element also
specifies external image content via the
href property,
the external content shall take priority.
When no data content is provided, the data content may be interpreted as representing a null value. This
behavior is dependent upon the context of where the data content is used. For instance, a field may
interpret empty data content as null based upon the associated
nullType
property in the data
description.
The aspect property
This property specifies how the image is to map to the
nominal content region
of the image's container.
fit
The processing application must scale the image proportionally to the maximum possible size
such that it fits within the nominal content region of the container.
none
The image shall be scaled such that it occupies the entire nominal content region of the container.
This may result in different scale values being applied to the image's X and Y coordinates.
actual
The image shall be rendered using the dimensions stored in the image content. The extent of the
container's nominal content region plays no role in the sizing of the image.