Editing WoW:XML/BackdropTemplate (section)

== Configuration ==
=== KeyValue pairs ===
''on the Frame inheriting BackdropTemplate''
* backdropInfo (global, backdropInfo table name) - the main backdrop configuration table, using 'type' 'global' with a string 'value' that's the name of a global Lua 'backdropInfo' table. Can use one of the many WoW predefined 'backdropInfo' default tables, like BACKDROP_DIALOG_32_32.
<pre>
<KeyValue key="backdropInfo" value="BACKDROP_DIALOG_32_32" type="global" />
</pre>
* 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.
<pre>
<KeyValue key="backdropColor" value="BLACK_FONT_COLOR" type="global"/>
<KeyValue key="backdropColorAlpha" value="0.9" type="number"/>
</pre>
* 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.
<pre>
<KeyValue key="backdropBorderColor" value="ACHIEVEMENT_RED_BORDER_COLOR" type="global"/>
<KeyValue key="backdropBorderColorAlpha" value="0.5" type="number"/>
</pre>
* backdropBorderBlendMode (string) - overrides the blend/alpha mode for the 8 backdrop edge pieces, set on load by BackdropTemplate SetBorderBlendMode(blendMode) which uses SetBlendMode(blendMode) on each edge piece. See [[XML/ALPHAMODE]] for list of options.
<pre>
<KeyValue key="backdropInfo" value="BACKDROP_CALLOUT_GLOW_0_20" type="global"/>
<KeyValue key="backdropBorderBlendMode" value="ADD" type="string"/>
</pre>

=== 'backdropInfo' table options ===
''which must be defined outside of FrameXML in Lua''
* bgFile (string) - the resource path to the backdrop background texture
* edgeFile (string) - the resource path to the backdrop edge texture

* tile (boolean) - if background is tiled, true to tile
* tileEdge (boolean) - if the top, bottom, right, left edge texture components are tiled, true to tile

* tileSize (number) - default is 32. the size of section of the texture to use for the background when tiled, starting at x,y 0,0 to a width and height of 'tileSize'. the top rendered row will repeat the tiled portion of the texture, while the remainder of the background will only use the bottom row of pixels of the tile, to repeat as tiles to the bottom of the background area.
* edgeSize (number) - default is 32. width and height of texture source and drawn edge pieces

* insets (table) - the edge and background rendering offsets relative to the natural bounding box of the frame. like, 'insets = { left = 3, right = 5, top = 3, bottom = 5 },'
** left (number) - left edge inset amount toward the right
** right (number) - right edge inset amount toward the left
** top (number) - top edge inset amount toward the bottom
** left (number) - bottom edge inset amount toward the top

=== config details ===

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.
<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.

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 expects an 'r, g, b =' return.
<pre lang='lua'>
PURE_RED_COLOR				= CreateColor(0.8, 0, 0);
PAPER_FRAME_DARK_COLOR		= CreateColor(0.25, 0.1484375, 0.02)
</pre>
* The color constant must be created before the Frame loads, so must be created before the file XML is loaded in Lua, just like the 'backdropInfo' does.