Aspect Ratio

The tag allows the aspect ratio of images (and multiimages) to be defined, and in addition, on how the image should be aligned within the standard, box.

XML tag format
The tag format is:

Allowed values
The values allowed for the aspect ratio are keep, stretch, scale, and center. These do the following: In addition to the default control tags, the following tags are available. Note that each tag is lower case only. This is important, as xml tags are case-sensitive.

Attributes
The align and aligny attributes specify how the image is positioned within the box. The default is to align to center in both directions.

Finally, the scalediffuse="false" attribute means the diffuse texture is not scaled to the image size. i.e. the diffuse image effectively uses aspectratio stretch in this case. This is especially useful when using the diffuse image to trim the main image in a particular way, such as to round off the corners. The default is scalediffuse="true".

Example
The image below shows the various combinations. The aspect ratios are from left to right: keep, scale, stretch, center. The top images use scalediffuse="true" and the lower images use scalediffuse="false".