Theme compiler for PlayStation(R)3 Version 1.60
                      Copyright (C) 2009 Sony Computer Entertainment Inc.
                                                     All Rights Reserved.


About This Program

    p3tcompiler.exe is a program that creates PlayStation(R)3 theme files 
    from XML and applicable data files. It runs on Windows.


Building a Theme File with p3tcompiler

    Either type the following at the command prompt:

        p3tcompiler.exe sample\simple\simple.xml

    or drag-and-drop an XML file onto the p3tcompiler.exe icon.
    A theme file with file extension "p3t" will be created.


Preview

    1. Place the theme file in the /PS3/THEME/ directory of a Memory Stick 
       or USB storage, and connect it to PlayStation(R)3.

    2. Select "Settings" > "Theme Settings" > "Theme" in the system software 
       and install a theme file from the recording media.

    3. Select "Settings" > "Theme Settings" > "Theme" in the system 
       software again. A list of theme files will be shown in the option menu.

    4. Select a theme file and "Apply". This theme will be applied to the 
       screen.


Scripting the XML File

    The elements that can be written in the XML file are described below.

    <theme>

        Root element.
        It has no attributes.

    <infotable>, <info>, <localizedinfo>

        Elements for storing information of the theme file.
        <localizedinfo> has information specific to a language.
        <info> has information common to all languages.

        The attributes that can be specified for both <info> and
        <localizedinfo> are as follows.

            name         Theme name
            url          URL indicating the distributor of the theme
            author       Author
            genre        Theme genre (string)
            version      Theme version (string)
            icon         Theme icon (64x64, 32-bit PNG)
            authoricon   Author icon (64x64, 32-bit PNG)
            preview      Preview image (480x270, 24-bit PNG)
            comment      Theme comment (string)
            mtime        Theme update time ("YYYYMMDDHHMMSS" string)

        <localizedinfo> must have a "locale" attribute to specify the 
        language.

            en    English
            jp    Japanese
            fr    French
            es    Spanish
            de    German
            it    Italian
            nl    Dutch
            pt    Portuguese
            ru    Russian
            ko    Korean
            zh_t  Chinese (traditional)
            zh_s  Chinese (simplified)
            fi    Finnish
            sv    Swedish
            da    Danish
            no    Norwegian
			pl    Polski

    <icontable>, <icon>

       Elements for storing the system software icons.

       The attributes that can be specified for <icon> are as follows.

            id   ID indicating the icon type
            src  Icon image


            The IDs that can be specified for the "id" attribute are as
            follows.


            System Software (Row)

                icon_user                   Users
                icon_setting                Settings
                icon_photo                  Photo
                icon_music                  Music
                icon_video                  Video
                icon_game                   Game
                icon_network                Network
                icon_friend                 Friends
                icon_tv                     TV


            System Software (Column)

                icon_poweroff               Turn Off System
                icon_newuser                Create New User

                icon_update                 System Update
                icon_game_setting           Game Settings
                icon_bdvd_setting           Video Settings
                icon_music_setting          Music Settings
                icon_chat_setting           Chat Settings
                icon_system_setting         System Settings
                icon_theme_setting          Theme Settings
                icon_datetime_setting       Date and Time Settings
                icon_powersave_setting      Power Save Settings
                icon_accessory              Accessory Settings
                icon_printer_setting        Printer Settings
                icon_display_setting        Display Settings
                icon_sound_setting          Sound Settings
                icon_security_setting       Security Settings
                icon_remoteplay_setting     Remote Play Settings
                icon_network_setting        Network Settings

                icon_setting_item           (Settings submenu item)

                icon_photo_default          (Photo default icon)
                icon_photo_album_default    (Photo album default icon)
                icon_music_default          (Music default icon)
                icon_music_album_default    (Music album default icon)
                icon_video_default          (Video default icon)
                icon_video_album_default    (Video album default icon)

                icon_playing                (Song now being played icon 
                                             displayed in the Music column)
                icon_mediaserver_search     Search for Media Servers

                icon_playlist               Playlists
                icon_playlist_add           Create New Playlist

                icon_ms                     Memory Stick(TM)
                icon_cf                     Compact Flash
                icon_sd                     SD Memory Card
                icon_usb                    USB Device
                icon_psp                    PSP(TM)(PlayStation(R)Portable)
                icon_pspms                  Memory Stick(TM) of PSP(TM)(PlayStation(R)Portable)
                icon_usbcamera              Digital Camera
                icon_usbaad                 ATRAC Audio Device

                icon_gamedata               Game Data Utility
                icon_vmc                    Memory Card Utility (PS/PS2)
                icon_savedata               Save Data Utility (PS3(TM))
                icon_newvmc                 New Internal Memory Card
                icon_trophy                 Trophy Collection

                icon_onlinemanual           Online Instruction Manuals
                icon_remoteplay             Remote Play
                icon_inet_search            Internet Search
                icon_browser                Internet Browser
                icon_download               Download Management

                icon_accountmanage          Account Management

                icon_blocklist              Block List
                icon_addfriend              Add a Friend
                icon_playermet              Player Met
                icon_chat                   Start New Chat
                icon_chatroom               Chat Room
                icon_chatroom_text          Chat Room (Text Only)
                icon_mbox                   Message Box

                icon_mbox_received          Received
                icon_mbox_sent              Sent
                icon_mbox_create            Create Message

            
            Default Icons

                icon_default_h              Image used for icons in row 
                                            when there is no specified image
                icon_default_v              Image used for icons in column
                                            when there is no specified image


        Icon images are generally 128x128, 32-bit PNG images, except for
        the following.

            icon_photo_default
            icon_photo_album_default

                170x128, 32-bit PNG

            icon_video_default
            icon_video_album_default

                228x128, 32-bit PNG


    <pointertable>, <pointer>

        Elements for storing the pointer (mouse cursor) image.

        The attributes that can be specified for <pointer> are as follows.

            id       ID indicating the pointer type
            src      Pointer image
            base_x   X coordinate of the pointer hotspot
            base_y   Y coordinate of the pointer hotspot


        The IDs that can be specified for the "id" attribute are as 
        follows.

            pointer_arrow     Default state
            pointer_finger    Pointing to a clickable object
            pointer_click     Clicking
            pointer_hand      Pointing to a draggable object
            pointer_grab      Dragging
            pointer_pen       Pointing to an object accepting text input

        The pointer image is a 48x48, 32-bit PNG image.

        base_x, base_y specify the hotspot in the pointer image.
        The coordinate system ranges from top left (0,0) to 
        bottom right (48,48).


    <notification>

        Element for storing the image of the notification window frame.

        The attributes that can be specified for <notification> are as 
        follows.

            src   Image of the frame of the notification window

        This image is a 64x64, 32-bit PNG image.


    <bgimagetable>, <bgimage>

        Elements for storing the background image.

        <bgimagetable> can have a maximum of 24 <bgimage> elements.
        The following attribute can be specified for <bgimagetable>.

            showtype    Specifies how to switch between multiple background images
                        If unspecified, the background image will be selected at
                        random every time the PlayStation(R)3 is started up.

        The possible "showtype" types are below.

            days        Select background image according to the date on the
                        PlayStation(R)3. When using "days", also set the <bgimage>
                        attributes "from" and "until".
            datetime    Select background image according to the time on the
                        PlayStation(R)3. When using "datetime", set the <bgimage> 
                        attributes "from" and "until".

        The following attributes can be specified for <bgimage>.

            hd       Background image used when the aspect ratio is 16:9 (1920x1080 JPEG)
            sd       Background image used when the aspect ratio is 4:3 (640x480 JPEG)
            from     Date/time to start displaying the background image, 
                     if "days" or "datetime" is specified to the showtype attribute
            until    Date/time to stop displaying the background image,
                     if "days" or "datetime" is specified to the showtype attribute

            When "days" is specified for the showtype attribute, specify the 
            applicable time period (from, until) as shown in the following examples.

                1) YYYY/MM/DD Format

                <bgimage hd="bghd.jpg" sd="bgsd.jpg" from="20090101" until="20090131" />

                With this configuration, the specified background image will be 
                displayed when the date on the PlayStation(R)3 is between 
                January 1, 2009 and January 31, 2009.

                2) MM/DD Format

                <bgimage hd="bghd.jpg" sd="bgsd.jpg" from="0101" until="0131" />

                With this configuration, the specified background image will be 
                displayed when the date on the PlayStation(R)3 is between 
                January 1 and January 31. Unlike the YYYY/MM/DD format, the year 
                is not relevant.

            When "datetime" is specified for the showtype attribute, specify the 
            applicable time period (from, until) as shown below.

                HH Format

                <bgimage hd="bghd.jpg" sd="bgsd.jpg" from="00" until="05" />

                With this configuration, the specified background image will be 
                displayed when the time on the PlayStation(R)3 is 0:mm to 5:mm, 
                with mm indicating minutes. Specify the values for "from" and 
                "until" in 24-hour notation (00-23).

           When "days" and "datetime" are specified, but the date/time on the 
           PlayStation(R)3 does not fall into either of the specified time 
           periods, the background image of the first <bgimage> element will be displayed. 


    <font>

        Element for specifying the font type.

        The attributes that can be specified for <font> are as follows.

            selection   Integer value (0 - 2) indicating the font type

        The values specified to "selection" have the following meanings.

            0   Default font

            1   Japanese: Maru Gothic
                Korean, Chinese: Default font
                Other languages: Rounded

            2   Japanese: Pop
                Korean, Chinese: Default font
                Russian: Rounded
                Other languages: Rimouski


    <color>

        Element that specifies the theme color
 
        The attributes that can be specified with <color> are as shown below.
 
             selection:  Integer value (0 - 12) indicating the theme color
 
        The values specified to "selection" have the following meanings.
 
             0: Default theme color (changes by date and time. )

             1-12: Fixed color




About the Sample

    An example of an XML file is provided. The filename is simple.xml.

----------------------------------------------------------------------
Permission and Restrictions on Use
----------------------------------------------------------------------
The permission and restrictions on using this software conform to
the contract concluded between your company and our company (Sony
Computer Entertainment Inc).

----------------------------------------------------------------------
Note on Trademarks
----------------------------------------------------------------------
"PlayStation" is a registered trademark of Sony Computer Entertainment Inc.
All other product and company names mentioned herein, with or without
the registered trademark symbol (R) or trademark symbol (TM), are
generally registered trademarks and/or trademarks of their respective
owners.

