WoW:XML/Texture: Difference between revisions

201 bytes added ,  20 September 2013
m
no edit summary
(Started work on making this page much more robust)
mNo edit summary
Line 1: Line 1:
A '''Texture''' is a [[XML/LayoutFrame|LayoutFrame]] XML element that describes a graphic. The graphic may be an image loaded by Blizzard or an addon, or it may be a solid color or gradient. Textures support partially transparent images and different strategies for blending these into other images. They may be changed to show only a portion of a loaded image using ''texture coordinates''.
{{uixmlelem}}


==Images==
A '''Texture''' is a [[XML/LayoutFrame|LayoutFrame]] XML element that describes a graphic or display in the UI. Textures, along with [[XML/FontString|FontStrings]] are layered UI elements, meaning they must be in a <Layers><Layer> tag.
Textures are the means to display images in the game. The image must be either a [http://en.wikipedia.org/wiki/Truevision_TGA TGA] or [http://en.wikipedia.org/wiki/.BLP BLP] image file. Textures may only load images whose dimensions are powers of two, such as 2x2, 4x8, and so on. Images that have non-power of two dimensions will show up as solid green textures. The image does not need to be square, however, so rectangular dimensions like 32x128 are also valid.
 
==Elements==
* <[[XML/TexCoords|TexCoords]]>
* <[[XML/Color elements|Color]]>
* <[[XML/Gradient|Gradient]]>


==Virtual Textures==
== Attributes ==
* file (string) - resource file path to the texture image
* alphaMode ([[XML/ALPHAMODE|ALPHAMODE]]) - Blending mode


Virtual textures are textures that are allowed to be used as a template for other textures. This is useful in situations where textures vary by a small amount. In this case, the similarity can be put in a virtual texture, and the children need to only describe their differences.
==Summary==


==Elements==
The graphic may be an image loaded by Blizzard or an addon, or it may be a solid color or gradient. Textures support partially transparent images and different strategies for blending these into other images. They may be changed to show only a portion of a loaded image using ''texture coordinates''. Note: The Texture must be within a ''[[XML_User_Interface#Layers_and_Textures|&lt;Layer&gt;]]''
<[[XML/TexCoords|TexCoords]]>, [[XML/Color elements|Color]], Gradient


==Attributes==
===Example===
;file
<Texture name="MyTexture" file="Interface\ItemSocketingFrame\UI-ItemSockets" alphaMode="ADD">
:{{attrtype|string}} File name
  <Size>
;[[UITYPE AlphaMode|alphaMode]]
    <AbsDimension x="13" y="13"/>
:{{attrtype|string}} Blending mode
  </Size>
  <Anchors>
    <Anchor point="CENTER">
      <Offset>
        <AbsDimension x="0" y="0"/>
      </Offset>
    </Anchor>
  </Anchors>
  <TexCoords left="0.398" right="0.445" top="0.402" bottom="0.449"/>
</Texture>


==Notes==
==Details==
Note: The Texture must be within a ''[[XML_User_Interface#Layers_and_Textures|<Layer>]]''


==Examples==
===Images===
Textures are the means to display images in the game. The image must be either a [http://en.wikipedia.org/wiki/Truevision_TGA TGA] or [http://en.wikipedia.org/wiki/.BLP BLP] image file. Textures may only load images whose dimensions are powers of two, such as 2x2, 4x8, and so on. Images that have non-power of two dimensions will show up as solid green textures. The image does not need to be square, however, so rectangular dimensions like 32x128 are also valid.


<pre>
===Virtual Textures===
<Texture name="SparkleTextureNormal" file="Interface\ItemSocketingFrame\UI-ItemSockets" alphaMode="ADD" hidden="true">
Virtual textures are textures that are allowed to be used as a template for other textures. This is useful in situations where textures vary by a small amount. In this case, the similarity can be put in a virtual texture, and the children need to only describe their differences.
<Size>
<AbsDimension x="13" y="13"/>
</Size>
<Anchors>
<Anchor point="CENTER">
<Offset>
<AbsDimension x="0" y="0"/>
</Offset>
</Anchor>
</Anchors>
<TexCoords left="0.3984375" right="0.4453125" top="0.40234375" bottom="0.44921875"/>
</Texture>
</pre>
[[Category:XML elements]]
[[Category:XML elements]]