m
Move page script moved page XML/BackdropTemplate to WoW:XML/BackdropTemplate without leaving a redirect
m (Move page script moved page XML/BackdropTemplate to WoW:XML/BackdropTemplate without leaving a redirect) |
|||
| (6 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{uixmltemp}} | {{uixmltemp}} | ||
[[XML/BackdropTemplate|BackdropTemplate]] is a [[XML templates|template]] that helps create a Frame backdrop in the WoW UI. | [[XML/BackdropTemplate|BackdropTemplate]] is a [[XML templates|template]] that helps create a Frame backdrop in the WoW UI. See also the old style [[XML/Backdrop]] element. | ||
== Inheritance == | == Inheritance == | ||
| Line 37: | Line 37: | ||
<KeyValue key="backdropInfo" value="BACKDROP_DIALOG_32_32" type="global" /> | <KeyValue key="backdropInfo" value="BACKDROP_DIALOG_32_32" type="global" /> | ||
</pre> | </pre> | ||
* backdropColor (global, color table name) - global RGB color constant. default | * backdropColor (global, color table name) - global RGB color constant. default 1, 1, 1. Used to set backdrop background vertex color values, set on load by BackdropTemplate SetBackdropColor(r, g, b, a) which uses SetVertexColor(r, g, b, a or 1) on the background texture, if any. If no background texture is defined, then has no effect. | ||
* backdropColorAlpha (number) - 0 to 1. default 1. used to override alpha for the backdrop background texture, set on load by BackdropTemplate SetBackdropColor(r, g, b, a) which uses SetVertexColor(r, g, b, a or 1) on the background texture, if any. If no background texture is defined, then has no effect. | * backdropColorAlpha (number) - 0 to 1. default 1. used to override alpha for the backdrop background texture, set on load by BackdropTemplate SetBackdropColor(r, g, b, a) which uses SetVertexColor(r, g, b, a or 1) on the background texture, if any. If no background texture is defined, then has no effect. | ||
<pre> | <pre> | ||
| Line 43: | Line 43: | ||
<KeyValue key="backdropColorAlpha" value="0.9" type="number"/> | <KeyValue key="backdropColorAlpha" value="0.9" type="number"/> | ||
</pre> | </pre> | ||
* backdropBorderColor (global, color table name) - global RGB color constant. default | * backdropBorderColor (global, color table name) - global RGB color constant. default 1, 1, 1. Used to set backdrop border vertex color values, set on load by BackdropTemplate SetBackdropBorderColor(r, g, b, a) which uses SetVertexColor(r, g, b, a or 1) on the edge textures, if any. If no edge texture is defined, then has no effect. | ||
* backdropBorderColorAlpha (number) - 0 to 1. default 1. used to override alpha for the backdrop border texture, set on load by BackdropTemplate SetBackdropBorderColor(r, g, b, a) which uses SetVertexColor(r, g, b, a or 1) on the edge textures, if any. If no edge texture is defined, then has no effect. | * backdropBorderColorAlpha (number) - 0 to 1. default 1. used to override alpha for the backdrop border texture, set on load by BackdropTemplate SetBackdropBorderColor(r, g, b, a) which uses SetVertexColor(r, g, b, a or 1) on the edge textures, if any. If no edge texture is defined, then has no effect. | ||
<pre> | <pre> | ||
| Line 76: | Line 76: | ||
User defined 'backdropInfo' requirements: | User defined 'backdropInfo' requirements: | ||
* The backdropInfo table requires one, or both, of 'edgeFile' or 'bgFile', or will be ignored, and the backdrop will not be created. | * The backdropInfo table requires one, or both, of 'edgeFile' or 'bgFile', or will be ignored, and the backdrop will not be created. | ||
<pre> | |||
BACKDROP_DIALOG_32_32 = { | |||
bgFile = "Interface\\DialogFrame\\UI-DialogBox-Background", | |||
edgeFile = "Interface\\DialogFrame\\UI-DialogBox-Border", | |||
tile = true, | |||
tileEdge = true, | |||
tileSize = 32, | |||
edgeSize = 32, | |||
insets = { left = 11, right = 12, top = 12, bottom = 11 }, | |||
}; | |||
</pre> | |||
* If using a user created backdropInfo table, it must be created before the Frame loads, so must be created in Lua in a lua file that loads first, before the file XML is loaded. | * If using a user created backdropInfo table, it must be created before the Frame loads, so must be created in Lua in a lua file that loads first, before the file XML is loaded. | ||
User defined color table requirements: | User defined color table requirements: | ||
* A 'color table', or color constant, must be created with CreateColor(r, g, b, a) which creates a ColorMixin instance. BackdropTemplate will try to call GetRGB on the table and | * A 'color table', or color constant, must be created with CreateColor(r, g, b, a) which creates a ColorMixin instance. BackdropTemplate will try to call GetRGB on the table and expects an 'r, g, b =' return. | ||
<pre lang='lua'> | <pre lang='lua'> | ||
PURE_RED_COLOR = CreateColor(0.8, 0, 0); | PURE_RED_COLOR = CreateColor(0.8, 0, 0); | ||
| Line 87: | Line 98: | ||
== Notes == | == Notes == | ||
* The BackdropTemplate template directly replaced the older [[XML/Backdrop]] [[XML types|type]] in WoW Retail patch 9.0.1, but still worked in Classic and Era. | * The BackdropTemplate template directly replaced the older [[XML/Backdrop]] [[XML types|type]] in WoW Retail patch 9.0.1, but still worked in Classic and Era. With this patch the old-style [[XML/Backdrop]] element no longer worked in retail. | ||
* In Classic and Classic Era patch 2.5.3 and patch 1.14.0 respectively, BackdropTemplate template also replaced Backdrop element, when the version 9 engine was adopted. | * In Classic and Classic Era patch 2.5.3 and patch 1.14.0 respectively, BackdropTemplate template also replaced Backdrop element, when the version 9 engine was adopted. With this patch the old-style Backdrop element no longer worked in any version of WoW. | ||
== See also == | |||
* [[XML/Backdrop]] | |||