PARAM.HIS: Difference between revisions

From PS3 Developer wiki
Jump to navigation Jump to search
m (→‎Description: cosmetic)
(finished ? --> this files are usefull to store changelogs of hombrew, take a look guys <---)
Line 1: Line 1:
== Description ==
== Description ==
This file is used to display the changelog texts of a HDD game ('''HG''' category), game patches ('''GD''' category), and gamedata ('''GD''' category).
Texts are displayed under the option "'''Update History'''" when pressing triangle over his icon.


This file is used to describe the update history (display on xmb under options of the game or game data utility)
PARAM.HIP is the "source" file, contained in the root of a Install_Package.pkg. When the package is installed the "destiny" PARAM.HIS is generated automatically by the system preceded by 10 bytes containing his timestamp and controll bytes.
Game example:
*HATSUNE MIKU Project Diva - Dreamy Theater (update 1.01 of the PS3 PSN side)
*Catherine BLJM60215 (Japanese version) update 1.01


Location : same as PARAM.SFO (folder game)
Consecutive installations of more .HIP files over the same .HIS adds the same structure severall times separated for his timestamps and a blank row when displayed in XMB.


Relation with PARAM.SFO : independent from Title_ID or version but need to be under PS3 game category
Severall PARAM_'''xx'''.HIP files can be included in a .pkg for different [[Content_Information_Files#Languages|languages]] by adding a number to the end of the filename (e.g. PARAM_'''16'''.HIP for polish language), the system will install only the one that matches the language settings of the user, or the default PARAM.HIP if no other is applicable.


Relation with PARAM.HIS : Generated from PARAM.HIP by ps3 (after unpkg)or first boot of the game/ homebrew, overwrite, add infos (such as date and time when it was installed )
*'''Game examples'''
 
**HATSUNE MIKU Project Diva (NPJB00047) - patch 1.01
Both PARAM.HIS & PARAM.HIP can be language specific (e.g. PARAM_'''16'''.HIS for polish language) by adding a number to the end of filename from this list [[Content_Information_Files#Languages]]
**Catherine (BLJM60215) - patch 1.01


==Internal Structures==
==Internal Structures==
Line 24: Line 23:
! Description !! Lenght !! Example !! Conversion !! Example Converted !! Notes
! Description !! Lenght !! Example !! Conversion !! Example Converted !! Notes
|-
|-
| Text Line Nº1 || variable || 52 6F 77 20 31 || utf-8 || Row 1
| Text Line || variable || 52 6F 77 20 31 || utf-8 || Row 1
|-
|-
| Line Feed || 1 byte || 0A || || ||Control byte to break the text line
| Line Feed || 1 byte || 0A || || ||Control byte to break the text line

Revision as of 10:03, 26 February 2012

Description

This file is used to display the changelog texts of a HDD game (HG category), game patches (GD category), and gamedata (GD category). Texts are displayed under the option "Update History" when pressing triangle over his icon.

PARAM.HIP is the "source" file, contained in the root of a Install_Package.pkg. When the package is installed the "destiny" PARAM.HIS is generated automatically by the system preceded by 10 bytes containing his timestamp and controll bytes.

Consecutive installations of more .HIP files over the same .HIS adds the same structure severall times separated for his timestamps and a blank row when displayed in XMB.

Severall PARAM_xx.HIP files can be included in a .pkg for different languages by adding a number to the end of the filename (e.g. PARAM_16.HIP for polish language), the system will install only the one that matches the language settings of the user, or the default PARAM.HIP if no other is applicable.

  • Game examples
    • HATSUNE MIKU Project Diva (NPJB00047) - patch 1.01
    • Catherine (BLJM60215) - patch 1.01

Internal Structures

PARAM.HIP

This structure is repeated several times inside the file, one time for each text row, the controll byte "0A" displaces text to the next row.

Description Lenght Example Conversion Example Converted Notes
Text Line variable 52 6F 77 20 31 utf-8 Row 1
Line Feed 1 byte 0A Control byte to break the text line

PARAM.HIS

This structure is repeated severall times inside the file, one time for each PARAM.HIP included in the file.

Description Lenght Example Conversion Example Converted Notes
Timestamp Mark 1 byte 01 Marks the start point of a Timestamp
Timestamp 8 bytes 00 00 00 00 4E F6 59 70 Decimal ---> Unix time 1324767600 ---> 2011/12/25 00:00
PARAM.HIP Mark 1 byte 02 Marks the start point of a PARAM.HIP
PARAM.HIP variable Raw PARAM.HIP

Hexadecimal to Decimal online [conversor]

Decimal to Unix Timestamp online [conversor]

Example of a "hand made" [PARAM.HIS] that simulates 3 patches with 3 text rows each, installed in 3 different years, usefull to copy-paste it inside an installed patch folder (GD category) or a game (HG category) to understand how the .HIP's are cummulated inside a .HIS