RCOXML Coding

From PS3 Developer wiki
Revision as of 08:25, 3 September 2016 by Sandungas (talk | contribs) (→‎RCOXML Contents (PS3): moved to {{Template:RCOXML contents PS3}})
Jump to navigation Jump to search

Description

RCOXML files are the XML descriptors embedded inside Resource Container (RCO) files

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

ImageTree

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

TextTree

ModelTree

None of the PS3 rco's uses a ModelTree

SoundTree

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

AnimTree

RCOXML Contents PS3

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