RCOXML Coding

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

RCOXML Contents (PS3)

There are 122 .rco files in PS3 firmware 4.76

filename.rco	RCOXML contents								notes
	MainTree Name	ImageTree	FontTree	TextTree	ModelTree	SoundTree	ObjectTree	AnimTree
ap_plugin.rco	ap_plugin	No	No	No	No	No	Yes	No
audioplayer_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No
audioplayer_plugin_dummy.rco	sample	No	No	Yes	No	No	No	No
audioplayer_plugin_mini.rco	sample	No	No	Yes	No	No	Yes	No
audioplayer_plugin_util.rco	sample	No	No	Yes	No	No	Yes	No	Associated .sprx has a different name.
auth_plugin.rco	auth_plugin	Yes (gim)	No	Yes	No	No	Yes	No
autodownload_plugin.rco	autodownload_plugin	Yes (gim)	No	Yes	No	No	Yes	No
autoupdateconf_plugin.rco	autoupdateconff_plugin	Yes (gim)	No	Yes	No	No	Yes	No
avc2_game_plugin.rco	sample	No	No	Yes	No	No	No	No
avc2_game_video_plugin.rco	sample	Yes (gim)	No	No	No	No	Yes	No
avc2_text_plugin.rco	tcgui	Yes (gim)	No	Yes	No	No	Yes	No
avc_game_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No	Associated .sprx has a different name.
avc_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No
bdp_disccheck_plugin.rco	bdp_disccheck_plugin	No	No	Yes	No	No	Yes	No
bdp_plugin.rco	bdp_plugin	Yes (gim)	No	Yes	No	No	Yes	Yes
bdp_storage_plugin.rco	bdp_storage_plugin	No	No	Yes	No	No	Yes	No
campaign_plugin.rco	campaign_plugin	Yes (gim, png)	No	Yes	No	No	Yes	No
category_setting_plugin.rco	category_setting_plugin	Yes (gim)	No	Yes	No	No	No	No
checker_plugin.rco	checker	No	No	No	No	No	Yes	No	Associated .sprx has a different name.
closedcaption_config_plugin.rco	closedcaption_config_plugin	Yes (gim)	No	Yes	No	No	Yes	No
comboplay_plugin.rco	comboplay_plugin	Yes (gim)	No	Yes	No	No	Yes	No
custom_render_plugin.rco	custom_render_plugin	Yes (gim)	No	No	No	No	Yes	Yes
data_copy_plugin.rco	sample	No	No	Yes	No	No	Yes	No
deviceconf_plugin.rco	deviceconf_plugin	Yes (gim)	No	Yes	No	No	Yes	No
dlna_plugin.rco	dlna	Yes (gim)	No	Yes	No	No	Yes	No
download_plugin.rco	download	Yes (gim)	No	Yes	No	No	Yes	No
dtcpip_util.rco	dtcpip_util	No	No	Yes	No	No	Yes	No
edy_plugin.rco	edy_plugin	Yes (gim)	No	Yes	No	Yes	Yes	No
eula_cddb_plugin.rco	eula_cddb_plugin	Yes (gim)	No	Yes	No	No	Yes	No
eula_hcopy_plugin.rco	eula_hcopy	Yes (gim)	No	Yes	No	No	Yes	No
eula_net_plugin.rco	regcam_plugin	Yes (gim, png, jpg)	No	Yes	No	Yes	Yes	No
explore_category_friend.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_category_game.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_category_music.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_category_network.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_category_photo.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_category_psn.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_category_sysconf.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_category_tv.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_category_user.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_category_video.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_plugin_ft.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_plugin_full.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No	Associated .sprx has a different name.
explore_plugin_game.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
explore_plugin_np.rco	explore_plugin	Yes (gim)	No	Yes	No	No	Yes	No
filecopy_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No
friendim_plugin.rco	friendim	Yes (gim)	No	Yes	No	No	Yes	Yes
friendim_plugin_game.rco	friendim	Yes (gim)	No	Yes	No	No	Yes	Yes	Associated .sprx has a different name.
friendml_plugin.rco	friendml_plugin	Yes (gim)	No	Yes	No	No	Yes	No
friendml_plugin_game.rco	friendml_plugin	Yes (gim)	No	Yes	No	No	Yes	No	Associated .sprx has a different name.
friendtrophy_plugin.rco	friendtrophy_plugin	Yes (gim)	No	Yes	No	No	Yes	No
friendtrophy_plugin_game.rco	friendtrophy_plugin	Yes (gim)	No	Yes	No	No	Yes	No	Associated .sprx has a different name.
game_ext_plugin.rco	game_ext_plugin	Yes (gim, png)	No	Yes	No	No	Yes	No
game_indicator_plugin.rco	user_info_plugin	Yes (gim)	No	No	No	No	Yes	No
game_plugin.rco	game_plugin	No	No	Yes	No	No	Yes	No	Associated .sprx has a different name.
gamedata_plugin.rco	gamedata_plugin	No	No	Yes	No	No	Yes	No
gamelib_plugin.rco	gamelib_plugin	Yes (gim)	No	No	No	No	Yes	Yes
gameupdate_plugin.rco	sample	No	No	Yes	No	No	Yes	No
hknw_plugin.rco	hknw_plugin	Yes (gim)	Yes	Yes	No	No	Yes	No
idle_plugin.rco	idle	No	No	No	No	No	Yes	No
impose_plugin.rco	impose_plugin	Yes (gim)	No	Yes	No	No	Yes	Yes	Associated .sprx has a different name.
ingame_manual_plugin.rco	ingame_manual	No	No	Yes	No	No	Yes	No
kensaku_plugin.rco	kensaku	Yes (gim)	No	Yes	No	No	Yes	No
msgdialog_plugin.rco	msgdialog_plugin	No	No	Yes	No	No	Yes	No	Associated .sprx has a different name.
mtpinitiator_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No
musicbrowser_plugin.rco	sample	No	No	No	No	No	Yes	No
nas_plugin.rco	nas_plugin	Yes (gim)	No	Yes	No	No	Yes	No
netconf_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No
newstore_effect.rco	skeleton_plugin	No	No	No	No	No	No	No	Empty file.
newstore_plugin.rco	newstore_plugin	Yes (gim, png, jpg)	No	Yes	No	No	Yes	No
np_eula_plugin.rco	npeula	Yes (gim)	No	Yes	No	No	Yes	No
np_matching_plugin.rco	np_matching_plugin	Yes (gim)	No	Yes	No	No	Yes	No
np_multisignin_plugin.rco	np_multisignin_plugin	Yes (gim)	No	Yes	No	No	Yes	No
np_sns_plugin.rco	npsns	Yes (gim)	No	Yes	No	No	Yes	No
np_trophy_ingame.rco	np_achiev	Yes (gim)	No	Yes	No	No	Yes	No
np_trophy_plugin.rco	np_achiev	Yes (gim)	No	Yes	No	No	Yes	No
npsignin_plugin.rco	npsignin_plugin	Yes (gim)	No	Yes	No	No	Yes	Yes
osk_plugin.rco	sample	Yes (gim)	No	No	No	Yes	Yes	No
oskfullkeypanel_plugin.rco	ime_osk_base_resouce	Yes (gim)	No	Yes	No	No	Yes	No
oskpanel_plugin.rco	ime_osk_base_resouce	Yes (gim)	No	Yes	No	No	Yes	No
pesm_plugin.rco	pesm	No	No	No	No	No	Yes	No
photo_network_sharing_plugin.rco	pesm	Yes (gim)	No	Yes	No	No	Yes	No
photolist_plugin.rco	sample	No	No	No	No	No	Yes	No
photoupload_plugin.rco	dlna	Yes (gim)	No	Yes	No	No	Yes	No
photoviewer_plugin.rco	photoviewer_plugin	Yes (gim, png)	No	Yes	No	No	Yes	No
playlist_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No
podl_plugin.rco	podl_plugin	No	No	No	No	No	Yes	No
poweroff_plugin.rco	poweroff	No	No	Yes	No	No	Yes	No
premo_plugin.rco	premo_plugin	Yes (gim)	No	Yes	No	No	Yes	Yes
print_plugin.rco	print_plugin	Yes (gim)	No	Yes	No	No	Yes	No
profile_plugin.rco	profile_plugin	Yes (gim)	No	Yes	No	No	Yes	No
profile_plugin_mini.rco	profile_plugin_mini	Yes (gim)	No	Yes	No	No	Yes	No	Associated .sprx has a different name.
ps3_savedata_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No
ps3_savedata_plugin_game_mini.rco	sample	No	No	Yes	No	No	Yes	No
rec_plugin.rco	rec_plugin	No	No	No	No	No	Yes	No
regcam_plugin.rco	regcam_plugin	Yes (gim, png, jpg)	No	Yes	No	Yes	Yes	No
remotedownload_plugin.rco	remotedownload	No	No	Yes	No	No	Yes	No
sacd_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	Yes
scenefolder_plugin.rco	sample	No	No	No	No	No	Yes	No
screenshot_plugin.rco	screenshot_plugin	No	No	Yes	No	No	Yes	No
search_service.rco	search_service	No	No	Yes	No	No	No	No	Associated .sprx has a different name.
software_update_plugin.rco	software_update_plugin	Yes (gim)	No	Yes	No	No	Yes	No
soundvisualizer_plugin.rco	soundvisualizer	Yes (gim)	No	Yes	No	No	Yes	No
strviewer_plugin.rco	strviewer	No	No	Yes	No	No	Yes	No
subdisplay_plugin.rco	ap_plugin	No	No	No	No	No	Yes	No	Associated .sprx has a different name.
sv_pseudoaudioplayer_plugin.rco	sv_pseudoaudioplayer	Yes (gim)	No	Yes	No	No	Yes	No	Associated .sprx has a different name.
sysconf_plugin.rco	sysconf_plugin	Yes (gim)	Yes	Yes	No	No	Yes	No
system_plugin.rco	system_plugin	Yes (gim)	No	Yes	No	Yes	Yes	Yes	Associated .sprx has a different name.
thumthum_plugin.rco	sample	No	No	Yes	No	No	Yes	No
upload_util.rco	upload_util	Yes (gim)	No	Yes	No	No	Yes	No
user_info_plugin.rco	user_info_plugin	No	No	Yes	No	No	Yes	No
user_plugin.rco	user	Yes (gim)	No	Yes	No	No	Yes	No
videoeditor_plugin.rco	skeleton_plugin	Yes (gim, png, jpg)	No	Yes	No	Yes	Yes	No
videoplayer_plugin.rco	videoplayer	Yes (gim)	No	Yes	No	No	Yes	No
videoplayer_util.rco	videoplayer	No	No	Yes	No	No	Yes	No
vmc_savedata_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No
wboard_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No
webbrowser_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No
webrender_plugin.rco	sample	Yes (gim)	No	Yes	No	No	Yes	No
xmb_ingame.rco	xmb_plugin	Yes (gim)	No	Yes	No	No	Yes	No
xmb_plugin_normal.rco	xmb_plugin	Yes (gim)	No	Yes	No	No	Yes	No	Associated .sprx has a different name.
ycon_manual_plugin.rco	ycon_plugin	Yes (gim)	No	Yes	No	No	Yes	No

• VSMXfile is not included in the table above because none of the PS3 .rco files includes them

RCOXML Structure

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.

Code Sample

MainTree

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:
  • The same label can be used by several .rco's that shares functions
  • This label names doesnt appears in the associated .sprx

• Other .rco files from previous firmwares (not present in latest firmwares) using the MainTree name sample
  • xai_plugin.rco
  • In PSP firmware there are also some .rco files using the MainTree name sample

VSMXFile

None of the PS3 rco's uses a VSMXFile. But some PSP .rco's uses it

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

FontTree

Only used in PS3, only used in sysconf_plugin.rco and hknw_plugin.rco

• sysconf_plugin.rco example:

Code Sample

• hknw_plugin.rco example:

Code Sample

ModelTree

None of the PS3 rco's uses a ModelTree

ObjectTree

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

Event types

event:native:

Loads a predefined set of actions from the embedded code in the associated .sprx

event:script:

Loads a predefined set of actions from the VSMX script inside the .rco

object2:

Loads an object from ObjectTree

anim:

Loads an animation from AnimTree

Measure units

Positions, in pixels with "world coordinates" (0,0,0 of the x,y,z axis) in center of the screen

Sizes, in pixels, negative numbers mirrors the image

Resizes, in percentage in a scale from 0 up to 1, negative numbers mirrors the image

Colors, in RGBA (red, green, blue, alpha) in a scale from 0 up to 1, where 1 represents the max value posible of 255

Times, in miliseconds, where 1000 is one second

Angles, in radians (for rotations over the x,y,z axis), where radians=(π/180)*degrees (and degrees=(180/π)*radians), as example for a full circunference of 360º degrees: radians=(3.14/180)*360=6.28 so... 360º degrees = 6.28 radians

• 

  PSP screen coordinates

• 

  PSP screen coordinates (RCOXML objects overlay)