RCOXML Coding

From PS3 Developer wiki
Revision as of 07:21, 14 November 2015 by Sandungas (talk | contribs) (→‎TextTree)
Jump to navigation Jump to search

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

Most PS3 rco's uses a ImageTree

TextTree

  • All PS3 rco's uses a TextTree except:
    • ap_plugin.rco
    • avc2_game_video_plugin.rco
    • checker_plugin.rco
    • custom_render_plugin.rco
    • game_indicator_plugin.rco
    • gamelib_plugin.rco
    • idle_plugin.rco
    • musicbrowser_plugin.rco
    • newstore_effect.rco
    • osk_plugin.rco
    • pesm_plugin.rco
    • photolist_plugin.rco
    • podl_plugin.rco
    • rec_plugin.rco
    • scenefolder_plugin.rco
    • subdisplay_plugin.rco

ModelTree

None of the PS3 rco's uses a ModelTree

SoundTree

  • Rco files in PS3 firmware 4.76 using a SoundTree:
    • edy_plugin.rco
    • eula_net_plugin.rco
    • osk_plugin.rco
    • regcam_plugin.rco
    • system_plugin.rco
    • videoeditor_plugin.rco

ObjectTree

  • All PS3 rco's uses a ObjectTree except:
    • audioplayer_plugin_dummy.rco
    • avc2_game_plugin.rco
    • category_setting_plugin.rco
    • newstore_effect.rco <------- this file is a wtf, it seems to be empty
    • search_service.rco

AnimTree

  • Rco files in PS3 firmware 4.76 using a AnimTree:
    • bdp_plugin.rco
    • custom_render_plugin.rco
    • friendim_plugin.rco
    • friendim_plugin_game.rco
    • gamelib_plugin.rco
    • impose_plugin.rco
    • npsignin_plugin.rco
    • premo_plugin.rco
    • sacd_plugin.rco
    • system_plugin.rco

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