Editing Resource Container (RCO)

=Description=
'''R'''esource '''Co'''ntainer '''O'''bjet (RCO) contents are loaded by [[XMB]] modules (also known as .sprx plugins), see [[Plugin Interfaces]] and [[VSH]]

*Compression types availables:
**[[Template:Zlib_Header|ZLIB]]
**RLZ
**Uncompressed

=Contents=
*RCO contents (See [[Multimedia Formats and Tools]]): <!--and see rcomage miscmap.ini for a list of the supported formats-->
Text for all [[Template:XMB_languages|languages]], textures, sounds (for cursor navigation, trophy unlocking, etc...) and models

{| class="wikitable"
|-
! RCO format !! Embedded code !! Text !! Textures !! Sounds !! Models !! Script
|-
| Generic || [[RCOXML Coding|RCOXML]] || utf8, utf16, utf32 || gim, png, jpg, tif, gif, bmp || vag, unknown0x0 || gmo || [[PlayStation JavaScript]]
|-
| PS3 specific || [[RCOXML Coding|RCOXML]] || utf16 || gim, png, jpg || vag || {{cellcolors|lightgrey}} ''n/a'' || {{cellcolors|lightgrey}} ''n/a''
|}

=Versions=
{| class="wikitable"
|-
! <abbr title="based in the changelog of custom_render_plugin.rco PS3, and rcomage source code">RCO version</abbr> !! Firmware !! <abbr title="release date of the first firmware using that rco version in format YYYY/MM/DD">Release date</abbr> !! Notes
|-
| 0x55 || {{icon content psp}} 0.6.5 || pre-retail || archaic rco format, header is 12 bytes smaller
|-
| 0x70 || {{icon content psp}} 1.00 || 2004 / 12 / 12 || 
|-
| 0x71 || {{icon content psp}} 1.50~2.50 || 2005 / 3 / 24 || normal table section up to this version
|-
| 0x90 || {{icon content psp}} 2.60 || 2005 / 11 / 29 || zlib compressed table section implemented
|-
| 0x95 || {{icon content psp}} 2.70~2.71 || 2006 / 4 / 25 || rlz compressed table section implemented
|-
| 0x96 || {{icon content psp}} 2.80~3.40 || 2006 / 7 / 27 || 
|-
| 0x97 || {{icon content ps3}} 1.00~1.54 || 2006 / 11 / 11 || 
|-
| 0x100 || {{icon content psp}} 3.50~6.61 || 2007 / 5 / 31 || 
|-
| 0x102 || {{icon content ps3}} 1.60~1.70 || 2007 / 3 / 22 || 
|-
| 0x104 || {{icon content ps3}} 1.80~1.82 || 2007 / 5 / 24 || 
|-
| 0x105 || {{icon content ps3}} 1.90~1.94 || 2007 / 7 / 24 || 
|-
| 0x106 || {{icon content ps3}} 2.00~2.17 || 2007 / 11 / 8 || 
|-
| 0x107 || {{icon content ps3}} 2.20~2.80 || 2008 / 3 / 25 || 
|-
| 0x108 || {{icon content ps3}} 3.00~3.01 || 2009 / 9 / 1 || 
|-
| 0x110 || {{icon content ps3}} 3.10~3.74 || 2009 / 11 / 19 || 
|-
| 0x120 || {{icon content ps3}} 4.00~4.25 || 2011 / 11 / 29 || 
|-
| 0x130 || {{icon content ps3}} 4.30~4.76 || 2012 / 10 / 24 || 
|}

=RCO Structure=
The container structure can be represented as an XML (see [[RCOXML Coding|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==
{| class="wikitable"
|-
! Offset !! Length !! Name !! Example !! Notes !! Speculation
|-
| 0x00 || 0x04 || '''magic''' || FRP || In PS3 is "FRP" (big endian). In PSP is "PRF" (little endian). '''P'''laystation '''R'''esource '''F'''ile || 
|-
| 0x04 || 0x04 || '''version''' || 00 00 01 30 || named ''minFirmwareVer'' in [[Rcomage]], see {{talk}} page || 
|-
| 0x08 || 0x04 || ''unknown'' || 00 00 00 00 || Always seems to be 0x00000000 || 
|-
| 0x0C || 0x04 || '''compress_header''' || 00 00 00 00 || *0x00=uncompressed<br>*0x10=ZLIB<br>*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 0xFFFFFFFF || ''unknown_table_offset'' ?
|-
| 0x2C || 0x04 || '''font_table_offset''' ||  ||  || 
|-
| 0x30 || 0x04 || '''object_table_offset''' ||  ||  || 
|-
| 0x34 || 0x04 || '''anim_table_offset''' ||  ||  || 
|}

{| class="wikitable"
|+strings
! Offset !! Length !! Name !! Example !! Notes !! Speculation
|-
| 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''' ||  ||  || 
|}

{| class="wikitable"
|+pointers
! Offset !! Length !! Name !! Example !! Notes !! Speculation
|-
| 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 || '''object_pointer_table_offset''' ||  ||  || 
|-
| 0x74 || 0x04 || '''object_pointer_table_length''' ||  ||  || 
|-
| 0x78 || 0x04 || '''anim_pointer_table_offset''' ||  ||  || 
|-
| 0x7C || 0x04 || '''anim_pointer_table_length''' ||  ||  || 
|}

{| class="wikitable"
|+files
! Offset !! Length !! Name !! Example !! Notes !! Speculation
|-
| 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 0xFFFFFFFF || ''unknown_data_section_offset'' ?
|-
| 0x9C || 0x04 || ''unknown'' ||  || Always seems to be 0xFFFFFFFF || ''unknown_data_section_length'' ?
|-
| 0xA0 || 0x04 || ''unknown'' ||  || Always seems to be 0xFFFFFFFF || 
|}

==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 beginning with info about this compression, after it starts the info composed by entries that follows a hierarchy of parent/children/brother, every entry defines an element with its attributes. All this info can be represented as an xml file (this is what rcomage names an [[RCOXML Structure|RCOXML]])

===Compression methods===
<!--initially was not compressed, and what is explained here seems to be obsolete, later it was compressed in sections, i guess in separated groups for each "tree" represented in the rcoxml the purpose of this is for the console to access one "tree" of the hierarchy independlly without the need to decompress the whole table, for performance-->

When the table is compressed at beginning there are 3 values related with the compression (otherway if the table is not compressed this 3 values doesnt exists)
{| class="wikitable"
|-
! Offset !! Length !! Name !! Example !! Notes !! Speculation
|-
| 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) || 
|}

===Entry common area===
And then it starts with the entries, every entry has an area at beginning that is common, in it is specifyed the '''entry_type''', the values that comes after this area are dependant of the '''entry_type'''
{| class="wikitable"
|-
! Offset !! Length !! Name !! Example !! Notes !! Speculation
|-
| 0x00 || 0x01 || '''hierarchy_depth''' ||  || main table uses 0x01, may be used as a current entry depth value || 
|-
| 0x01 || 0x01 || '''entry_type''' ||  || *0x1=MainTree<br>*0x2=ScriptTree<br>*0x3=TextTree<br>*0x4=ImageTree<br>*0x5=ModelTree<br>*0x6=SoundTree<br>*0x7=FontTree<br>*0x8=ObjectTree<br>*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''' ||  ||  || ''next_brother_offset'' ?
|-
| 0x18 || 0x04 || '''previous_entry_offset''' ||  || this is usually 0x0 however (does make writing RCOs easier though :P I guess Sony's tools do something similar...) || ''previous_brother_offset'' ?
|-
| 0x1C || 0x04 || '''parent_offset''' ||  || offset of this entry from parent table 0x20 || 
|-
| 0x20 || 0x04 || ''unknown'' ||  || Always seems to be 0x00000000 || 
|-
| 0x24 || 0x04 || ''unknown'' ||  || Always seems to be 0x00000000 || 
|}
After the area common for all entries it starts the info specific for the '''entry_type''' explained below

===Entry type 0x1 (MainTree)===
Main tree doesnt uses specific specific attributes, only uses the default ones explained above that indicates his position at top of the xml hierarchy and gives it a "label" name

===Entry type 0x2 (ScriptTree)===
===Entry type 0x3 (TextTree)===
===Entry type 0x4 (ImageTree)===
===Entry type 0x5 (ModelTree)===
===Entry type 0x6 (SoundTree)===
===Entry type 0x7 (FontTree)===
===Entry type 0x8 (ObjectTree)===
===Entry type 0x9 (AnimTree)===

{{File Formats}}
<noinclude>[[Category:Main]]</noinclude>