RCOXML Texts

From PS3 Developer wiki
Jump to navigation Jump to search

Description

The texts inside .rco files are indexed in the embedded RCOXML code of the .rco container under the XML element TextTree. See Resource Container (RCO) and RCOXML Coding

All the texts inside .rco has a localized file for every one of the languages supported by XMB. The localized file contains all the translated text strings

Text

"TextTree" could be renamed to LanguageTree, is more intuitive, the point is every entry here is the "parent" of several string texts, but the entry itself is not a text (is the parent of a group of texts), so is better to use a name more abstract like "LanguageTree"

For a Language first are specified the language_id and the number of "children" text strings

Offset Length Name Example Notes
0x00 0x02 language_id 0x00=Japanese
0x01=English (United States)
0x02=French
0x03=Spanish (Spain)
0x04=German
0x05=Italian
0x06=Dutch
0x07=Portuguese (Portugal)
0x08=Russian
0x09=Korean
0x0A=Chinese (Traditional)
0x0B=Chinese (Simplified)
0x0C=Finnish
0x0D=Swedish
0x0E=Danish
0x0F=Norwegian
0x10=Polish
0x11=Portuguese (Brazil)
0x12=English (United Kingdom)
0x13=Turkish
0x02 0x02 character_encoding Works as a replacement of the BOM
0x00=UTF8
0x01=UTF16
0x02=UTF32
0x04 0x04 strings_number number of text strings for this language_id

Now for every strings_number are repeated 12 bytes to define every string that are references to other tables

Offset Length Name Example Notes
0x00 0x04 label_offset Offset to label, relative of the label table
0x04 0x04 string_length Length of the text
0x08 0x04 string_offset Offset of the text, relative to the text data start address

Language Modifications

All modifications made to the <language>.xml files extracted from RCO's with rcomage belongs to this category

How to add custom texts

Rebug package manager example goes here

Photosensitive epilepsy text removal/replacement

Epilepsy Warning screen

Text is located in all <language.xml> files inside sysconf_plugin.rco

It can be blanked (replaced by nothing), or replaced by any other custom text and ASCII art

<?xml version="1.0" encoding="utf-8"?>
<!-- This XML was generated by Rcomage v1.1.2 -->
<TextLang>
	.
	..
	...
	<Text name="msg_health_warning_start_scee">PHOTOSENSITIVE EPILEPSY
IF YOU HAVE A HISTORY OF EPILEPSY OR SEIZURES, CONSULT A DOCTOR BEFORE USE. CERTAIN PATTERNS MAY TRIGGER SEIZURES WITH NO PRIOR HISTORY. BEFORE USING THIS PRODUCT, CAREFULLY READ THE INSTRUCTION MANUAL.</Text>
	...
	..
	.
</TextLang>

Adding custom language packs

  • PS3MFW_Builder::PSheb_project. Info about the PSheb project needs to be improved, splitted and moved to several wiki pages:
    • Info about .xml modifications moved to Languages page
    • Info about .tcl "language pack" task stays in PS3MFW Builder page
    • Info about replacing or adding characters/glyphs in the official .ttf fonts moved to XMB Fonts page

etc...