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
|-
| 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 {{talk}} page
|-
| 0x08 || 0x04 || ''unknown'' || 00 00 00 00 || 
|-
| 0x0C || 0x04 || '''compress_header''' || 00 00 00 00 || *0x00 no compress<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 0xFFFFFF
|-
| 0x2C || 0x04 || '''font_table_offset''' ||  || 
|-
| 0x30 || 0x04 || '''page_table_offset''' ||  || 
|-
| 0x34 || 0x04 || '''anim_table_offset''' ||  || 
|}

{| class="wikitable"
|+strings
! 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''' ||  || 
|}

{| class="wikitable"
|+pointers
! 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''' ||  || 
|}

{| class="wikitable"
|+files
! 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)
{| class="wikitable"
|-
! 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
{| class="wikitable"
|-
! 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<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''' ||  || 
|-
| 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...



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