XMBML Folder Trees: Difference between revisions

From PS3 Developer wiki
Jump to navigation Jump to search
m (Sandungas moved page XMBML Examples. Folder Trees to XMBML Folder Trees without leaving a redirect)
(Undo 3 edits that is just a user monologuing about the playstation consoles)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
= An XMB item tree =
= An XMB item tree =
This is an example of an [[XMBML Structure]] composed by a main XMB item which will act as a folder opening up into 3 other XMB folder items.
This is an example of an [[XMBML Coding|XMBML]] file composed by a main XMB item which will act as a folder opening up into 3 other XMB folder items.


First create the root XMB item which acts as a folder
First create the root XMB item which acts as a folder
{{Boxcode|content=<syntaxhighlight lang="xml">
{{Boxcode|code=<syntaxhighlight lang="xml">
<View id="root">
<View id="root">
<Attributes>
<Attributes>
Line 28: Line 28:
In order to create a working XMB sub menu the root xmb item must have its 'src' linking to a "container" (its the best way to think about it) and not directly linking to XMB items in the sub menu.( If you do not do this when you select your root XMB item to display a sub menu, the 'output' or 'action' of the XMB items of the sub menu will be shown rather than the actual XMB items):
In order to create a working XMB sub menu the root xmb item must have its 'src' linking to a "container" (its the best way to think about it) and not directly linking to XMB items in the sub menu.( If you do not do this when you select your root XMB item to display a sub menu, the 'output' or 'action' of the XMB items of the sub menu will be shown rather than the actual XMB items):


{{Boxcode|content=<syntaxhighlight lang="xml">
{{Boxcode|code=<syntaxhighlight lang="xml">
<View id="seg_folder_tree_main_container">
<View id="seg_folder_tree_main_container">
<Items>
<Items>
Line 42: Line 42:
Now to create the segment which holds the sub menu items:
Now to create the segment which holds the sub menu items:


{{Boxcode|content=<syntaxhighlight lang="xml">
{{Boxcode|code=<syntaxhighlight lang="xml">
<View id="seg_folder_tree_main_contents">
<View id="seg_folder_tree_main_contents">
<Attributes>
<Attributes>
Line 73: Line 73:
* notice how the &lt;attr&gt; from the &lt;Items&gt; sub entries matches the &lt;Table keys&gt; from the &lt;Attributes&gt; sub entries
* notice how the &lt;attr&gt; from the &lt;Items&gt; sub entries matches the &lt;Table keys&gt; from the &lt;Attributes&gt; sub entries


{{System Firmware}}<noinclude>[[Category:Main]]</noinclude>
{{File Formats}}<noinclude>
[[Category:Main]]
</noinclude>

Latest revision as of 15:43, 19 February 2024

An XMB item tree[edit | edit source]

This is an example of an XMBML file composed by a main XMB item which will act as a folder opening up into 3 other XMB folder items.

First create the root XMB item which acts as a folder

	<View id="root">
		<Attributes>
			<Table key="folder_tree_main">
				<Pair key="icon_rsc"><String>tex_album_icon</String></Pair>
				<Pair key="title"><String>Main folder, contains 3 subfolders</String></Pair>
				<Pair key="child"><String>segment</String></Pair>
			</Table>
		</Attributes>
		<Items>
			<Query class="type:x-xmb/folder-pixmap"  key="folder_tree_main" attr="folder_tree_main" src="#seg_folder_tree_main_container" />
		</Items>
	</View>

Important Notes:

  • I've used "<Query class="type:x-xmb/folder-pixmap"" for <Items> sub-entry type as it is good for displaying menus.
  • The 'attr' in the <Items> sub-entry is the same as the table key in Attributes, so those attributes are asociated
  • the 'src' is using the character # that works as a link to load another "view id" segment in the current .xml
  • the 'icon_rsc' is the "default folder" icon loaded from a .rco (and available for all XMB columns)
  • 'title' is in plain text
  • 'child' is set as 'segment' so the XMB knows this item will subdivide into other XMB items

In order to create a working XMB sub menu the root xmb item must have its 'src' linking to a "container" (its the best way to think about it) and not directly linking to XMB items in the sub menu.( If you do not do this when you select your root XMB item to display a sub menu, the 'output' or 'action' of the XMB items of the sub menu will be shown rather than the actual XMB items):

	<View id="seg_folder_tree_main_container">
		<Items>
			<Query class="type:x-xmb/folder-pixmap"  key="whatever" src="#seg_folder_tree_main_contents" />
		</Items>
	</View>

Important Notes:

  • This has no attributes as it simply acts as a contents container/linker
  • The key is just an identifyer, you can use any name

Now to create the segment which holds the sub menu items:

	<View id="seg_folder_tree_main_contents">
		<Attributes>
			<Table key="folder_tree_subfolder_1">
				<Pair key="icon_rsc"><String>tex_album_icon</String></Pair>
				<Pair key="title"><String>Subfolder 1</String></Pair>
				<Pair key="str_noitem"><String>msg_error_no_file</String></Pair>
			</Table>
			<Table key="folder_tree_subfolder_2">
				<Pair key="icon_rsc"><String>tex_album_icon</String></Pair>
				<Pair key="title"><String>Subfolder 2</String></Pair>
				<Pair key="str_noitem"><String>msg_error_no_file</String></Pair>
			</Table>
			<Table key="folder_tree_subfolder_3">
				<Pair key="icon_rsc"><String>tex_album_icon</String></Pair>
				<Pair key="title"><String>Subfolder 3</String></Pair>
				<Pair key="str_noitem"><String>msg_error_no_file</String></Pair>
			</Table>
		</Attributes>
		<Items>
			<Query class="type:x-xmb/folder-pixmap"  key="folder_tree_subfolder_1" attr="folder_tree_subfolder_1" />
			<Query class="type:x-xmb/folder-pixmap"  key="folder_tree_subfolder_2" attr="folder_tree_subfolder_2" />
			<Query class="type:x-xmb/folder-pixmap"  key="folder_tree_subfolder_3" attr="folder_tree_subfolder_3" />
		</Items>
	</View>

Important Notes:

  • These are dummy items, they do not 'go anywhere' or perform any function. They will just print the str_noitem message when clicked because they have no function
  • notice how the <attr> from the <Items> sub entries matches the <Table keys> from the <Attributes> sub entries