PlayStation 3 Theme (P3T): Difference between revisions

From PS3 Developer wiki
Jump to navigation Jump to search
(→‎Others:: .dds tools)
(→‎.XML:: XML example with comments + separated sections for variations)
Line 60: Line 60:


====.XML:====
====.XML:====
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)


{{Boxcode|content=<syntaxhighlight lang="xml">
{{Boxcode|content=<syntaxhighlight lang="xml">
  <bgimagetable>
<?xml version="1.0" encoding="UTF-8"?>
  <bgimage hd="hd_1.jpg" sd="sd_1.jpg"/>
<!----------------------------------->
  <bgimage anim="anim_1.jpg"/>
<!-- Reserved for notes if needed -->
  <bgimage anim="anim_3.jpg"/>
<!----------------------------------->
  <bgimage anim="anim_4.jpg"/>
<theme>
  <bgimage anim="anim_2.jpg"/>
<infotable>
  <bgimage hd="hd_2.jpg" sd="sd_2.jpg"/>
<info
</bgimagetable>
name="Theme Name"
</syntaxhighlight>}}
icon="themeicon.png"
iconsize="16512"
url="http://www.ps3devwiki.com"
author="You"
authoricon="authoricon.png"
authoriconsize="16512"
genre="Modding"
version="666"
comment="No comment, thxbye"
preview="preview.png"
previewsize="518528"
mtime="20081010105635"  
/>
<!-- icon = theme icon (64x64, 32-bit PNG) -->
<!-- authoricon = author icon(64x64, 32-bit PNG) -->
<!-- preview = preview icon of the theme (480x270, 24-bit PNG) -->
<!-- mtime = theme update date (YYYYMMDDHHMMSS) -->
</infotable>
 
<color selection="10" /> <!-- From 1 to 12, same color than monthly wallpapers  -->
 
<font selection="1" /> <!-- Original: 0, Rounded: 1, Pop: 2 -->


<notification src="notification.png" /> <!-- Notification windows background, at top-right corner of XMB -->


<icontable> <!-- All this icons are 128x128, 24-bit PNG, except the ones especifyed -->
<!-------------------------- horizontal row -------------------------->
<icon id="icon_user" src="icon_user.png" />
<icon id="icon_setting" src="icon_setting.png" />
<icon id="icon_photo" src="icon_photo.png" />
<icon id="icon_music" src="icon_music.png" />
<icon id="icon_video" src="icon_video.png" />
<icon id="icon_game" src="icon_game.png" />
<icon id="icon_network" src="icon_network.png" />
<icon id="icon_friend" src="icon_friend.png" />
<icon id="icon_tv" src="icon_tv.png" />
<!-------------------------- user column -------------------------->
<icon id="icon_poweroff" src="icon_poweroff.png" />
<icon id="icon_newuser" src="icon_newuser.png" />
<!-------------------------- settings column -------------------------->
<icon id="icon_update" src="icon_update.png" />
<icon id="icon_game_setting" src="icon_game_setting.png" />
<icon id="icon_bdvd_setting" src="icon_bdvd_setting.png" />
<icon id="icon_music_setting" src="icon_music_setting.png" />
<icon id="icon_chat_setting" src="icon_chat_setting.png" />
<icon id="icon_system_setting" src="icon_system_setting.png" />
<icon id="icon_theme_setting" src="icon_theme_setting.png" />
<icon id="icon_datetime_setting" src="icon_datetime_setting.png" />
<icon id="icon_powersave_setting" src="icon_powersave_setting.png" />
<icon id="icon_accessory" src="icon_accessory.png" />
<icon id="icon_printer_setting" src="icon_printer_setting.png" />
<icon id="icon_display_setting" src="icon_display_setting.png" />
<icon id="icon_sound_setting" src="icon_sound_setting.png" />
<icon id="icon_security_setting" src="icon_security_setting.png" />
<icon id="icon_remoteplay_setting" src="icon_remoteplay_setting.png"/>
<icon id="icon_network_setting" src="icon_network_setting.png" />
<icon id="icon_setting_item" src="icon_setting_item.png" />
<!-------------------------- photo/music/video columns -------------------------->
<icon id="icon_photo_default" src="icon_photo_default.png" />
<icon id="icon_photo_album_default" src="icon_photo_album_default.png" />
<icon id="icon_music_default" src="icon_music_default.png" />
<icon id="icon_music_album_default" src="icon_music_album_default.png" />
<icon id="icon_video_default" src="icon_video_default.png" />
<icon id="icon_video_album_default" src="icon_video_album_default.png" />
<!-------------------------- game column -------------------------->
<icon id="icon_gamedata" src="icon_gamedata.png" />
<icon id="icon_savedata" src="icon_savedata.png" />
<icon id="icon_savedata_minis" src="icon_savedata_minis.png" />
<icon id="icon_vmc" src="icon_vmc.png" />
<icon id="icon_newvmc" src="icon_newvmc.png" />
<icon id="icon_trophy" src="icon_trophy.png" />
<!-------------------------- network column -------------------------->
<icon id="icon_onlinemanual" src="icon_onlinemanual.png" />
<icon id="icon_remoteplay" src="icon_remoteplay.png" />
<icon id="icon_inet_search" src="icon_inet_search.png" />
<icon id="icon_browser" src="icon_browser.png" />
<icon id="icon_download" src="icon_download.png" />
<!-------------------------- psn column -------------------------->
<icon id="icon_accountmanage" src="icon_accountmanage.png" />
<!-------------------------- friends column -->
<icon id="icon_blocklist" src="icon_blocklist.png" />
<icon id="icon_addfriend" src="icon_addfriend.png" />
<icon id="icon_playermet" src="icon_playermet.png" />
<icon id="icon_chat" src="icon_chat.png" />
<icon id="icon_chatroom" src="icon_chatroom.png" />
<icon id="icon_chatroom_text" src="icon_chatroom_text.png" />
<icon id="icon_mbox" src="icon_mbox.png" />
<icon id="icon_mbox_received" src="icon_mbox_received.png" />
<icon id="icon_mbox_sent" src="icon_mbox_sent.png" />
<icon id="icon_mbox_create" src="icon_mbox_create.png" />
<!-------------------------- storage devices -------------------------->
<icon id="icon_ms" src="icon_ms.png" />
<icon id="icon_sd" src="icon_sd.png" />
<icon id="icon_cf" src="icon_cf.png" />
<icon id="icon_usb" src="icon_usb.png" />
<icon id="icon_psp" src="icon_psp.png" />
<icon id="icon_pspms" src="icon_pspms.png" />
<icon id="icon_usbcamera" src="icon_usbcamera.png" />
<icon id="icon_usbaad" src="icon_usbaad.png" />
<!-------------------------- media player -------------------------->
<icon id="icon_playing" src="icon_playing.png" />
<icon id="icon_mediaserver_search" src="icon_mediaserver_search.png" />
<icon id="icon_playlist" src="icon_playlist.png" />
<icon id="icon_playlist_add" src="icon_playlist_add.png" />
<icon id="icon_video_upload" src="icon_video_upload.png" />
</icontable>


Info table (author name, comment....): 
<!-------------------------- background -------------------------->
<bgimagetable>
<bgimage hd="bgimage_hd.jpg" sd="bgimage_sd.jpg" />
</bgimagetable>


{{Boxcode|content=<syntaxhighlight lang="xml">
<!-------------------------- mouse pointers are missing -------------------------->
<infotable>
  <info
  author="myname"                      //is author name
  authoricon="authoricon_1.gim.png"    //is author icon (64x64, 32-bit PNG)
  authoriconsize="16512"
  genre="others" 
  icon="icon_1.gim.png"                //is the theme icon (64x64, 32-bit PNG) (required)
  iconsize="16512"
  comment="Visit the wiki" 
  mtime="20081010105635"                //is theme update date (YYYYMMDDHHMMSS)
  name="PS3 Dev Wiki"                  //is name of the theme (required)
  preview="preview_1.gim.png"          //is preview icon of the theme (480x270, 24-bit PNG)
  previewsize="518528"                             
  url="http://www.ps3devwiki.com"                 
  version="version 1.0"
  />
</syntaxhighlight>}}


{{Boxcode|content=<syntaxhighlight lang="xml">
<!-------------------------- sounds -------------------------->
  <localizedinfo locale="en" name="PS3 Dev Wiki"/>
<setable>
  <localizedinfo locale="jp" name="PS3 Dev Wiki"/>
<se id="se_system_ok" src="se_system_ok.vag" /> <!-- General dialog open sound -->
<se id="se_decide" src="se_decide.vag" /> <!-- Enter sound -->
<se id="se_cancel" src="se_cancel.vag" /> <!-- Cancel sound -->
<se id="se_optionmenu" src="se_optionmenu.vag" /> <!-- Options menu open sound -->
<se id="se_cursor" src="se_cursor.vag" /> <!-- Cursor movement -->
</setable>
</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):




Language fonts supported for the info table is similar than [[Content_Information_Files#Languages | content file information]] and the type for XMB can be selected among Original (per default/ as "0"), Rounded (as "1") or Pop ( as "2"):
----
Variations


*Reduced infotable
This is the minimal tested by me --[[User:Sandungas|Sandungas]] 14:05, 11 February 2013 (MSK) if you find some item of this table is not needed please delete the line
{{Boxcode|content=<syntaxhighlight lang="xml">
{{Boxcode|content=<syntaxhighlight lang="xml">
<font selection="1"/>
<infotable>
<info
name="Theme Name"
icon="themeicon.png"
url="http://www.ps3devwiki.com"
author="You"
authoricon="authoricon.png"
genre="Modding"
version="666"
comment="No comment, thxbye"
preview="preview.png"
/>
</infotable>
</syntaxhighlight>}}
</syntaxhighlight>}}


*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)
{{Boxcode|content=<syntaxhighlight lang="xml">
<localizedinfo locale="es" name="Nombre del Tema"/>
<localizedinfo locale="jp" name="Theme Name"/>
long list....
</syntaxhighlight>}}


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):
*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)


{{Boxcode|content=<syntaxhighlight lang="xml">
{{Boxcode|content=<syntaxhighlight lang="xml">
  <color selection="2"/>  <!-- is for yellow -->
  <bgimagetable>
  <bgimage hd="hd_1.jpg" sd="sd_1.jpg"/>
  <bgimage anim="anim_1.jpg"/>
  <bgimage anim="anim_3.jpg"/>
  <bgimage anim="anim_4.jpg"/>
  <bgimage anim="anim_2.jpg"/>
  <bgimage hd="hd_2.jpg" sd="sd_2.jpg"/>
  </bgimagetable>
</syntaxhighlight>}}
</syntaxhighlight>}}


 
*Stereo Sounds
 
Sound Effect table (can be stereo if assigned):
 
{{Boxcode|content=<syntaxhighlight lang="xml">
{{Boxcode|content=<syntaxhighlight lang="xml">
<setable>
<setable>
  <se id="se_optionmenu" src="se_optionmenu_1.vag"/> //is for Options menu open sound
<se id="se_system_ok" left="se_system_ok.vag" right="se_system_ok.vag" /> <!-- General dialog open sound -->
  <se id="se_decide" src="se_decide_1.vag"/>         //is for Enter sound
<se id="se_decide" left="se_decide.vag" right="se_decide.vag" /> <!-- Enter sound -->
  <se id="se_system_ok" src="se_system_ok_1.vag"/>   //is for General dialog open sound
<se id="se_cancel" left="se_cancel.vag" right="se_cancel.vag" /> <!-- Cancel sound -->
  <se id="se_cancel" src="se_cancel_1.vag"/>         //is for Cancel sound
<se id="se_optionmenu" left="se_optionmenu.vag" right="se_optionmenu.vag" /> <!-- Options menu open sound -->
  <se id="se_cursor" src="se_cursor_1.vag"/>         //is for Cursor movement
<se id="se_cursor" left="se_cursor.vag" right="se_cursor.vag" /> <!-- Cursor movement -->
</setable>
</syntaxhighlight>}}
</syntaxhighlight>}}



Revision as of 12:05, 11 February 2013

Classic theme

Installation

  • From USB (and CF/SD/MS memorycards): /PS3/THEME/*.p3t
  • 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

default theme


  • 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:

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].


Structure

.JPEG:

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).

.PNG:

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

.VAG:

Sound effects as PlayStation Compressed Sound File.

.XML:

Code Sample
  • 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):



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
  • 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
  • Stereo Sounds
Code Sample

Limitations & Misc

  • 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/
  • 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
-Geometry & script size max: 1mb
-Actor size max: 1.20mb
-Actor number max: 128
-Cameras: 1
-Lights: 2 (ambient + point)
-Scripts: 1 .js (playstation javascript derivate, also known as PSJS)
-Models: 64
  • 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.
  • Navigation sounds (clicks)
-Total sound data under 256 KB.
  • Setting as 16/9 if background theme not displayed
  • Color selection table as example:
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: