RCOXML Coding: Difference between revisions

From PS3 Developer wiki
Jump to navigation Jump to search
m (→‎RCOXML Structure: linking wiki pages)
mNo edit summary
Line 27: Line 27:
  xmb_plugin_normal.rco
  xmb_plugin_normal.rco


== RCOXML Structure ==
= RCOXML Contents (PS3) =
 
= RCOXML Structure =
Not all nodes below are required, and various object/anim entries are omitted.
Not all nodes below are required, and various object/anim entries are omitted.


Line 61: Line 63:
  animation entries go here
  animation entries go here
  ...
  ...
===VSMXFile===
==VSMXFile==
None of the PS3 rco's uses a VSMXFile
None of the PS3 rco's uses a VSMXFile
===ImageTree===
==ImageTree==
*All PS3 rco's uses a ImageTree except:
*All PS3 rco's uses a ImageTree except:
**[[ap_plugin]].rco
**[[ap_plugin]].rco
Line 99: Line 101:
**[[videoplayer_util]].rco
**[[videoplayer_util]].rco


===TextTree===
==TextTree==
*All PS3 rco's uses a TextTree except:
*All PS3 rco's uses a TextTree except:
**[[ap_plugin]].rco
**[[ap_plugin]].rco
Line 118: Line 120:
**[[subdisplay_plugin]].rco
**[[subdisplay_plugin]].rco


===ModelTree===
==ModelTree==
None of the PS3 rco's uses a ModelTree
None of the PS3 rco's uses a ModelTree
===SoundTree===
==SoundTree==
*Rco files in PS3 firmware 4.76 using a SoundTree:
*Rco files in PS3 firmware 4.76 using a SoundTree:
**[[edy_plugin]].rco
**[[edy_plugin]].rco
Line 128: Line 130:
**[[system_plugin]].rco
**[[system_plugin]].rco
**[[videoeditor_plugin]].rco
**[[videoeditor_plugin]].rco
===ObjectTree===
==ObjectTree==
*All PS3 rco's uses a ObjectTree except:
*All PS3 rco's uses a ObjectTree except:
**[[audioplayer_plugin_dummy]].rco
**[[audioplayer_plugin_dummy]].rco
Line 136: Line 138:
**[[search_service]].rco
**[[search_service]].rco


===AnimTree===
==AnimTree==
*Rco files in PS3 firmware 4.76 using a AnimTree:
*Rco files in PS3 firmware 4.76 using a AnimTree:
**[[bdp_plugin]].rco
**[[bdp_plugin]].rco
Line 149: Line 151:
**[[system_plugin]].rco
**[[system_plugin]].rco


==RCOXML Modifications==
=RCOXML Modifications=
All modifications made in the main XML file that represents the structure of the RCO extracted by [[rcomage]] belongs to this category
All modifications made in the main XML file that represents the structure of the RCO extracted by [[rcomage]] belongs to this category


===Changing color, size & shadow of TEXTS=== <!-- iirc there is a setting for the font type too -->
==Changing color, size & shadow of TEXTS== <!-- iirc there is a setting for the font type too -->


Tutorial link: [http://www.tortuga-cove.com/forums/viewtopic.php?f=128&t=5361&p=28094#p28094 Changing the XMB Colour]
Tutorial link: [http://www.tortuga-cove.com/forums/viewtopic.php?f=128&t=5361&p=28094#p28094 Changing the XMB Colour]
Line 160: Line 162:
  e.g.: Decimal value divided by 255 to get into this scale.
  e.g.: Decimal value divided by 255 to get into this scale.


===Gameboot Animation===
==Gameboot Animation==
In [[gamelib_plugin]].rco
In [[gamelib_plugin]].rco
{{Boxcode|content=<syntaxhighlight lang="xml">
{{Boxcode|content=<syntaxhighlight lang="xml">

Revision as of 05:09, 17 November 2015

Description

RCOXML files are the XML descriptor files implicit inside Resource Container (RCO) files (.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

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

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

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)

audioplayer_plugin_util.rco
avc_game_plugin.rco
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

RCOXML Contents (PS3)

RCOXML Structure

Not all nodes below are required, and various object/anim entries are omitted.

RcoFile - XML root element; generally does not need to be modified
	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
			...
		TextTree - parent node from which all text language resources descend from
			TextLang
			TextLang
			...
		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
			...

VSMXFile

None of the PS3 rco's uses a VSMXFile

ImageTree

TextTree

ModelTree

None of the PS3 rco's uses a ModelTree

SoundTree

ObjectTree

AnimTree

RCOXML Modifications

All modifications made in the main XML file that represents the structure of the RCO extracted by rcomage belongs to this category

Changing color, size & shadow of TEXTS

Tutorial link: Changing the XMB Colour

Located into .xml files of .rco files, scale R G B α colors go between 0 to 1.

e.g.: Decimal value divided by 255 to get into this scale.

Gameboot Animation

In gamelib_plugin.rco

Code Sample

In custom_render_plugin.rco

Code Sample