Editing Resource Container (RCO)

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=
The file extension in PSP and PS3 is '''RCO''' that seems to be the acronym of '''R'''esource '''C'''ontainer '''O'''bject
The file extension in PSP and PS3 is '''RCO''' that seems to be the acronym of '''R'''esource '''C'''ontainer '''O'''bjet


The file signature (aka [https://en.wikipedia.org/wiki/Magic_number_(programming) magic number]) from PSP (in little endian) is '''PRF''' that seems to be the acronym of '''P'''laystation '''R'''esource '''F'''ile
The file signature (aka [https://en.wikipedia.org/wiki/Magic_number_(programming) magic number]) from PSP (in little endian) is '''PRF''' that seems to be the acronym of '''P'''laystation '''R'''esource '''F'''ile
Line 8: Line 8:
==Contents==
==Contents==
*RCO contents (See [[Multimedia Formats and Tools]]): <!--and see rcomage miscmap.ini for a list of the supported formats-->
*RCO contents (See [[Multimedia Formats and Tools]]): <!--and see rcomage miscmap.ini for a list of the supported formats-->
Text for all [[Template:PlayStation Languages|languages]], textures, sounds (for cursor navigation, trophy unlocking, etc...) and models
Text for all [[Template:XMB_languages|languages]], textures, sounds (for cursor navigation, trophy unlocking, etc...) and models


{| class="wikitable"
{| class="wikitable"
Line 26: Line 26:
! Toc trees !! Toc compression !! Other Notes
! Toc trees !! Toc compression !! Other Notes
|-
|-
! 0x55
| 0x55 || {{icon content psp|50px}} 0.6.5 || pre-retail || 9 || uncompressed || archaic rco format, header is 16 bytes smaller
| {{cellcolors|#cccccc}} {{icon content psp|50px}} 0.6.5 || pre-retail || 9 || none || archaic rco format, header is 16 bytes smaller
|-
|-
! 0x70
| 0x70 || {{icon content psp|50px}} 1.00 || 2004 / 12 / 12 || 10 || uncompressed ||  
| {{cellcolors|#cccccc}} {{icon content psp|50px}} 1.00 || 2004 / 12 / 12 || 10 || none ||  
|-
|-
! 0x71
| 0x71 || {{icon content psp|50px}} 1.50~2.50 || 2005 / 3 / 24 || 10 || uncompressed || normal toc up to this version
| {{cellcolors|#cccccc}} {{icon content psp|50px}} 1.50~2.50 || 2005 / 3 / 24 || 10 || none ||  
|-
|-
! 0x90
| 0x90 || {{icon content psp|50px}} 2.60 || 2005 / 11 / 29 || 10 || || zlib compressed toc implemented
| {{cellcolors|#cccccc}} {{icon content psp|50px}} 2.60 || 2005 / 11 / 29 || 10 || zlib ||  
|-
|-
! 0x93
| 0x95 || {{icon content psp|50px}} 2.70~2.71 || 2006 / 4 / 25 || 10 || || rlz compressed toc implemented
| {{cellcolors|#888888}} {{icon content ps3|50px}} <abbr title="pre-retail PS3 DECR firmware 0.82.006 probably same version for all 0.82 firmware series">0.82</abbr> || 2006 / 3 / 31 || 10 || none ||  
|-
|-
! 0x94
| 0x96 || {{icon content psp|50px}} 2.80~3.40 || 2006 / 7 / 27 || 10 || || the toc seems to be compressed in parts
| {{cellcolors|#888888}} {{icon content ps3|50px}} <abbr title="pre-retail PS3 DECR firmware 0.83.002 probably same version for all 0.83 firmware series">0.83</abbr> || 2006 / 4 / 19 || 10 || none ||  
|-
|-
! rowspan="2" | 0x95
| 0x97 || {{icon content ps3|50px}} 1.00~1.54 || 2006 / 11 / 11 || 10 || ||  
| {{cellcolors|#cccccc}} {{icon content psp|50px}} 2.70~2.71 || 2006 / 4 / 25 || 10 || rlz ||  
|-
|-
| {{cellcolors|#888888}} {{icon content ps3|50px}} <abbr title="pre-retail PS3 DECR firmware 0.84.001 probably same version for all 0.84 firmware series">0.84</abbr> || 2006 / 5 / 19 || 10 || none ||  
| 0x100 || {{icon content psp|50px}} 3.50~6.61 || 2007 / 5 / 31 || 10 || ||  
|-
|-
! 0x96
| 0x102 || {{icon content ps3|50px}} 1.60~1.70 || 2007 / 3 / 22 || 10 || ||  
| {{cellcolors|#cccccc}} {{icon content psp|50px}} 2.80~3.40 || 2006 / 7 / 27 || 10 || rlz ? || the toc seems to be compressed in parts
|-
|-
! 0x97
| 0x104 || {{icon content ps3|50px}} 1.80~1.82 || 2007 / 5 / 24 || 10 || ||  
| {{cellcolors|#888888}} {{icon content ps3|50px}} <abbr title="pre-retail PS3 DECR firmware 0.85.007 probably same version for all 0.85 firmware series">0.85</abbr>~[[1.54_CEX|1.54]] || 2006 / 11 / 11 || 10 || none ||  
|-
|-
! 0x100
| 0x105 || {{icon content ps3|50px}} 1.90~1.94 || 2007 / 7 / 24 || 10 || ||  
| {{cellcolors|#cccccc}} {{icon content psp|50px}} 3.50~6.61 || 2007 / 5 / 31 || 10 || rlz ? ||  
|-
|-
! 0x102
| 0x106 || {{icon content ps3|50px}} 2.00~2.17 || 2007 / 11 / 8 || 10 || ||  
| {{cellcolors|#888888}} {{icon content ps3|50px}} [[1.60_CEX|1.60]]~[[1.70_CEX|1.70]] || 2007 / 3 / 22 || 10 || ? ||  
|-
|-
! 0x104
| 0x107 || {{icon content ps3|50px}} 2.20~2.80 || 2008 / 3 / 25 || 10 || ||  
| {{cellcolors|#888888}} {{icon content ps3|50px}} [[1.80_CEX|1.80]]~[[1.82_CEX|1.82]] || 2007 / 5 / 24 || 10 || ? ||  
|-
|-
! 0x105
| 0x108 || {{icon content ps3|50px}} 3.00~3.01 || 2009 / 9 / 1 || 10 || ||  
| {{cellcolors|#888888}} {{icon content ps3|50px}} [[1.90_CEX|1.90]]~[[1.94_CEX|1.94]] || 2007 / 7 / 24 || 10 || zlib ||  
|-
|-
! 0x106
| 0x110 || {{icon content ps3|50px}} 3.10~3.74 || 2009 / 11 / 19 || 10 ||  ||  
| {{cellcolors|#888888}} {{icon content ps3|50px}} [[2.00_CEX|2.00]]~[[2.17_CEX|2.17]] || 2007 / 11 / 8 || 10 || zlib ||  
|-
|-
! 0x107
| 0x120 || {{icon content ps3|50px}} 4.00~4.25 || 2011 / 11 / 29 || 10 ||  ||  
| {{cellcolors|#888888}} {{icon content ps3|50px}} [[2.20_CEX|2.20]]~[[2.80_CEX|2.80]] || 2008 / 3 / 25 || 10 || zlib ||  
|-
|-
! 0x108
| 0x130 || {{icon content ps3|50px}} 4.30~4.76 || 2012 / 10 / 24 || 10 ||  ||  
| {{cellcolors|#888888}} {{icon content ps3|50px}} [[3.00_CEX|3.00]]~[[3.01_CEX|3.01]] || 2009 / 9 / 1 || 10 || zlib  ||
|-
! 0x110
| {{cellcolors|#888888}} {{icon content ps3|50px}} [[3.10_CEX|3.10]]~[[3.74_CEX|3.74]] || 2009 / 11 / 19 || 10 || zlib  ||
|-
! 0x120
| {{cellcolors|#888888}} {{icon content ps3|50px}} [[4.00_CEX|4.00]]~[[4.25_CEX|4.25]] || 2011 / 11 / 29 || 10 || zlib  ||
|-
! 0x130
| {{cellcolors|#888888}} {{icon content ps3|50px}} [[4.30_CEX|4.30]]~[[4.83_CEX|4.83]] || 2012 / 10 / 24 || 10 || zlib ||  
|}
|}


Line 100: Line 75:
| 0x08 || 0x04 || <abbr title="Always seems to be 0x00000000">00 00 00 00</abbr> || {{cellcolors|#ff7777}} <abbr title="prf_minor_version ?">''prf_unk''</abbr> ||  
| 0x08 || 0x04 || <abbr title="Always seems to be 0x00000000">00 00 00 00</abbr> || {{cellcolors|#ff7777}} <abbr title="prf_minor_version ?">''prf_unk''</abbr> ||  
|-{{cellcolors|#666666|#ffffff}}
|-{{cellcolors|#666666|#ffffff}}
| 0x0C || 0x04 || 00 00 00 00 || <abbr title="compress everything except the header and '''dat''' data tables to store files">'''prf_compress'''</abbr> || 0x00=none, 0x10=ZLIB, 0x20=RLZ, see {{talk}} page
| 0x0C || 0x04 || 00 00 00 00 || <abbr title="compress everything except the header and '''dat''' data tables to store files">'''prf_compress'''</abbr> || 0x00=uncompressed, 0x10=ZLIB, 0x20=RLZ, see {{talk}} page
|-{{cellcolors|#7777ff}}
|-{{cellcolors|#7777ff}}
| 0x10 || 0x04 || 00 00 00 A4 || '''toc_main_tree_offset''' ||  
| 0x10 || 0x04 || 00 00 00 A4 || '''toc_main_tree_offset''' ||  
Line 170: Line 145:
| 0x94 || 0x04 || 00 00 00 00 || '''dat_model_table_length''' ||  
| 0x94 || 0x04 || 00 00 00 00 || '''dat_model_table_length''' ||  
|-{{cellcolors|#ffddbb}}
|-{{cellcolors|#ffddbb}}
| 0x98 || 0x0C || <abbr title="Always seems to be 0xFFFFFFFF 0xFFFFFFFF 0xFFFFFFFF">FF FF FF FF .. .</abbr> || {{cellcolors|#ff7777}} ''dat_unk'' ||  
| 0x98 || 0x04 || <abbr title="Always seems to be 0xFFFFFFFF">FF FF FF FF</abbr> || {{cellcolors|#ff7777}} ''dat_unk_1'' ||
|-{{cellcolors|#ffddbb}}
| 0x9C || 0x04 || <abbr title="Always seems to be 0xFFFFFFFF">FF FF FF FF</abbr> || {{cellcolors|#ff7777}} ''dat_unk_2'' ||
|-{{cellcolors|#ffddbb}}
| 0xA0 || 0x04 || <abbr title="Always seems to be 0xFFFFFFFF">FF FF FF FF</abbr> || {{cellcolors|#ff7777}} ''dat_unk_3'' ||  
|}
|}


Line 176: Line 155:


==TOC==
==TOC==
The TOC (table of contents) works as an index of all the .RCO contents, is composed by entries that follows a hierarchy of parent/children/siblings, it can be represented as an .XML file composed by '''elements''' and its '''attributes''' (see [http://www.w3schools.com/xml/xml_tree.asp XML Tree] and  [[RCOXML Coding]])
The TOC (table of contents) works as an index of all the .RCO contents, is composed by entries that follows a hierarchy of parent/children/siblings, it can be represented as an .XML file composed by '''elements''' and its '''attributes''' (see [http://www.w3schools.com/xml/xml_tree.asp XML Tree])


===Element===
This .XML file that represents the RCO contents is also known as an [[RCOXML Coding|RCOXML]] and is the main file generated by [[rcomage]] when extracting the contents of a .RCO. Contains all the important info from the original .RCO file and some more info added by rcomage needed to rebuild the .RCO file accuratelly keeping the original settings
Every entry starts with an area of 0x28 length that represents an XML '''element''', it specifyes the '''entry_type''', a '''label''' identifyer for this entry (optional) and some info related with the TOC internal structure and its hierarchy relationship with other entries. All offset are relative
 
Every entry starts with an area of 0x28 length that represents an XML '''element''', it specifyes the '''entry_type''', a '''label''' identifyer for this entry (optional) and some info related with the TOC internal structure and its hierarchy relationship with other entries


{| class="wikitable" style="font-size:small;"
{| class="wikitable" style="font-size:small;"
Line 189: Line 169:
|}
|}


===Attributes===
After the common area (at entry relative offset 0x28) appears the '''attributes''', the attributes are different for every '''entry_type''' and are explained in detail in other wiki pages, see the links in the table below
Attributes are located after the element definition (at entry relative offset 0x28), only exists for the elements that uses attributes, each '''entry_type''' uses different attributes, are explained in detail in other wiki pages
 
The entry_types wich name contains the word '''tree''' (as example MainTree) are special and doesnt uses attributes, MainTree is always located as the first entry, doesn't have a parent, and doesn't have any previous or next "sibling", the maximun number posible of childrens for MainTree is 8 (containing all the other "trees")<!--actually it should be 9 trees max because the toc_unknown area at absolute offset 0x28 in the header is telling it exists another unknown tree-->. The other "trees" (as example imageTree or soundTree) are siblings and are the childrens of "MainTree", Every one of those "trees" contains a variable number of '''entry_types''' that are its childrens
 
An special mention is needed to the [[RCOXML Objects]] (entry_types starting with 0x08) and [[RCOXML Animations]] (entry_types starting with 0x09) where the attributes can be grouped in standard attributes (used by most entryes of this type) and specific attributes (different for every entry_type). The standard attributes are always located before the specific attributes
{{RCO TOC entry types}}
{{RCO TOC entry types}}


Some of the attributes are a '''reference''' to load other entry
Some of the attributes are a '''reference''' to load other entry, are composed by two values, the first is the '''reference_type''' that indicates the "tree" of the entry that is going to be loaded, and the second is a '''pointer''' to a text string with the '''label''' of the entry that is going to be loaded. The reference_type '''event''' doesnt loads an entry from a "tree" though, it runs a code function from either a .sprx (by storing the text '''native:/''' as part of the text string inside the RCO) or from a [[VSMX]] script (by storing the text '''script:/''' as part of the text string inside the RCO)
{{RCO TOC reference types}}
{{RCO TOC reference types}}


===Example===
{{Boxframe1|content='''example placeholder'''
{{Boxframe1|content='''example placeholder'''
*Example here following the other example of the header at top of the page, using color codes like the examples in {{talk}} page
*Example here following the other example of the header at top of the page, using color codes like the examples in {{talk}} page
Line 202: Line 184:
*And '''MainTree-ObjectTree-Page''' (because the animation needs to be linked to an object by using a reference, otherway rcomage will return an error when trying to compile it)
*And '''MainTree-ObjectTree-Page''' (because the animation needs to be linked to an object by using a reference, otherway rcomage will return an error when trying to compile it)
}}
}}
*All offsets in the TOC are relative
==String tables==
This area stores the text strings used by the TOC entries, is composed by 3 tables in this order:
*'''text_string_table''' (to store localized language texts from TextTree entries)
*'''label_string_table''' (to store the labels of all the entries that uses labels)
*'''event_string_table''' (to store the values of the attributes used by some entries, either "native" or "script" events)
*Strings are null terminated (ends in 0x00)
*Strings are aligned to 4 bytes boundary (padding at the end of every string when needed)


==Pointer tables==
==Pointer tables==
Line 215: Line 208:
*Every pointer is 0x04 bytes length
*Every pointer is 0x04 bytes length
*The other "trees" children that doesnt uses a pointer table are: MainTree (is not needed because its children are the other "trees"), ScriptTree (because doesnt have children), and FontTree because ?????<!--i cant imagine why but there must be a good reason-->
*The other "trees" children that doesnt uses a pointer table are: MainTree (is not needed because its children are the other "trees"), ScriptTree (because doesnt have children), and FontTree because ?????<!--i cant imagine why but there must be a good reason-->
*The existence of this area with pointers seems to be related with the fact that is posible to use a whole file compression (by setting it in the header at offset 0x0C) that compresses the TOC. Also when loading the .RCO file in the RAM of the console probably is "cropped" in parts, the TOC is decompresed and kept in a memory area with the other TOC's from the other RCO files (for fast selective access to the .RCO contents, and for performance) and is posible to read the relative offsets directlly from the TOC's and deprecate the absolute offsets from the pointers tables<!--or something like that, if someone can explain it please help rewriting this-->
*The existence of this area with pointers seems to be related with the fact that is posible to use a whole file compression (by setting it in the header at offset 0x0C) that compresses the TOC. Also when loading the .RCO file in the RAM of the console probably is "cropped" in parts and the TOC is kept in a memory area with all the other RCO files and is posible to read the relative offsets directlly from the TOC and deprecate the absolute offsets from the pointers tables<!--or something like that, if someone can explain it please help rewriting this-->
 
==String tables==
This area stores the text strings used by the TOC entries, is composed by 3 tables in this order:
*'''text_string_table''' (to store localized language texts from TextTree entries)
*'''label_string_table''' (to store the labels of all the entries that uses labels)
*'''event_string_table''' (to store the values of the attributes used by some entries, either "native" or "script" events)
 
 
*Strings are null terminated (ends in 0x00)
*Strings are aligned to 4 bytes boundary (padding at the end of every string when needed)


==Data tables==
==Data tables==
Line 251: Line 234:
|}
|}


=VSH access to RCO contents=
See the [[VSH_Exports#paf "paf" VSH exports]], most of them uses the internal "official" names of lot of stuff related with RCO (i guess there are a lot of names used in this wiki that was taken from rcomage or by deduction that should be replaced by the official names), and can help to understand how the firmware processes and accesses to the internal content of .RCO files (it can help a lot to any tool involved in processing .RCO files to make it most efficient, simple and accurate posible)
*Related with the internal RCO [http://www.w3schools.com/xml/dom_intro.asp | XML DOM structure]
**PAF_Resource_DOMGetNodeChildByID, PAF_Resource_DOMGetNodeChildByPos, PAF_Resource_DOMGetNodeData, PAF_Resource_DOMGetNodeFirstChild, PAF_Resource_DOMGetNodeID, PAF_Resource_DOMGetNodeNext, PAF_Resource_DOMGetNodeType, PAF_Resource_GetPageNodeByID, PAF_Resource_GetWidgetNodeByID, PAF_Resource_ResolveRefNode, PAF_Resource_ResolveRefString, PAF_Resource_ResolveRefWString (It seems some are missing though)
*Related with [[RCOXML Objects]]
**This seems to be the complete list of [[RCOXML Objects]] internal names (It seems some are missing though)
***0x546B3D02 returns "PhWidget", 0x41BBFE5E returns "PhScene", 0x10DEDCC7 returns "PhPlane", 0xE36C18F5 returns "PhPlaneDiv", 0x24A5BD6B returns "PhButton", 0xB7DFCE90 returns "PhText", 0x9207F4 returns "PhScroll", 0xBA6D149A returns "PhLabelPrim", 0xC88CA4B2 returns "PhLevelMeter", 0xE801C345 returns "PhProgress", 0xBF66BF2D returns "PhCheckBox", 0x703117AD returns "PhXmBar", 0x4FF7B8A9 returns "PhXmList", 0xC84FD77B returns "PhXmItem", 0x4C36ABBB returns "PhItemSpin", 0xCA9160F6 returns "PhNumSpin", 0x59A11C82 returns "PhNumSpin", 0xD64EDE7C returns "PhList", 0xF7630798 returns "PhInfoList", 0xA98865F8 returns "PhMenuList", 0x90F4F801 returns "PhCheckBoxList", 0xDDD4ACF6 returns "PhLabelText", 0x545D47A2 returns "PhClock", 0x3806365F returns "PhIPAddr"
**The names of the attributes ordered by groups (there are a lot)
***As example: 0xDEF981C4 _ZN3paf8PhXmList7FocusInEf, 0x814B3D90 _ZN3paf8PhXmList8FocusOutEf this two seems to be the attributes '''FocusOut''' and '''FocusIn''' from the object '''XmList'''


{{File Formats}}
{{File Formats}}
<noinclude>[[Category:Main]]</noinclude>
<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)