PlayStation 3 Theme (P3T): Difference between revisions

From PS3 Developer wiki
Jump to navigation Jump to search
(→‎.XML:: added pointer and default icons)
(new index, page reordered for future expansion)
Line 1: Line 1:
[[Category:Software]]
[[Category:Software]]
<div style="float:right">[[File:Tex_classic_theme.png|200px|thumb|left|Classic theme]]</div>
<div style="float:right">[[File:Tex_classic_theme.png|200px|thumb|left|Classic theme]]</div>
==Installation==
*From USB (and CF/SD/MS memorycards): /PS3/THEME/*.p3t
*From disc (or fake disc): Infos on [http://www.ps3devwiki.com/wiki/PARAM.SFO#Creating_Discs Creating Discs]
*From PS3 INTERNET browser & SEN STORE
*From FW
*From Games
*From PKG (with EDATA)
*Manually by copying the *.p3t inside the /dev_hdd0/theme folder
==FW related==
<div style="float:right">[[File:Tex_default_theme.png|150px|thumb|left|default theme]]</div>
<div style="float:right">[[File:Tex_default_theme.png|150px|thumb|left|default theme]]</div>


 
==Description==
*FW 3.00:
 
Support for new Dynamic Custom Themes.
 
The default theme has been changed to an updated version of the 'Original' waves theme (the original theme has been renamed 'Classic').
 
XMB icons now change colour along with the theme depending on the time of day.
 


*FW 2.00:
*FW 2.00:
**Ability to modify the PlayStation 3 XMB Home Menu icons or background design by using a theme compiler
**[Colour], [Background] and [Font] have been added as options under [Theme Settings].
**Ability to select [Brightness] as an option under [Theme Settings] > [Background].


Ability to modify the PlayStation 3 XMB Home Menu icons or background design by using a theme compiler
*FW 3.00:
 
**Support for new Dynamic Custom Themes.
[Colour], [Background] and [Font] have been added as options under [Theme Settings].
**The default theme has been changed to an updated version of the 'Original' waves theme (the original theme has been renamed 'Classic').
 
**XMB icons now change colour along with the theme depending on the time of day.
Ability to select [Brightness] as an option under [Theme Settings] > [Background].
 
 
 
==Structure==
 
====.JPEG:====
Contain the background(s) of the theme.


You can have different background for SD (640x480) or HD (1920x1080) resolutions.
*Installation
**From USB (and CF/SD/MS memorycards): /PS3/THEME/*.p3t
**From disc (or fake disc): Infos on [http://www.ps3devwiki.com/wiki/PARAM.SFO#Creating_Discs Creating Discs]
**From PS3 INTERNET browser & SEN STORE
**From FW
**From Games
**From PKG (with EDATA)
**Manually by copying the *.p3t inside the /dev_hdd0/theme folder


Can be compiled into RAF directly (.DDS can be used also).


====.PNG:====
==Theme Contents==
Contain icons and pointers used on XMB.
Icons used by default when the theme don t have newest icons (or not build with) .


====.VAG:====
====Theme Scene (.XML)====
 
Sound effects as PlayStation Compressed Sound File.
 
====.XML:====


{{Boxcode|content=<syntaxhighlight lang="xml">
{{Boxcode|content=<syntaxhighlight lang="xml">
Line 198: Line 166:
</theme>
</theme>
</syntaxhighlight>}}
</syntaxhighlight>}}
*Notes
Color of the option menu (and XMB waves when there are no background image) can be selected among the 12 (original per month or per default if none valid value) displayed on Theme Settings/Color (see color table below):




Line 233: Line 198:
long list....
long list....
</syntaxhighlight>}}
</syntaxhighlight>}}
====Themeicon and Authoricon (.PNG)====
====Theme Preview (.PNG)====
====XMB Icons (.PNG)====
*Notes
'''icon_default_v''' and '''icon_default_v''' are used when the theme don t have newest icons needed by XMB (or not build with). E.g. when installing a theme made in 2008 in a firmware released in 2013
====Notification window (.PNG)====
====Mouse Pointers (.PNG)====
====Navigation Sounds (.VAG)====
Sound effects as PlayStation Compressed Sound File.
-Total sound data under 256 KB.
*Stereo Sounds
{{Boxcode|content=<syntaxhighlight lang="xml">
<setable>
<se id="se_system_ok" left="se_system_ok.vag" right="se_system_ok.vag" /> <!-- General dialog open sound -->
<se id="se_decide" left="se_decide.vag" right="se_decide.vag" /> <!-- Enter sound -->
<se id="se_cancel" left="se_cancel.vag" right="se_cancel.vag" /> <!-- Cancel sound -->
<se id="se_optionmenu" left="se_optionmenu.vag" right="se_optionmenu.vag" /> <!-- Options menu open sound -->
<se id="se_cursor" left="se_cursor.vag" right="se_cursor.vag" /> <!-- Cursor movement -->
</setable>
</syntaxhighlight>}}
====Background (.JPG .RAF)====
*The background image (in themes without a .raf background)
-Max size of an image (JPEG normal format): 2MB.
-One theme file can contain at most 24 background images.
=====Static and slideshow Themes (JPG)=====
Contain the background(s) of the theme.
You can have different background for SD (640x480) or HD (1920x1080) resolutions.
Can be compiled into RAF directly (.DDS can be used also).


*Animated background
*Animated background
Line 251: Line 258:
</syntaxhighlight>}}
</syntaxhighlight>}}


*Stereo Sounds
=====Animated and 3D Themes (RAF)=====
{{Boxcode|content=<syntaxhighlight lang="xml">
RAF ('''r'''ich '''a'''ppearance '''f'''ormat) is considered an "image format", themes can contain a raf file that is used as the background of the theme. This same format is used for the coldboot.raf animation when PS3 boots.
<setable>
<se id="se_system_ok" left="se_system_ok.vag" right="se_system_ok.vag" /> <!-- General dialog open sound -->
<se id="se_decide" left="se_decide.vag" right="se_decide.vag" /> <!-- Enter sound -->
<se id="se_cancel" left="se_cancel.vag" right="se_cancel.vag" /> <!-- Cancel sound -->
<se id="se_optionmenu" left="se_optionmenu.vag" right="se_optionmenu.vag" /> <!-- Options menu open sound -->
<se id="se_cursor" left="se_cursor.vag" right="se_cursor.vag" /> <!-- Cursor movement -->
</setable>
</syntaxhighlight>}}
 
==Limitations & Misc==


*DAE ('''d'''igital '''a'''sset '''e'''xchange) is an XML file that contains COLLADA content. COLLADA is an open standard created by sony for interactive 3D applications. Is used to export and import files from 3-D authoring applications (Maya, and 3ds max) in .dae format https://collada.org/
It must comply with these restrictions :
 
*RAF (rich appearance format) is considered an "image format", themes can contain a raf file that is used as the background of the theme. This same RAF format is used for the coldboot animation when PS3 boots. It must comply with these restrictions :
  -Textures size max: 15 mb
  -Textures size max: 15 mb
  -Geometry & script size max: 1mb
  -Geometry & script size max: 1mb
Line 273: Line 268:
  -Cameras: 1
  -Cameras: 1
  -Lights: 2 (ambient + point)
  -Lights: 2 (ambient + point)
  -Scripts: 1 .js (playstation javascript derivate, also known as PSJS)
  -Scripts: 1
  -Models: 64
  -Models: 64 (with 8 animations each model)
 
*Object, skelleton, animation, lights
DAE ('''d'''igital '''a'''sset '''e'''xchange) is an XML file that contains COLLADA content. COLLADA is an open standard created by sony for interactive 3D applications. Is used to export and import files from 3-D authoring applications (Maya, and 3ds max) in .dae format https://collada.org/


*The background image (in themes without a .raf background)
*Script
-Max size of an image (JPEG normal format): 2MB.
.js (playstation javascript derivate, also known as PSJS)
-One theme file can contain at most 24 background images.


*Navigation sounds (clicks)
*Textures
-Total sound data under 256 KB.
JPEG, DDS


*Setting as 16/9 if background theme not displayed
==XMB color and bright settings==


*Color selection table as example:
Color of the option menu (and XMB waves when there are no background image) can be selected among the 12 (original per month or per default if none valid value) displayed on Theme Settings/Color (see color table below):
<!--//color values are not PS3 definite//-->


{| class="wikitable sortable"
{| class="wikitable sortable"
|-
|+ color values are only orientative
! Color Sample || Color Selection || Month
! Color Sample || Color Selection || Month
|-
|-

Revision as of 05:28, 12 February 2013

Classic theme
default theme

Description

  • FW 2.00:
    • Ability to modify the PlayStation 3 XMB Home Menu icons or background design by using a theme compiler
    • [Colour], [Background] and [Font] have been added as options under [Theme Settings].
    • Ability to select [Brightness] as an option under [Theme Settings] > [Background].
  • FW 3.00:
    • Support for new Dynamic Custom Themes.
    • The default theme has been changed to an updated version of the 'Original' waves theme (the original theme has been renamed 'Classic').
    • XMB icons now change colour along with the theme depending on the time of day.
  • Installation
    • From USB (and CF/SD/MS memorycards): /PS3/THEME/*.p3t
    • From disc (or fake disc): Infos on Creating Discs
    • From PS3 INTERNET browser & SEN STORE
    • From FW
    • From Games
    • From PKG (with EDATA)
    • Manually by copying the *.p3t inside the /dev_hdd0/theme folder


Theme Contents

Theme Scene (.XML)

Code Sample


Variations

  • Reduced infotable

This is the minimal tested by me --Sandungas 14:05, 11 February 2013 (MSK) if you find some item of this table is not needed please delete the line 

Code Sample
  • Localized info

This texts replaces the "Theme Name" in the <infotable> with different languages for each region, the languages are the same ones used in Content_Information_Files#Languages and are only displayed when the XMB is configured in the same language

When the theme doesnt contains <localizedinfo> the default "theme Name" from <infotable> is used , for this reason is preferable to dont include <localizedinfo> (are not needed, and the name of the theme doesnt need to be translated in most cases) 

Code Sample

Themeicon and Authoricon (.PNG)

Theme Preview (.PNG)

XMB Icons (.PNG)

  • Notes

icon_default_v and icon_default_v are used when the theme don t have newest icons needed by XMB (or not build with). E.g. when installing a theme made in 2008 in a firmware released in 2013

Notification window (.PNG)

Mouse Pointers (.PNG)

Navigation Sounds (.VAG)

Sound effects as PlayStation Compressed Sound File. 

-Total sound data under 256 KB.
  • Stereo Sounds
Code Sample

Background (.JPG .RAF)

  • The background image (in themes without a .raf background)
-Max size of an image (JPEG normal format): 2MB.
-One theme file can contain at most 24 background images.
Static and slideshow Themes (JPG)

Contain the background(s) of the theme.

You can have different background for SD (640x480) or HD (1920x1080) resolutions.

Can be compiled into RAF directly (.DDS can be used also).

  • Animated background

On the background image used: You can have more than one, each time you boot back to XMB, a new background will be display. In that case it ll look like this: (here it s 2 static JPEG background, SD or HD according to monitor resolution, 4 anim with different dynamic background) 

Code Sample
Animated and 3D Themes (RAF)

RAF (rich appearance format) is considered an "image format", themes can contain a raf file that is used as the background of the theme. This same format is used for the coldboot.raf animation when PS3 boots.

It must comply with these restrictions : 

-Textures size max: 15 mb
-Geometry & script size max: 1mb
-Actor size max: 1.20mb
-Actor number max: 128
-Cameras: 1
-Lights: 2 (ambient + point)
-Scripts: 1
-Models: 64 (with 8 animations each model)
  • Object, skelleton, animation, lights

DAE (digital asset exchange) is an XML file that contains COLLADA content. COLLADA is an open standard created by sony for interactive 3D applications. Is used to export and import files from 3-D authoring applications (Maya, and 3ds max) in .dae format https://collada.org/

  • Script

.js (playstation javascript derivate, also known as PSJS)

  • Textures

JPEG, DDS

XMB color and bright settings

Color of the option menu (and XMB waves when there are no background image) can be selected among the 12 (original per month or per default if none valid value) displayed on Theme Settings/Color (see color table below):

color values are only orientative
Color Sample Color Selection Month
1 January
2 February
3 March
4 April
5 May
6 June
7 July
8 August
9 September
10 October
11 November
12 December

Tutorials & Tools Links

official:

  • Theme Settings manual:

http://manuals.playstation.net/document/en/ps3/current/settings/themesettings.html

  • How do I create my own theme for the PlayStation®3 computer entertainment system?

http://us.playstation.com/support/answer/index.htm?a_id=1205

  • Playstation 3 custom theme guidelines v2.00 (official p3tcompiler.exe with a sample theme). This toolset doesnt contains the raf compilers !

http://uk.playstation.com/ps3/support/settings/detail/linked235336/item85346/Download-PlayStation-3-Custom-Theme-Guidelines/

Others:

Retrieved from "http://www.psdevwiki.com/ps3/index.php?title=PlayStation_3_Theme_(P3T)&oldid=19245"