Resource Container (RCO)
Description
Resource Container Objet (RCO) contents are loaded by XMB modules (also known as .sprx plugins), see Plugin Interfaces and VSH
- Compression types availables:
- ZLIB
- RLZ
- Uncompressed
Contents
- RCO contents (See Multimedia Formats and Tools):
Text for all languages, textures, sounds (for cursor navigation, trophy unlocking, etc...) and models
| RCO format | Embedded code | Text | Textures | Sounds | Models | Script |
|---|---|---|---|---|---|---|
| Generic | RCOXML | utf8, utf16, utf32 | gim, png, jpg, tif, gif, bmp | vag, unknown0x0 | gmo | PlayStation JavaScript |
| PS3 specific | RCOXML | utf16 | gim, png, jpg | vag | n/a | n/a |
Versions
| RCO version | Firmware | Release date | Notes |
|---|---|---|---|
| 0x55 |  0.6.5 |
pre-retail | archaic rco format, header is 12 bytes smaller |
| 0x70 | 1.00 |
2004 / 12 / 12 | |
| 0x71 | 1.50~2.50 |
2005 / 3 / 24 | normal table section up to this version |
| 0x90 | 2.60 |
2005 / 11 / 29 | zlib compressed table section implemented |
| 0x95 | 2.70~2.71 |
2006 / 4 / 25 | rlz compressed table section implemented |
| 0x96 | 2.80~3.40 |
2006 / 7 / 27 | |
| 0x97 |  1.00~1.54 |
2006 / 11 / 11 | |
| 0x100 | 3.50~6.61 |
2007 / 5 / 31 | |
| 0x102 | 1.60~1.70 |
2007 / 3 / 22 | |
| 0x104 | 1.80~1.82 |
2007 / 5 / 24 | |
| 0x105 | 1.90~1.94 |
2007 / 7 / 24 | |
| 0x106 | 2.00~2.17 |
2007 / 11 / 8 | |
| 0x107 | 2.20~2.80 |
2008 / 3 / 25 | |
| 0x108 | 3.00~3.01 |
2009 / 9 / 1 | |
| 0x110 | 3.10~3.74 |
2009 / 11 / 19 | |
| 0x120 | 4.00~4.25 |
2011 / 11 / 29 | |
| 0x130 | 4.30~4.76 |
2012 / 10 / 24 |
RCO Structure
The container structure can be represented as an XML (see RCOXML), with rcomage is posible to generate this XML when extracting, and for rebuilding the rco using the XML as a layout
http://endlessparadigm.com/forum/showthread.php?tid=231 (outdated)
Header
| Offset | Length | Name | Example | Notes |
|---|---|---|---|---|
| 0x00 | 0x04 | magic | FRP | In PS3 is "FRP" (big endian). In PSP is "PRF" (little endian) |
| 0x04 | 0x04 | version | 00 00 01 30 | named minFirmwareVer in rcomage, see Discussion page |
| 0x08 | 0x04 | unknown | 00 00 00 00 | |
| 0x0C | 0x04 | compress_header | 00 00 00 00 | *0x00 no compress *0x10 zlib *0x20 rlz ? |
| 0x10 | 0x04 | info_table_offset | 00 00 00 A4 | usually 0xA4 |
| 0x14 | 0x04 | vsmx_table_offset | ||
| 0x18 | 0x04 | text_table_offset | ||
| 0x1C | 0x04 | sound_table_offset | ||
| 0x20 | 0x04 | model_table_offset | ||
| 0x24 | 0x04 | image_table_offset | ||
| 0x28 | 0x04 | unknown | FF FF FF FF | Always seems to be 0xFFFFFF |
| 0x2C | 0x04 | font_table_offset | ||
| 0x30 | 0x04 | page_table_offset | ||
| 0x34 | 0x04 | anim_table_offset |
| Offset | Length | Name | Example | Notes |
|---|---|---|---|---|
| 0x38 | 0x04 | text_table_offset | ||
| 0x3C | 0x04 | text_table_length | ||
| 0x40 | 0x04 | label_table_offset | ||
| 0x44 | 0x04 | label_table_length | ||
| 0x48 | 0x04 | native_table_offset | ||
| 0x4C | 0x04 | native_table_length |
| Offset | Length | Name | Example | Notes |
|---|---|---|---|---|
| 0x50 | 0x04 | text_pointer_table_offset | ||
| 0x54 | 0x04 | text_pointer_table_length | ||
| 0x58 | 0x04 | image_pointer_table_offset | ||
| 0x5C | 0x04 | image_pointer_table_length | ||
| 0x60 | 0x04 | model_pointer_table_offset | ||
| 0x64 | 0x04 | model_pointer_table_length | ||
| 0x68 | 0x04 | sound_pointer_table_offset | ||
| 0x6C | 0x04 | sound_pointer_table_length | ||
| 0x70 | 0x04 | page_pointer_table_offset | ||
| 0x74 | 0x04 | page_pointer_table_length | ||
| 0x78 | 0x04 | anim_pointer_table_offset | ||
| 0x7C | 0x04 | anim_pointer_table_length |
| Offset | Length | Name | Example | Notes |
|---|---|---|---|---|
| 0x80 | 0x04 | image_data_section_offset | ||
| 0x84 | 0x04 | image_data_section_length | ||
| 0x88 | 0x04 | sound_data_section_offset | ||
| 0x8C | 0x04 | sound_data_section_length | ||
| 0x90 | 0x04 | model_data_section_offset | ||
| 0x94 | 0x04 | model_data_section_length | ||
| 0x98 | 0x04 | unknown | Always seems to be 0xFFFFFF | |
| 0x9C | 0x04 | unknown | Always seems to be 0xFFFFFF | |
| 0xA0 | 0x04 | unknown | Always seems to be 0xFFFFFF |
info/main/xml table
This area works as an index of all the .rco contents, when the area is compressed there are 12 bytes at the beggining with info about this compression, aftr it starts the info, is composed by entries that follows a hierarchy of parent/children/brother and every entry defines an element wich can have several attributes. All this info can be represented as an xml file (this is what rcomage names an RCOXML)
When the table is compressed at beggining there are 3 values related with the compression (otherway if the table is not compressed this 3 values doesnt exists)
| Offset | Length | Name | Example | Notes |
|---|---|---|---|---|
| 0x00 | 0x04 | lenPacked | Packed size of all the table sections | |
| 0x04 | 0x04 | lenUnpacked | Unpacked size of all the table sections | |
| 0x08 | 0x04 | lenLongestText | length of the longest language's text data (unpacked) |
And then it starts with the entries, every entry has an area at begining that is common, in it is specifyed the entry_type, the values that comes after this area are dependant of the entry type
| Offset | Length | Name | Example | Notes |
|---|---|---|---|---|
| 0x00 | 0x01 | hierarchy_depth ? | main table uses 0x01, may be used as a current entry depth value | |
| 0x01 | 0x01 | entry_type | *0x1=MainTree *0x2=ScriptTree *0x3=TextTree *0x4=ImageTree *0x5=ModelTree *0x6=SoundTree *0x7=FontTree *0x8=ObjectTree *0x9=AnimTree | |
| 0x02 | 0x02 | unknown | Always seems to be 0x0000 | |
| 0x04 | 0x04 | entry_label_offset | Offset to the label (relative to the label table). 0xFFFFFFFF means the label doesn't exist for this entry | |
| 0x08 | 0x04 | entry_header_size | sizeof(RCOEntry) = 0x28 [ only used for entries with extra info (ie not "main" entries) ] | |
| 0x0C | 0x04 | entry_size | main tables (main/img etc) uses 0x28 here, or is this the length of current entry (not including subentries)? | |
| 0x10 | 0x04 | children_number | ||
| 0x14 | 0x04 | next_entry_offset | ||
| 0x18 | 0x04 | previous_entry_offset | ||
| 0x1C | 0x04 | parent_offset | ||
| 0x20 | 0x04 | unknown | ||
| 0x24 | 0x04 | unknown |
After the common area it starts with the info specific for the entry_type, in wiki this has been separated in different pages...
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
