Editing RCOXML Coding

Jump to navigation Jump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
=Description=
=Description=
An RCOXML file is a XML file that represents the contents of a RCO file. This RCOXML files doesnt exists inside the RCO file (are just a representation of it). In the compilation enviroment used officially by sony this RCOXML files "should" work as a "pre-build" layout, contains all the info and settings needed to build an RCO file
RCOXML files are the XML descriptor files implicit inside [[Resource Container (RCO)]] files (.rco)


Tools like [[Rcomage]] generates this RCOXML files that can be used to rebuild the RCO, or to build a custom RCO from scratch, this RCOXML files generated by rcomage "should" be pretty similar to the officials because all the info is based in the TOC area of the RCO that is structured as an XML so the conversion from TOC to XML format is direct (also, rcomage adds some info for rebuilding purposes that is not part of the TOC), see [[Resource Container (RCO)]]
This RCOXML files doesnt exists inside the .rco container, tools like [[Rcomage]] extracts the info as XML as a representation of the data inside the .rco container
{{RCOXML contents PS3}}


= RCOXML Structure =
Are composed by tables, some of this tables works simply as an index of the contents inside the container (texts, sounds, languages), and others tables contains "pages" that builds the XMB items, animations, effects, dialog menues, selection windows, widgets, etc...
This is a '''not-working''' example intended to place all together as an overview. Not all nodes below are required, and various object/anim entries are omitted.


{{Boxcode|code=<syntaxhighlight lang="xml">
Note the name "page" here in wiki is used as a generic name for all types of pages, rcomage uses specific names for some types of pages wich purpose was identifyed, this names can vary between different versions of rcomage tool
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- This XML representation of an RCO structure was generated by Rcomage v1.1.2 -->
<RcoFile UMDFlag="0" rcomageXmlVer="1.1" type="psp" minFirmwareVer="1.5"> <!-- XML root element, generally does not need to be modified -->
<MainTree name="sample"> <!-- root RCO node from which everything must descend from -->
<VSMXFile name="main" src="main.vsmx"></VSMXFile> <!-- attached virtual machine instruction code, only one may exist in an RCO file -->
<ImageTree> <!-- parent node from which all image resources descend from -->
<Image name="texture" src="texture.gim" format="gim" compression="zlib" unknownByte="0" />
</ImageTree>
<FontTree> <!-- parent node from which all fonts descend from -->
<FontStyle name="fontstyle_default" unknownShort1="0x0" unknownShort2="0x0" unknownInt3="0x0" unknownInt4="0x41600000" />
</FontTree>
<TextTree> <!-- parent node from which all text language resources descend from -->
<TextLang src="00_Japanese.xml" language="00_Japanese" format="utf16" />
</TextTree>
<ModelTree> <!-- parent node from which all model resources descend from -->
<Model name="page_model" src="page_model.gmo" format="gmo" compression="zlib" unknownByte="0" />
</ModelTree>
<SoundTree> <!-- parent node from which all sound resources descend from -->
<Sound name="sound" src="sound.ch*.vag" format="vag" channels="2" />
</SoundTree>
<ObjectTree> <!-- parent node from which all object pages descend from -->
<Page name="main_page" pageMode="0x111" pageOnInit="event:script:/main/onInitMainPage" pageOnCancel="nothing" pageOnContext="nothing" pageOnActivate="nothing">
<Plane name="main_page_plane" ...standard object attributes here... planeImage="image:texture" planeResizeMode="0x0">
<ModelObject name="main_page_model"  ...standard object attributes here...  modelobjectModel="model:page_model"></ModelObject>
<Action name="go" actionText="text:msg_go"></Action>
</Plane>
</Page>
</ObjectTree>
<AnimTree> <!-- parent node from which all animation sequences descend from -->
<Animation name="main_page_fade">
<Fade object="object:main_page_plane" duration="100" accelMode="0x0" transparency="1" />
<FireEvent event="anim:main_page_fade" />
</Animation>
</AnimTree>
</MainTree>
</RcoFile>
</syntaxhighlight>}}


==MainTree==
For specific examples of the contents of this rcoxml files see the [[Plugin Interfaces]] page, most resource containers (.rco) uses the same name than his associated plugin (.sprx), but there are a few that doesnt follows this rule so is a bit harder to know from how many plugins .sprx can be called (and this is a problem for wiki by now because the way pages are ordered and named)
All RCOXML files starts with the tag:
<MainTree name="label">
MainTree represents the root of the container, so it seems the label is the name of the .rco container and is working as an identifyer of it


*Is unknown how this labels works and his purpose, but follows a few rules:
audioplayer_plugin_util.rco
**The same label can be used by several .rco's that shares functions
avc_game_plugin.rco
**This label names doesnt appears in the associated .sprx
checker_plugin.rco
explore_plugin_full.rco
friendim_plugin_game.rco
friendml_plugin_game.rco
friendtrophy_plugin_game.rco
game_plugin.rco
impose_plugin.rco
msgdialog_plugin.rco
profile_plugin_mini.rco
search_service.rco
subdisplay_plugin.rco
sv_pseudoaudioplayer_plugin.rco
system_plugin.rco
xmb_plugin_normal.rco


*Other .rco files from previous firmwares (not present in latest firmwares) using the MainTree name '''sample'''
== RCOXML Structure ==
**xai_plugin.rco
Not all nodes below are required, and various object/anim entries are omitted.
**In PSP firmware there are also some .rco files using the MainTree name '''sample'''


===VSMXFile===
RcoFile - XML root element; generally does not need to be modified
None of the PS3 rco's uses a VSMXFile. But some PSP .rco's uses it
MainTree - root RCO node from which everything must descend from
VSMXFile - attached UMD virtual machine instruction code, for UMD and some LFTV RCOs.  Only one may exist in an RCO file
ImageTree - parent node from which all image resources descend from
Image
Image
...
ModelTree - parent node from which all model resources descend from
Model
Model
...
SoundTree - parent node from which all sound resources descend from
Sound
Sound
...
ObjectTree - parent node from which all object pages descend from
<Page>
page objects go here
<Page>
page objects go here
...
AnimTree - parent node from which all animation sequences descend from
<Animation>
animation entries go here
<Animation>
animation entries go here
...


*rough explain of how it works
**The purpose of this script is to communicate with the associated module/sprx, the code inside the script is [[PlayStation JavaScript]] based (see also [[VSMX]] format) and it can call functions with parameters from the module/sprx. It works as a simple way to store predefined actions for the .sprx inside the .rco with a bit of code control involved. The [[RCOXML Objects]] captures the button presses from the controller and based on them loads the script using the buttons as parameters, then the code inside the script is processed and triggers the .sprx
**An script can contain several different actions (are actually .js code functions) and his names are the same than the action names used in [[RCOXML Objects]], as example: '''OnFocusRight''' (action triggered when moving right in the controller)


===ImageTree===
=Examples=
 
{{Boxcode|content=<syntaxhighlight lang="xml">
===FontTree===
<?xml version="1.0" encoding="UTF-8"?>
Only used in PS3, only used in sysconf_plugin.rco and hknw_plugin.rco
.
 
..
===TextTree===
...
 
</syntaxhighlight>}}
===ModelTree===
{{System Firmware}}<noinclude>[[Category:Main]]</noinclude>
None of the PS3 rco's uses a ModelTree
 
===SoundTree===
 
===ObjectTree===
*in [http://ctfs.wiki.fc2.com/wiki/RCOmageXML this page] under the section "ObjectTree" are explained what seems to be a few golden rules related to:
**object display priority
**children objects inherited attributes from parent object
 
===AnimTree===
 
{{File Formats}}
<noinclude>[[Category:Main]]</noinclude>
Please note that all contributions to PS3 Developer wiki are considered to be released under the GNU Free Documentation License 1.2 (see PS3 Developer wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following hCaptcha:

Cancel Editing help (opens in new window)