CircleImage

The CircleImage provides a circular shaped display for a texture.

Summary
CircleImageThe CircleImage provides a circular shaped display for a texture.
XML DefinitionThis is the CircleImage xml definition.
XML Tag
Optional AttributesThese are optional.
textureName of the Ui Texture to display.
sliceName of the <Slice> in the Ui Texture to display.
numsegmentsThe number of segments used to create the circumference circle.
startangleThe position on the circle at which to start building the circumference.
fillangleThe number of degrees arround the circle to fill.
mirrorTexCoordsAllows you to display a horizontal mirror image of the texture.
texturescaleThe scale of the texture to be used for the image artwork.
filteringAllows you to specify the blend mode used for this texture when rendering.
Elements
TexCoordsThe texture coordinates for the CENTER of the CircleImage with the texture.
Functions
Functions
CircleImageSetTexture()Sets the texture displayed on this image.
CircleImageSetFillParams()Sets the fill parameters for the circle image.
CircleImageSetTextureScale()Sets the textureScale value.
Functions
Functions
CircleImageSetTextureSlice()Sets the texture slice displayed on this image.
CircleImageSetRotation()Rotates the image around it’s center.

XML Definition

This is the CircleImage xml definition.

Summary
XML Tag
Optional AttributesThese are optional.
textureName of the Ui Texture to display.
sliceName of the <Slice> in the Ui Texture to display.
numsegmentsThe number of segments used to create the circumference circle.
startangleThe position on the circle at which to start building the circumference.
fillangleThe number of degrees arround the circle to fill.
mirrorTexCoordsAllows you to display a horizontal mirror image of the texture.
texturescaleThe scale of the texture to be used for the image artwork.
filteringAllows you to specify the blend mode used for this texture when rendering.
Elements
TexCoordsThe texture coordinates for the CENTER of the CircleImage with the texture.

XML Tag

<CircleImage>
....
</CircleImage>

Optional Attributes

These are optional.  You can use whichever apply to the CircleImage you are creating.

texture

Name of the Ui Texture to display.

Expects

A string value, which is the name of a valid ui Texture.

Default Value

  • ””

slice

Name of the <Slice> in the Ui Texture to display.

Expects

A string value, which is the name of a valid <Slice> as defined in the Ui Texture.

Default Value

  • ””

numsegments

The number of segments used to create the circumference circle.  The higher the number of segments the more circular the geomerty will look.

Expects

A number value between 3 and n.

Default Value

  • 16

startangle

The position on the circle at which to start building the circumference.  0 is the top.

Expects

A number value, representing the degrees of the start angle between 0 and 360.

Default Value

  • 0

fillangle

The number of degrees arround the circle to fill.

Expects

A number value, representing the degrees of the fill angle between 0 and 360.

Default Value

  • 360

mirrorTexCoords

Allows you to display a horizontal mirror image of the texture.  This swaps the topleft and bottom left coordinates with those used for the topright and bottomright of the image.

Expects

A boolean value.

”true”Mirror the texture coords
”false”Use normal texture coordinates

Default Value

  • ”false”

texturescale

The scale of the texture to be used for the image artwork.  This is multiplied by the image’s <Size> to determine the texture dimensions.

Expects

A number value.  (1.0 = 100%)

Default Value

  • 1.0

filtering

Allows you to specify the blend mode used for this texture when rendering.

Expects

A boolean value.

”true”Use Bilinear Filter filtering.
”false”Use Nearest Neighbor filtering.

Default Value

  • ”true”

Elements

TexCoords

The texture coordinates for the CENTER of the CircleImage with the texture.

Syntax

<TexCoords x="100" y="200" />
xThe x pixel coordinate of the CENTER of the image.
yThe y pixel coordinate of the CENTER of the image.

Defaults

x0
y0

Functions

Summary
Functions
CircleImageSetTexture()Sets the texture displayed on this image.
CircleImageSetFillParams()Sets the fill parameters for the circle image.
CircleImageSetTextureScale()Sets the textureScale value.

Functions

CircleImageSetTexture()

Sets the texture displayed on this image.

Parameters

circleImageName(string) The name of the CircleImage.
texture(string) The name of the Ui Texture to display.
xX coordinate in the Texture
yY coordinate in the Texture

Returns

nilno return value

Related XML

Notes

  • none

Example

CircleImageSetTexture("SomeImageWindow", "some_ui_texture" )

CircleImageSetFillParams()

Sets the fill parameters for the circle image.

Parameters

circleImageName(string) The name of the CircleImage.
startAngle(number) The angle at which to begin the circle’s circumference.  (Degrees, 0-360 )
fillAngle(number) The angle to fill arround the circle.  (Degrees, 0-360 )

Returns

nilno return value

Related XML

Notes

  • You can use this call to create circle animations, and ciruclar status bars.

Example

CircleImageSetFillParams( "MoraleWindowMoralStatus", startAngle, fillAngle )

CircleImageSetTextureScale()

Sets the textureScale value.

Parameters

circleImageName(string) The name of the CircleImage.
textureScale(number) The scale value to use on the image’s texture.  (1.0 = 100%)

Returns

nilno return value

Related XML

Notes

  • none

Example

CircleImageSetTextureScale( "SomeCircleImage", 0.5 )

Functions

Summary
Functions
CircleImageSetTextureSlice()Sets the texture slice displayed on this image.
CircleImageSetRotation()Rotates the image around it’s center.

Functions

CircleImageSetTextureSlice()

Sets the texture slice displayed on this image.

Parameters

circleImageName(string) The name of the CircleImage.
sliceName(string) The name of the <Slice> to display in the CircleImage.

Returns

nilno return value, regardless of success or failure

Related XML

  • <Slice>

Notes

  • none

Example

CircleImageSetTextureSlice("SomeImageWindow", "some_ui_texture_slice" )

CircleImageSetRotation()

Rotates the image around it’s center.

Parameters

circleImageName(string) The name of the CircleImage.
rotation(number) The rotation angle (Degrees, 0-360).

Returns

nilno return value

Notes

  • none

Example

CircleImageSetRotation( "SomeCircleImage", 90 )
This element defines a single art texture component.
Name of the Ui Texture to display.
The position on the circle at which to start building the circumference.
The number of degrees arround the circle to fill.
The scale of the texture to be used for the image artwork.