Vbfox61323@legacy41580267 (talk | contribs) m (Formatting) |
(Removed stub warning for aethestics, feel free to re-add if this article doesn't grow) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | {{Stub/API}} |
||
{{widgetmethod}} |
{{widgetmethod}} |
||
| + | '''CreateTexture''' is a method on [[UIObject_Frame|Frame]] objects that creates and returns a new [[UIObject_Texture|Texture]]. CreateTexture allows Lua to create textures that would otherwise only be available to XML. This method also lets developers the option to reuse virtual textures declared in XML. |
||
| − | Creates a new texture for the frame. |
||
Frame:CreateTexture(["textureName"[, "layer"]][, "inheritsFrom"]) |
Frame:CreateTexture(["textureName"[, "layer"]][, "inheritsFrom"]) |
||
== Parameters == |
== Parameters == |
||
| − | === Arguments === |
||
:;textureName : String - Name of the newly created texture. If nil, no name is assigned. The function will also set a global variable of this name to point to newly created texture. |
:;textureName : String - Name of the newly created texture. If nil, no name is assigned. The function will also set a global variable of this name to point to newly created texture. |
||
| Line 19: | Line 17: | ||
FRAME.texture:[[API Frame SetAllPoints|SetAllPoints]](FRAME) |
FRAME.texture:[[API Frame SetAllPoints|SetAllPoints]](FRAME) |
||
FRAME.texture:[[API Texture SetTexture|SetTexture]](r,g,b[,a]) |
FRAME.texture:[[API Texture SetTexture|SetTexture]](r,g,b[,a]) |
||
| + | |||
| + | The game will not find image files that did not exist when it was started, so you may need to restart the game for the texture to appear. |
||
Revision as of 14:56, 27 April 2010
 |
The API is no longer being updated here until further notice. |
CreateTexture is a method on Frame objects that creates and returns a new Texture. CreateTexture allows Lua to create textures that would otherwise only be available to XML. This method also lets developers the option to reuse virtual textures declared in XML.
Frame:CreateTexture(["textureName"[, "layer"]][, "inheritsFrom"])
Parameters
- textureName
- String - Name of the newly created texture. If nil, no name is assigned. The function will also set a global variable of this name to point to newly created texture.
- layer
- String - The layer to use.
- inheritsFrom
- String - a comma-delimited list of names of virtual frames to inherit from (the same as in XML). If nil, no frames will be inherited. These frames cannot be frames that were created using this function, they must be created using XML with virtual="true" in the tag.
Usage
Generally, either use the SetBackdrop function or use code similar to the following to set a solid color background:
FRAME.texture = FRAME:CreateTexture() FRAME.texture:SetAllPoints(FRAME) FRAME.texture:SetTexture(r,g,b[,a])
The game will not find image files that did not exist when it was started, so you may need to restart the game for the texture to appear.