WoW:XML/Layer - Revision history

Move page script: Move page script moved page XML/Layer to WoW:XML/Layer without leaving a redirect

2023-08-15T04:49:25Z

Move page script moved page XML/Layer to XML/Layer without leaving a redirect

← Older revision	Revision as of 04:49, 15 August 2023
(No difference)

Bear: /* Attributes */

2021-01-11T01:41:33Z

Attributes

← Older revision		Revision as of 01:41, 11 January 2021
Line 3:		Line 3:
	A [[XML/Layer\|Layer]] is a fundamental UI building block for defining visible UI elements of [[XML/Frame\|Frames]]. A Layer is an element of an [[XML/Layers\|Layers]] array defined in a [[XML/Frame\|Frame]]. Layer XML elements, as a part of [[XML/Layers\|Layers]] array, can be defined on any [[XML/Frame\|Frame]], which includes elements like [[XML/Button\|Buttons]] and [[XML/CheckButton\|CheckButtons]].		A [[XML/Layer\|Layer]] is a fundamental UI building block for defining visible UI elements of [[XML/Frame\|Frames]]. A Layer is an element of an [[XML/Layers\|Layers]] array defined in a [[XML/Frame\|Frame]]. Layer XML elements, as a part of [[XML/Layers\|Layers]] array, can be defined on any [[XML/Frame\|Frame]], which includes elements like [[XML/Button\|Buttons]] and [[XML/CheckButton\|CheckButtons]].

	==Inheritance==		== Inheritance ==
	Inherited by: none, Inherits: none, Defined in: [[XML/Frame\|Frame]] > [[XML/Layers\|Layers]]		Inherited by: none, Inherits: none, Defined in: [[XML/Frame\|Frame]] > [[XML/Layers\|Layers]]

	==Elements==		== Elements ==
	* [[XML/Texture\|Texture]] ... - 0 or more Textures to be rendered in the Layer		* [[XML/Texture\|Texture]] ... - 0 or more Textures to be rendered in the Layer
	* [[XML/FontString\|FontString]] ... - 0 or more FontStrings to be rendered in the Layer		* [[XML/FontString\|FontString]] ... - 0 or more FontStrings to be rendered in the Layer

	==Attributes==		== Attributes ==
	* level ([[XML/DRAWLAYER\|DRAWLAYER]]) - Layer level in 'Z order'. Default is 'ARTWORK'.		* level ([[XML/DRAWLAYER\|DRAWLAYER]]) - Layer level in 'Z order'. Default is 'ARTWORK'.
	* textureSubLevel (int) - ~~Additional~~ sub-~~leveling~~ of 'level'. Range of -8 .. 7. Default is '0'.		* textureSubLevel (int) - sub-level of 'level' for textures. Range of -8 .. 7. Default is '0'.

	== Summary ==		== Summary ==
Line 18:		Line 18:

	=== Example ===		=== Example ===
	~~<~~[[XML/Frame\|Frame]] name="MyFrame"~~>~~
	~~<~~Layers~~>~~		<[[XML/Frame\|Frame]] name="MyFrame">
	~~<~~Layer~~>~~		<Layers>
	~~<~~[[XML/Texture\|Texture]]~~>~~		<Layer>
	~~<~~Size x="100" y="100" /~~>~~		<[[XML/Texture\|Texture]]>
	~~<~~HitRectInsets~~>~~		<Size x="100" y="100" />
	~~<~~[[XML/AbsInset\|AbsInset]] left="0" right="-100" top="0" bottom="0"/~~>~~		<HitRectInsets>
	~~<~~/HitRectInsets~~>~~		<[[XML/AbsInset\|AbsInset]] left="0" right="-100" top="0" bottom="0"/>
	~~<~~Color a="1" r="1" g="1" b="1" /~~>~~		</HitRectInsets>
	~~<~~/Texture~~>~~		<Color a="1" r="1" g="1" b="1" />
	~~<~~Texture~~>~~		</Texture>
	~~<~~Size x="100" y="100" /~~>~~		<Texture>
	~~<~~Color a="1" r="1" g="1" b="1" /~~>~~		<Size x="100" y="100" />
	~~<~~/Texture~~>~~		<Color a="1" r="1" g="1" b="1" />
	~~<~~/Layer~~>~~		</Texture>
	~~<~~/Layers~~>~~		</Layer>
	~~<~~/Frame~~>~~		</Layers>
			</Frame>

	This example will show a frame with a single default layer, displaying two textures.		This example will show a frame with a single default layer, displaying two textures.

	== Details ==		== Details ==
			=== level ===
			There are 3 main levels of layer: BACKGROUND is in the back, ARTWORK is in the middle, and OVERLAY is in front. If you want to be sure that a object is before another, you must specify the level where you want to place it.

	~~There are 3 levels~~ of ~~layers: BACKGROUND is in~~ the ~~back,~~ ARTWORK ~~is in~~ the ~~middle~~ and ~~OVERLAY is~~ in ~~front~~. ~~If you want to be sure~~ that ~~a object is before another, you must specify the level where you want to place it~~.		* BACKGROUND - Level 0. Place the background of your frame here.
			* BORDER - Level 1. Place the border of your frame here.
			* ARTWORK - Level 2. Place the artwork of your frame here.
			* OVERLAY - Level 3. Place your text, objects, and buttons in this level.
			* HIGHLIGHT - Level 4. Special layer that only shows on mouseover.

	~~BACKGROUND - Level 0. Place~~ the ~~background of your frame here~~. ~~<br />~~		Elements in the 'HIGHLIGHT' Layer are automatically shown or hidden when the mouse enters or leaves. For Highlighting to work you need 'enableMouse="true"' in your <nowiki><Frame></nowiki> attributes.
	~~BORDER - Level 1. Place the artwork of~~ your ~~frame here .~~ <~~br /~~>
	~~ARTWORK - Level 2. Place the artwork of your frame here.~~ <~~br /~~>
	~~OVERLAY - Level 3. Place your text, objects, and buttons in this level.~~ <br />
	~~HIGHLIGHT - Level 4. Place your text, objects, and buttons in this level~~. ~~<br />~~

	*Elements in ~~the '''HIGHLIGHT''' Layer are '''automatically shown~~ or ~~hidden''' when~~ the ~~mouse enters or leaves.~~		Layer can be set on creation using the [[XML_properties#layers\|<nowiki><Layers></nowiki>]] tag in XML, or the "layer" parameter in [[API Frame CreateTexture\|Frame:CreateTexture]](). To change the layer after creation, use the [[API LayeredRegion SetDrawLayer\|LayeredRegion:SetDrawLayer]]() function.
	*For Highlighting to work you need '''enableMouse="~~true~~"~~'''~~ in ~~your ''<~~Frame~~>'' attributes~~.

	~~Layer can be set on creation using the [[XML_properties#layers\|''~~<Layers>'']] tag in XML, or the "layer" parameter in [[API Frame CreateTexture\|Frame:CreateTexture]](). To change the layer after creation, use the [[API LayeredRegion SetDrawLayer\|LayeredRegion:SetDrawLayer]]() function.		<Layers>
			<Layer level="BACKGROUND">
	~~''Note: The above are capitalized for a reason. See example:''~~<~~BR />~~

	~~<Layers>~~
	~~<~~Layer level="BACKGROUND"~~>~~
	...		...
	~~<~~/Layer~~>~~		</Layer>
	~~<~~Layer level="ARTWORK"~~>~~		<Layer level="ARTWORK">
	...		...
	~~<~~/Layer~~>~~		</Layer>
	~~<~~Layer level="OVERLAY"~~>~~		<Layer level="OVERLAY">
	...		...
	~~<~~/Layer~~>~~		</Layer>
	~~<~~/Layers~~>~~		</Layers>

			=== textureSubLevel ===
			This allows for fine tuning order of Textures in a Layer. FontStrings are always drawn on top of Textures at the same Level, so this only applies to Textures.

			== External links ==
			* [//www.wowinterface.com/forums/showthread.php?t=37051 wowInterface forums] - discussion on Layer mechanics for patch 4.0 and newer

91.155.249.66: /* Elements */ Fixed "FonstString" typos

2018-01-29T02:28:28Z

Elements: Fixed "FonstString" typos

← Older revision		Revision as of 02:28, 29 January 2018
Line 8:		Line 8:
	==Elements==		==Elements==
	* [[XML/Texture\|Texture]] ... - 0 or more Textures to be rendered in the Layer		* [[XML/Texture\|Texture]] ... - 0 or more Textures to be rendered in the Layer
	* [[XML/FontString\|~~FonstString~~]] ... - 0 or more ~~FonstStrings~~ to be rendered in the Layer		* [[XML/FontString\|FontString]] ... - 0 or more FontStrings to be rendered in the Layer

	==Attributes==		==Attributes==

WoWWiki>Darekun: /* Details */ Escaped the pointy brackets, so the wiki doesn't treat <Layer> as for its consumption.

2017-11-11T23:46:57Z

Details: Escaped the pointy brackets, so the wiki doesn't treat <Layer> as for its consumption.

← Older revision		Revision as of 23:46, 11 November 2017
Line 18:		Line 18:

	=== Example ===		=== Example ===
	<[[XML/Frame\|Frame]] name="MyFrame">		<[[XML/Frame\|Frame]] name="MyFrame">
	<Layers>		<Layers>
	<Layer>		<Layer>
	<[[XML/Texture\|Texture]]>		<[[XML/Texture\|Texture]]>
	<Size x="100" y="100" />		<Size x="100" y="100" />
	<HitRectInsets>		<HitRectInsets>
	<[[XML/AbsInset\|AbsInset]] left="0" right="-100" top="0" bottom="0"/>		<[[XML/AbsInset\|AbsInset]] left="0" right="-100" top="0" bottom="0"/>
	</HitRectInsets>		</HitRectInsets>
	<Color a="1" r="1" g="1" b="1" />		<Color a="1" r="1" g="1" b="1" />
	</Texture>		</Texture>
	<Texture>		<Texture>
	<Size x="100" y="100" />		<Size x="100" y="100" />
	<Color a="1" r="1" g="1" b="1" />		<Color a="1" r="1" g="1" b="1" />
	</Texture>		</Texture>
	</Layer>		</Layer>
	</Layers>		</Layers>
	</Frame>		</Frame>

	This example will show a frame with a single default layer, displaying two textures.		This example will show a frame with a single default layer, displaying two textures.
Line 55:		Line 55:
	''Note: The above are capitalized for a reason. See example:''<BR />		''Note: The above are capitalized for a reason. See example:''<BR />

	<Layers>		<Layers>
	<Layer level="BACKGROUND">		<Layer level="BACKGROUND">
	...		...
	</Layer>		</Layer>
	<Layer level="ARTWORK">		<Layer level="ARTWORK">
	...		...
	</Layer>		</Layer>
	<Layer level="OVERLAY">		<Layer level="OVERLAY">
	...		...
	</Layer>		</Layer>
	</Layers>		</Layers>

Bear: Created page with "{{uixmltype}} < Layers A Layer is a fundamental UI building block for defining visible UI elements of Frames. A Layer is an element..."

2012-09-24T23:29:24Z

Created page with "{{uixmltype}} < Layers A Layer is a fundamental UI building block for defining visible UI elements of Frames. A Layer is an element..."

New page

{{uixmltype}} < [[XML/Layers|Layers]]

A [[XML/Layer|Layer]] is a fundamental UI building block for defining visible UI elements of [[XML/Frame|Frames]]. A Layer is an element of an [[XML/Layers|Layers]] array defined in a [[XML/Frame|Frame]]. Layer XML elements, as a part of [[XML/Layers|Layers]] array, can be defined on any [[XML/Frame|Frame]], which includes elements like [[XML/Button|Buttons]] and [[XML/CheckButton|CheckButtons]].

==Inheritance==
Inherited by: none, Inherits: none, Defined in: [[XML/Frame|Frame]] > [[XML/Layers|Layers]]

==Elements==
* [[XML/Texture|Texture]] ... - 0 or more Textures to be rendered in the Layer
* [[XML/FontString|FonstString]] ... - 0 or more FonstStrings to be rendered in the Layer

==Attributes==
* level ([[XML/DRAWLAYER|DRAWLAYER]]) - Layer level in 'Z order'. Default is 'ARTWORK'.
* textureSubLevel (int) - Additional sub-leveling of 'level'. Range of -8 .. 7. Default is '0'.

== Summary ==
An Layer is a fundemental UI construct for defining visible renderable elements of [[XML/Frame|Frames]]. An Layer is an element of an [[XML/Layers|Layers]] array defined in a [[XML/Frame|Frame]]. Layer XML elements, as a part of [[XML/Layers|Layers]] array, can be defined on any [[XML/Frame|Frame]], which also includes [[XML/Button|Buttons]] and [[XML/CheckButton|CheckButtons]].

=== Example ===
<[[XML/Frame|Frame]] name="MyFrame">
<Layers>
<Layer>
<[[XML/Texture|Texture]]>
<Size x="100" y="100" />
<HitRectInsets>
<[[XML/AbsInset|AbsInset]] left="0" right="-100" top="0" bottom="0"/>
</HitRectInsets>
<Color a="1" r="1" g="1" b="1" />
</Texture>
<Texture>
<Size x="100" y="100" />
<Color a="1" r="1" g="1" b="1" />
</Texture>
</Layer>
</Layers>
</Frame>

This example will show a frame with a single default layer, displaying two textures.

== Details ==

There are 3 levels of layers: BACKGROUND is in the back, ARTWORK is in the middle and OVERLAY is in front. If you want to be sure that a object is before another, you must specify the level where you want to place it.

BACKGROUND - Level 0. Place the background of your frame here. 
BORDER - Level 1. Place the artwork of your frame here . 
ARTWORK - Level 2. Place the artwork of your frame here. 
OVERLAY - Level 3. Place your text, objects, and buttons in this level. 
HIGHLIGHT - Level 4. Place your text, objects, and buttons in this level. 

*Elements in the '''HIGHLIGHT''' Layer are '''automatically shown or hidden''' when the mouse enters or leaves.
*For Highlighting to work you need '''enableMouse="true"''' in your ''<Frame>'' attributes.

Layer can be set on creation using the [[XML_properties#layers|''<Layers>'']] tag in XML, or the "layer" parameter in [[API Frame CreateTexture|Frame:CreateTexture]](). To change the layer after creation, use the [[API LayeredRegion SetDrawLayer|LayeredRegion:SetDrawLayer]]() function.

''Note: The above are capitalized for a reason. See example:'' 

<Layers>
<Layer level="BACKGROUND">
...
</Layer>
<Layer level="ARTWORK">
...
</Layer>
<Layer level="OVERLAY">
...
</Layer>
</Layers>