Editing Qt Resource Container (QRC)

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 ==
[[Category:Software]]
QRC files ('''Q'''t '''R'''esources '''C'''ontainer) are located inside a QGL folder ('''Q'''t '''G'''raphics '''L'''ibrary) in path: '''dev_flash/vsh/resource/qgl''' with names: [[canyon.qrc]], [[earth.qrc]], [[icons.qrc]], [[icontex.qrc]], [[lines.qrc]], [[raf.qrc]], [[rhm.qrc]], and [[store.qrc]]. The contents of QRC files are compatible/generated with/by: [http://en.wikipedia.org/wiki/Qt_%28framework%29 Qt framework] and [http://en.wikipedia.org/wiki/OpenGL OpenGL]
location: /dev_flash/vsh/resource/qgl


The internal structure of QRC files can be clasifyed as one of the variants of a group of containers named: [[CXML Containers]]
== General format ==
QGL ('''Q'''t '''G'''raphics '''L'''ibrary) based in [http://en.wikipedia.org/wiki/Qt_%28framework%29 Qt framework] and [http://en.wikipedia.org/wiki/OpenGL OpenGL]


*QRC related firmware modules in '''dev_flashvsh/modules/''':
=== QRCC ===
**qglbase.sprx <--- generic
QRCC ('''Q'''t '''R'''esources '''C'''ontainer '''C'''ompressed)
**qgl_gaia_app.sprx <--- earth animation inside music player
**qgl_canyon_app.sprx <--- abstract animation inside music player
**custom_render_plugin.sprx


*Other stuff related with QRC:
QRC file ZLIB Compressed level 9.
**http://blog.us.playstation.com/2009/09/04/q-games-update-star-dust-dynamic-themes-our-favorite-little-tikiman/
**ps3 standalone visualizer app released by "Q games" (responsibles of XMB design): http://blog.us.playstation.com/2013/08/08/new-ps3-visualizer-app-from-q-games-out-tuesday/ and http://www.ps3hax.net/2013/08/q-games-releases-new-visualizer-music-app-for-ps3-high/


== QRC containers ==
*Example from 3.55 rhm.qrc:
'''Offset(h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F'''
'''00000000'''  <span style="background:#ff6666;">51 52 43 43</span> <span style="background:#6666ff;">00 00 28 00</span>                          QRCC..z`


=== icons.qrc & icontex.qrc ===
{| class="wikitable sortable"
*See: [[icons.qrc]] and [[icontex.qrc]] pages
|-
{{icons.qrc}}
| style="background-color:#515243; color:#FFFFFF;" |'''Name'''
{{icontex.qrc}}
| style="background-color:#515243; color:#FFFFFF;" |'''Offset'''
| style="background-color:#515243; color:#FFFFFF;" |'''Size'''
| style="background-color:#515243; color:#FFFFFF;" |'''Example'''
| style="background-color:#515243; color:#FFFFFF;" |'''Remark'''
|-
| <span style="background:#ff6666;">Magic header || 0x00 || 0x04 || 51 52 43 43 || 'QRCC'
|-
| <span style="background:#6666ff;">size of ZLIB unpacked (QRCF) file                      || 0x04 || 0x04 || 00 00 28 00
|}


=== lines.qrc ===
=== QRCF ===
*See: [[lines.qrc]] page
QRCF ('''Q'''t '''R'''esources '''C'''ontainer '''F'''?)
{{lines.qrc}}


=== rhm.qrc & raf.qrc ===
QRC "container" with an structure similar than themes .p3t
*See: [[rhm.qrc]] and [[raf.qrc]] pages
{{rhm.qrc}}
{{raf.qrc}}


=== canyon.qrc & earth.qrc ===
====Main Header====
*See: [[canyon.qrc]] and [[earth.qrc]] pages
*Example from fw 3.55 rhm.qrc:
*Music player visualizers (a.k.a. 'valley' and 'gaia'), the other music player visualizer available is a modification of the [[XMB]] wave/sparks animation, and is stored inside [[lines.qrc]] using specific .MNU settings in path: '''override/music_1/''')
'''Offset(h) 00 01 02 03  04 05 06 07  08 09 0A 0B  0C 0D 0E 0F'''
{{canyon.qrc}}
'''00000000'''  <span style="background:#ff6666;">51 52 43 46  00 00 01 10  00 00 00 40  00 00 02 CC</span>  QRCF.......@..%|
{{earth.qrc}}
'''00000010''' <span style="background:#66ff66;">00 00 03 10  00 00 01 2B</span>  <span style="background:#ffff66;">00 00 04 40  00 00 00 1B</span>  ..%À......9Ð....
'''00000020''' <span style="background:#ffff66;">00 00 04 60</span>  00 00 00 00  <span style="background:#ffff66;">00 00 04 60</span>  00 00 00 00  ..9ð......9ð....
'''00000030''' <span style="background:#ffff66;">00 00 04 60  00 00 23 A0</span>  00 00 00 00  00 00 00 00..9ð..@p........


=== store.qrc ===
{| class="wikitable sortable"
*See: [[store.qrc]] page
|-
{{store.qrc}}
| style="background-color:#515243; color:#FFFFFF;" |'''Name'''
| style="background-color:#515243; color:#FFFFFF;" |'''Offset'''
| style="background-color:#515243; color:#FFFFFF;" |'''Size'''
| style="background-color:#515243; color:#FFFFFF;" |'''Example'''
| style="background-color:#515243; color:#FFFFFF;" |'''Remark'''
|-
| <span style="background:#ff6666;">Magic || 0x00 || 0x04 || 51 52 43 46 || 'QRCF'
|-
| <span style="background:#ff6666;">Version                      || 0x04 || 0x04 || 00 00 01 10 ||
|-
| <span style="background:#ff6666;">Data table start offset                  || 0x08 || 0x04 || 00 00 00 40 ||
|-
| <span style="background:#ff6666;">Data table size        || 0x0C || 0x04 || 00 00 02 CC ||
|-
| <span style="background:#66ff66;">Filename table start offset            || 0x10 || 0x04 || 00 00 03 10 ||
|-
| <span style="background:#66ff66;">Filename table size              || 0x14 || 0x04 || 00 00 01 2B || without the padding at the end
|-
| <span style="background:#ffff66;">File table header start offset || 0x18 || 0x04 || 00 00 04 40 ||
|-
| <span style="background:#ffff66;">File table header size  || 0x1C || 0x04 || 00 00 00 1B || without the padding at the end
|-
| <span style="background:#ffff66;">File table start offset      || 0x20 || 0x04 || 00 00 04 60 ||
|-
| ''Not used''                    || 0x24 || 0x04 || 00 00 00 00 ||
|-
| <span style="background:#ffff66;">File table start offset        || 0x28 || 0x04 || 00 00 04 60 ||
|-
| ''Not used''                    || 0x2C || 0x04 || 00 00 00 00 ||
|-
| <span style="background:#ffff66;">File table start offset        || 0x30 || 0x04 || 00 00 04 60 ||
|-
| <span style="background:#ffff66;">File table size          || 0x34 || 0x04 || 00 00 23 A0 ||
|-
| ''Not used''                    || 0x38 || 0x04 || 00 00 00 00 ||
|-
| ''Not used''                    || 0x3C || 0x04 || 00 00 00 00 ||
|-
|}


== QRC contents ==
====Data Table====
See [[Multimedia Formats and Tools]] page for a general description of DDS, GTF, BMP, TGA, FPO, VPO and JPEG image formats)
Default entry size is 60 bytes (0x3C) but the first and last entries has a different size


*ELF (Executable and Linkable Format) See Specifications here: [http://www.sco.com/developers/gabi/latest/ch4.eheader.html ELF Header] and [http://www.openwatcom.com/ftp/devel/docs/elf-64-gen.pdf ELF-64 Object File Format]
Offset (without the 0x40 header in all qrc files)
*BIN (Binary)
http://666kb.com/i/cib5c7q4y7rpcx9x1.gif
*MNU ?
*PATH (Camera path)
*DUMP ?
*TXT ?
*INI ?
*DDS (Direct Draw Surface)
*GTF (Graphics Texture Format)
*BMP (Bitmap)
*TGA (Targa)
*JPEG (Joint Photographic Experts Group)
*FPO (Fragment Program Objects)
*VPO (Vertex Program Objects)


*QRC files from firmware version 1.00 up and including 4.50 : http://mir.cr/TSR5E8PM (32078 KB RAR / unpacked size 243425713 bytes)
{| class="wikitable"
**MD5 hashes generated with quickSFV http://pastebin.com/raw.php?i=ATvKyMRC
|-
**CRC32 hashes generated with quickSFV http://pastebin.com/raw.php?i=40h6iMCA
| style="background-color:#515243; color:#FFFFFF;" |'''Offset'''
| style="background-color:#515243; color:#FFFFFF;" |'''Size'''
| style="background-color:#515243; color:#FFFFFF;" |'''Example'''
| style="background-color:#515243; color:#FFFFFF;" |'''Remark'''
|-
| 0x00 || 0x08 || 00 00 00 00 00 00 00 00 || similar all qrc files
|-
| 0x08 || 0x08 || FF FF FF FF FF FF FF FF || similar all qrc files
|-
| 0x10 || 0x04 || FF FF FF FF || similar all qrc files
|-
| 0x14 || 0x04 || 00 00 00 1C || similar all qrc files
|-
| 0x18 || 0x04 || 00 00 00 1C || similar all qrc files
|-
| 0x1C || 0x04 || 00 00 00 04 || similar all qrc files
|-
| 0x20 || 0x08 || 00 00 00 00 00 00 00 00 || similar all qrc files
|-
| 0x28 || 0x08 || FF FF FF FF FF FF FF FF || similar all qrc files
|-
| 0x30 || 0x04 || 00 00 00 38 || similar all qrc files: first entrance?
|-
| 0x34 || 0x04 || 00 00 02 90 || size body data table
|-
| 0x38 || 0x04 || 00 00 00 0F || similar all qrc files
|-
| 0x3F || 0x04 || 00 00 00 02 || 00 00 00 03 on icontex.qrc
|-
| 0x40 || 0x04 || 00 00 00 1C || similar all qrc files
|-
| 0x44 || 0x04 || FF FF FF FF || similar all qrc files
|-
| 0x48 || 0x04 || 00 00 00 74 || 00 00 00 84 on icontex.qrc: : second entrance?
|-
| 0x4C || 0x08 || FF FF FF FF FF FF FF FF || similar all qrc files
|-
| 0x54 || 0x04 || 00 00 00 14 || similar all qrc files
|-
| 0x58 || 0x04 || 00 00 00 06 || similar all qrc files
|-
| 0x5C || 0x04 || 00 00 00 00 || similar all qrc files
|-
| 0x5C || 0x04 || 00 00 00 00 || similar all qrc files
|-
| 0x60 || 0x04 || 00 00 00 00 || size of first file
|-
| 0x60 || 0x04 || 00 00 00 18 ||
|}


== QRC related tools ==
====Filename Table====
Each entry is composed by:


=== ZLIB ===
{| class="wikitable"
QRC files uses [[Template:Zlib Header|ZLIB]] compression level 9, there are 2 types of QRC files that can be recognized by reading the first 4 bytes either QRCC or QRCF, the next 4 bytes indicates the decompressed size. The first step to extract QRC contents is to remove this 8 bytes at the start of the file. After removed the resulting file is in zlib format
|-
! Offset !! Length !! Example !! Name !! Notes
|-
| 0x0 || 0x4 || 00000038 || '''Data Table entry offset''' || Same value than in the '''Data Table'''
|-
| 0x4 || ''variable'' || lib/rhm/Clear.fpo || '''File name''' ||
|-
| ''variable'' || 0x1 || 00 || '''NULL byte''' ||
|}
*The end of the table has a padding to align to 0x10 bytes


*'''QGL converter''' - This code can decompress a QRCC to QRCF and compress a QRCF to QRCC (it crops/generates the first 8 bytes and manages the zlib decompression/compression) [https://raw.github.com/wargio/ps3tools/master/QGL.c QGL.c]
====File Table====
*'''Zlib GUI v1.0''' - Nice GUI to work with the zlib dll. Download: [http://www.f2065.ru/soft/ZLib_GUI_en.htm official link], or [http://www.psx-place.com/resources/zlib-gui.716/ alternative link]


=== QRC Extractors ===
The table starts with 0x20 bytes, are always present in all the .qrc files
After the ZLIB decompression (needed for all .qrc files except icontex.qrc) the contents can be extracted individually using different tools
'''Offset(h) 00 01 02 03  04 05 06 07  08 09 0A 0B  0C 0D 0E 0F'''
'''00000440'''  <span style="background:#ffff66;">71 72 63 00  66 69 6C 65  2D 74 61 62  6C 65 00 66</span>  qrc.file-table.f
'''00000450'''  <span style="background:#ffff66;">69 6C 65 00  73 72 63 00  69 64 00</span> <span style="background:#ff6666;">00  00 00 00 00</span>  ile.src.id......
*Marked in red: padding to align to 0x10 bytes


*<s>'''P3Textractor''' - Is posible to use a theme extractor to extract the contents from .qrc files, but first is needed to replace the characters '''/''' by '''_''' of the text strings inside the '''Name table''' with a hexeditor (e.g: the string '''override/black/ICONS.mnu''' needs to be replaced by '''override_black_ICONS.mnu''')</s>. Dont use this method, is too much innacurate and obsolete, is kept here only for historical purposes
After this, the files are concatenated in the same order than in the '''Filename Table'''
*'''CXML decompiler v4 alpha''' - Is a python script to extract the contents of CXML containers (CXML, QRCF, P3TF, RAFO, etc...), and also generates an .xml that represents the original CXML structure. To use it copy the script at bottom of [[CXML Containers]] page and save it to your PC as '''script.py'''. Then run it from the command line and follow the instructions, it requires [https://www.python.org/downloads/ python 2]


=== QRC Compilers ===
== Mods ==
There are no .qrc compilers, the usual method to modify qrc files is by patching the text strings of the .MNU settings or to inject the custom files with a hexeditor overriting the original .qrc file structure
=== [[canyon.qrc|canyon.qrc]] ===
=== [[earth.qrc|earth.qrc]] ===
=== [[icons.qrc|icons.qrc]] ===
=== [[icontex.qrc|icontex.qrc]] ===
=== [[lines.qrc|lines.qrc]] ===
=== [[raf.qrc|raf.qrc]] ===
=== [[rhm.qrc|rhm.qrc]] ===
=== [[store.qrc|store.qrc]] ===


The patches should never exceeed the size of the original data, incase of patching an predefined area with an smaller patch is recommended to "blank" the original data with zeroes before writing the new data
== Tools ==


The format allows also to "remap" the contained files by modifying the entries in the index to make them point to the offset/size of a different file
=== QGL ===
*this tool can decompress a QRCC to QRCF and compress a QRCF to QRCC


*'''Patching strings in hexeditor'''
https://raw.github.com/wargio/ps3tools/master/QGL.c (just run make to compile it)
**Mostly used with the settings inside .mnu files
**First extract the files with the CXML decompiler script, look at the main .xml to identify the file names, open the .mnu file you want to modify in notepad++ to be able to read the settings in a easy way
**Select the string you want to modify and copy it
**Open the .qrc file in a hexeditor (after ZLIB decompression if needed) and use the search funtion to locate the string you copyed in the previous step
**Notes
***Most of the settings from .mnu files are repeated several times inside the .qrc file. Be sure to patch the correct .mnu file by comparing the data before or/and after


*'''Injecting files in hexeditor'''
=== Generic Tiny little extractor embedded DDS/MNU/JPG/MPO/PNG ===
**Similar than patching a text string but with a bigger chunk of data
*Theses generic tiny little tools extract blindly & embedded files and are means to be tiny and independent. Heavily based on an [http://www.ps3devwiki.com/wiki/Talk:Content_Information_Files MPO splitter] by Christian Steinruecken.


== External Links ==
http://rghost.net/49340892 (include Code-Compile-Credit. Drag and drop your file into them) &
*QRC modding by eustolio: http://www.scenespain.net/foro/tutoriales-ps3/tutorial-xmb-custom-cambia-el-color-e-iconos-base-del-xmb/ (2011 may 29)
mirror links: http://mir.cr/0R78ED3U
**Corrections: None :)
*XMB wave modding by glowball: http://www.ps3hax.net/showthread.php?t=25618 (2011 july 1) and http://www.ps3hax.net/showthread.php?t=58673 (2013 july 4)
**Corrections:
***The concept of PAL/NTSC wave is wrong. The wave is common for all PS3 models, resolutions, aspect ratios, and regions. The 8 bytes at the start of the file doesnt has any relationship with PAL/NTSC
***There is no javascript inside the QRC container, the supposed .js file used in glowball method is a chunk of data containing several .mnu files (included the padding between them)
***The idea of an "imaginary" javascript hides the real explain of the structure or what you are patching, making users to dont understand a word and promoting the "blind testing"
***In the case you want to patch 1 byte... you are patching a huge area instead
***Using hardcoded offsets is a safe way to break compatility when the files changes in with newer firmwares and good for softbricking, there is no advise of incompatibility problems
 
*Qt Framework
**http://qt-project.org/doc/qt-5/rcc.html
**http://qt-project.org/doc/qt-5/resources.html
**https://qt.gitorious.org/qt/qtbase/source/fb20f9c2da369b07fc50857a90b596ae63f943da:src/tools/rcc
**https://qt.gitorious.org/qt-creator/qt-creator/source/1154a8c6c2bfb223f4239d7902c3755e8a9a1213:src/plugins/resourceeditor/qrceditor
 
 
{{File Formats}}<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)

Templates used on this page:

Retrieved from "http://www.psdevwiki.com/ps3/Qt_Resource_Container_(QRC)"