Difference between revisions of "Object Element"
imported>JRoush m (Oblivion XML moved to Image Element: reusing this page for a popular element type) |
Tag: Manual revert |
||
| (18 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
== Oblivion XML | == Overview == | ||
=== | Object Elements are a subgroup of the elements in the [[:Category: Oblivion XML|Oblivion XML]] schema. Every visible part of a menu - the background and images, the buttons, the text - is an object element. | ||
=== Elements === | Object Elements are usually given a name to identify them using the [[XML Attribute|Name]] attribute, e.g. the image element that holds a menu's background texture might be: | ||
<image name="background_texture"> </image> | |||
[[Operator Element|Operator Elements]] and [[:Category:UI Functions (OBSE)|OBSE menu functions]] generally refer to Objects by their name. | |||
Object Elements should not contain literal text or numbers. Instead, they should have a series of [[Property Element]]s as children, which in turn will contain the various parameters that describe the object. For example, the <text> element that holds the title of a menu might be defined like this: | |||
<text name="title_text"> <!-- [[#Text|Text]] element, [[XML Attribute|Name]] attribute is 'title_text' --> | |||
<x> 100 </x> <!-- position determined by <[[Property Element#Sizeable|x]]> & <[[Property Element#Sizeable|y]]> Property elements --> | |||
<y> 150 </y> | |||
<font> 2 </font> <!-- text font determined by <[[Property Element#Text|font]]> Property element--> | |||
<string> <!-- actual text determined by <[[Property Element#Text|string]]> Property element --> | |||
This is the Actual Title | |||
</string> | |||
</text> | |||
Below is a listing of common Object Elements, and the groups of Properties each can make use of. | |||
== Image == | |||
Defines a rectangular region with an associated [[Portal:Texturing|texture]]. Every visible aspect of the menus and HUD, except for text, is an <image> element. | |||
'''Property Elements''' | |||
*[[Property Element#General|General]] | |||
*[[Property Element#Sizeable|Sizeable]] | |||
*[[Property Element#Rendered|Rendered]] | |||
*[[Property Element#Mouse Targetable|Mouse Targetable]] | |||
*[[Property Element#Textured|Textured]] | |||
== Rect == | |||
Defines a rectangular region (similar to an Image element), but without any visible effects. Even so, a <Rect> element may have a [[Property Element#Rendered|Visible]] property, which if set to false will hide the <Rect> element and all of its children. | |||
'''Property Elements''' | |||
*[[Property Element#General|General]] | |||
*[[Property Element#Sizeable|Sizeable]] | |||
*[[Property Element#Mouse Targetable|Mouse Targetable]] | |||
== Text == | |||
Self explanatory. Note, however, that the width and height property elements have no effect on the size of the text - this is determined solely by the font property. | |||
'''Property Elements''' | |||
*[[Property Element#General|General]] | |||
*[[Property Element#Sizeable|Sizeable]] | |||
*[[Property Element#Rendered|Rendered]] | |||
*[[Property Element#Text|Text]] | |||
== Menu == | |||
Menu elements are a bit special. The root element of a every menu file must be of this type, and no other <menu> elements are parsed, no matter where they appear in the file. | |||
'''Property Elements''' | |||
*[[Property Element#General|General]] | |||
*[[Property Element#Menu|Menu]] | |||
[[Category:Oblivion XML]] | |||
Latest revision as of 12:16, 21 December 2023
Overview[edit | edit source]
Object Elements are a subgroup of the elements in the Oblivion XML schema. Every visible part of a menu - the background and images, the buttons, the text - is an object element.
Object Elements are usually given a name to identify them using the Name attribute, e.g. the image element that holds a menu's background texture might be:
<image name="background_texture"> </image>
Operator Elements and OBSE menu functions generally refer to Objects by their name.
Object Elements should not contain literal text or numbers. Instead, they should have a series of Property Elements as children, which in turn will contain the various parameters that describe the object. For example, the <text> element that holds the title of a menu might be defined like this:
<text name="title_text"> <!-- Text element, Name attribute is 'title_text' --> <x> 100 </x> <!-- position determined by <x> & <y> Property elements --> <y> 150 </y> <font> 2 </font> <!-- text font determined by <font> Property element--> <string> <!-- actual text determined by <string> Property element --> This is the Actual Title </string> </text>
Below is a listing of common Object Elements, and the groups of Properties each can make use of.
Image[edit | edit source]
Defines a rectangular region with an associated texture. Every visible aspect of the menus and HUD, except for text, is an <image> element.
Property Elements
Rect[edit | edit source]
Defines a rectangular region (similar to an Image element), but without any visible effects. Even so, a <Rect> element may have a Visible property, which if set to false will hide the <Rect> element and all of its children.
Property Elements
Text[edit | edit source]
Self explanatory. Note, however, that the width and height property elements have no effect on the size of the text - this is determined solely by the font property.
Property Elements
Menu[edit | edit source]
Menu elements are a bit special. The root element of a every menu file must be of this type, and no other <menu> elements are parsed, no matter where they appear in the file.
Property Elements