Difference between revisions of "Imageset files"

Revision as of 01:56, 27 March 2006

For the time being, this has been copy-and-pasted directly from "readme.txt" in the XMLRefSchema directory of the CEGUI source code. Some prettier formatting along the lines of this page would be nice.

Imagesets define one or more images on a larger image (texture).
The root element must be Imageset.


Imageset Element
================
Has attributes and a collection of one or more Image elements.

Imageset attributes
-------------------
Imagefile	- path to the image file containing the graphics (required).
ResourceGroup	- The resource group identifier to pass to the resource provider when loading the file.
Name		- the name that will be assigned to the Imageset in the GUI system (required).
NativeHorzRes	- The horizontal screen resolution that the images were are intended to be displayed at (optional, default=640).
NativeVertRes	- The vertical screen resolution that the images were are intended to be displayed at (optional, default=480).
AutoScaled	- Boolean, states whether to scale imagery so it appears the same size as any resolution (optional, default=false).


Image Element
=============
Has attributes defining an sub-image area.  Can have no sub-elements.

Image attributes
----------------
Name		- The name that will be used to identify the image within the Imageset.  (required).
XPos		- X pixel co-ordinate of the top-left corner of the image on the texture. (required).
YPos		- Y pixel co-ordinate of the top-left corner of the image on the texture. (required).
Width		- Width of this image in pixels. (required).
Height		- Height of this image in pixels. (required).
XOffset		- Horizontal offset to apply when rendering.  (optional, default=0)
YOffset		- Vertical offset to apply when rendering.  (optional, default=0)