OBD:TSGA: Difference between revisions

From OniGalore
Jump to navigation Jump to search
m (design + update)
m (changed family)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{OBD_File_Header | type=TSGA | prev=TSFT | next=TStr | name=Glyph Array | family=Global | align=center}}
{{OBD_File_Header | type=TSGA | prev=TSFT | next=TStr | name=Glyph Array | family=Interface | align=center}}




Every TSGA file contains 256 elements. One element stands for one of the 256 signs of the ASCII table. The first 32 signs are reserved control characters, so these elements are always complete zero.
Every TSGA file contains 256 elements of 20 bytes each, thus taking up 5,120 bytes without the header. Together with the 8-byte header and 32-byte padding, each TSGA takes up 5,152 bytes in a .dat (another 20 bytes are taken up in the instance descriptor array).


For Western languages, a TSFT has only one TSGA which corresponds to an ASCII-based [[wp:Code page|code page]]:
*the first 32 symbols (0 to 31) are non-printable control characters, so these elements are always all zero;
*the next 96 symbols (32 to 127) correspond to standard US-ASCII (except that 127 is usually non-printable);
*the upper half of the table (128 to 255) contains additional punctuations and ligatures, Latin characters with diacritics and, in the case of the Russian version, Cyrillic script.
The code page is not the same for all Western Oni versions.


[[image:tsga_a.gif]]
Asian localizations of Oni use their own extended encoding system and glyph data either in place of Oni's (Chinese), or in combination with it (Japanese).
 
See [[OBD:Text encoding]] for details on the encoding systems, a list of the available characters in each language version, and a review of known issues.
 
 
----
[[Image:tsga_a.gif]]




Line 14: Line 25:
{{OBDtr| 0x04 | lev_id  |FFFF00| 01 00 00 00 | 0    | level 0 }}
{{OBDtr| 0x04 | lev_id  |FFFF00| 01 00 00 00 | 0    | level 0 }}
{{OBDtrBK}}
{{OBDtrBK}}
{{OBDtr| 0x00 | int16    |FFC8C8| 00 00      |unused| unknown }}
{{OBDtr| 0x00 | int16    |FFC8C8| 00 00      |unused| character code }}
{{OBDtr| 0x02 | int16    |FFFFC8| 00 00      |unused| unknown }}
{{OBDtr| 0x02 | int16    |FFFFC8| 00 00      |unused| width }}
{{OBDtr| 0x04 | int16    |C8FFC8| 00 00      |unused| unknown }}
{{OBDtr| 0x04 | int16    |C8FFC8| 00 00      |unused| bitmap width }}
{{OBDtr| 0x06 | int32   |C8FFFF| 00 00 00 00 |unused| unknown }}
{{OBDtr| 0x06 | int16   |C8FFFF| 00 00       |unused| bitmap height }}
{{OBDtr| 0x0A | int16    |FFC8FF| 00 00      |unused| number of used elements in the [[OBD:TSFT|TSFT]] file }}
{{OBDtr| 0x08 | int16    |C8FFFF| 00 00       |unused| bitmap x origin }}
{{OBDtr| 0x0A | int16    |FFC8FF| 00 00      |unused| bitmap y origin }}
{{OBDtr| 0x0C | int32    |FFC800| 00 00 00 00 |unused| start element in the [[OBD:TSFT|TSFT]] file }}
{{OBDtr| 0x0C | int32    |FFC800| 00 00 00 00 |unused| start element in the [[OBD:TSFT|TSFT]] file }}
{{OBDtr| 0x10 | int32    |C800C8| 00 00 00 00 |unused| unknown; always zero }}
{{OBDtr| 0x10 | int32    |C800C8| 00 00 00 00 |unused| runtime only }}
|}
|}




{{OBD_File_Footer | type=TSGA | prev=TSFT | next=TStr | name=Glyph Array | family=Global}}
A glyph is basically a grayscale bitmap which is (width * height) pixels in size. The [[OBD:TSFT|TSFT]] file stores each pixel as a byte, with 256 degrees of brightness/opacity, which in theory allows for rather subtle antialiasing. In practice, for the smallest font size there is no antialiasing at all (the 8-bit pixels are either fully black or fully white, and are suitable for 1-bit storage), and larger font sizes actually use only 17 degrees of brightness/opacity - from 0xFF to 0x0F, and then 0x00 - which the engine further posterizes to proper 4-bit when rendering.
 
The pixels stored in TSFT (packed 4-by-4 as little-Endian unsigned int32s) are treated as a scanline, row major, top to bottom and left to right. The width of a glyph is not always a multiple of 4 pixels, so the scanline can wrap around, i.e., a new row of pixels can start in the middle of a 4-byte element. The start of a glyph, however, is always aligned on a 4-byte element of the TSFT array. The end of a glyph is padded with 0xDEAD.
 
 
----
;Difference in the PS2 implementation
{{Table}}
|- ALIGN=CENTER VALIGN=TOP
{{OBDtr| 0x0C | int32    |FFC800| 00 00 00 00 |unused| position of the pixel glyph data in the .raw part of the [[OBD:TSFT|TSFT]] file, in quarter-bytes }}
{{OBDtr| 0x10 | int32    |C800C8| 00 00 00 00 |unused| runtime only? }}
|}
In the PS2 implementation, glyphs are also rectangular grayscale bitmaps, but the storage is much more compact, with only 2 bits per pixel (i.e., 4 pixels per byte), and the scanline is stored continuously for the whole font, without padding/aligning the beginning of a glyph to whole bytes or 4-byte blocks. The scanline is stored in the .raw part of the TSFT file (as opposed to the PC and Mac implementation, which uses a variable array in the .dat). Within a byte, the pixel order is low-to-high (see the TSFT page for an example).
 
It is not 100% clear why the template checksum is different for PS2, even though the TSGA structure is essentially the same; the field at 0x0C seems to be an (unsigned) int32 in both cases. The runtime field at 0x10 is also an unsigned int32 ("cell pointer"), rather than a bunch of flags.
 
 
{{OBD_File_Footer | type=TSGA | prev=TSFT | next=TStr | name=Glyph Array | family=Interface}}
 
{{OBD}}

Latest revision as of 01:47, 7 December 2023

ONI BINARY DATA
TSFT << Other file types >> TStr
TSGA : Glyph Array
switch to XML:TSGA page
Overview @ Oni Stuff
OBD.png


Every TSGA file contains 256 elements of 20 bytes each, thus taking up 5,120 bytes without the header. Together with the 8-byte header and 32-byte padding, each TSGA takes up 5,152 bytes in a .dat (another 20 bytes are taken up in the instance descriptor array).

For Western languages, a TSFT has only one TSGA which corresponds to an ASCII-based code page:

  • the first 32 symbols (0 to 31) are non-printable control characters, so these elements are always all zero;
  • the next 96 symbols (32 to 127) correspond to standard US-ASCII (except that 127 is usually non-printable);
  • the upper half of the table (128 to 255) contains additional punctuations and ligatures, Latin characters with diacritics and, in the case of the Russian version, Cyrillic script.

The code page is not the same for all Western Oni versions.

Asian localizations of Oni use their own extended encoding system and glyph data either in place of Oni's (Chinese), or in combination with it (Japanese).

See OBD:Text encoding for details on the encoding systems, a list of the available characters in each language version, and a review of known issues.



Tsga a.gif


Offset Type Raw Hex Value Description
0x00 res_id 01 04 00 00 4 00004-.TSGA
0x04 lev_id 01 00 00 00 0 level 0
First element (black outline)
0x00 int16 00 00 unused character code
0x02 int16 00 00 unused width
0x04 int16 00 00 unused bitmap width
0x06 int16 00 00 unused bitmap height
0x08 int16 00 00 unused bitmap x origin
0x0A int16 00 00 unused bitmap y origin
0x0C int32 00 00 00 00 unused start element in the TSFT file
0x10 int32 00 00 00 00 unused runtime only


A glyph is basically a grayscale bitmap which is (width * height) pixels in size. The TSFT file stores each pixel as a byte, with 256 degrees of brightness/opacity, which in theory allows for rather subtle antialiasing. In practice, for the smallest font size there is no antialiasing at all (the 8-bit pixels are either fully black or fully white, and are suitable for 1-bit storage), and larger font sizes actually use only 17 degrees of brightness/opacity - from 0xFF to 0x0F, and then 0x00 - which the engine further posterizes to proper 4-bit when rendering.

The pixels stored in TSFT (packed 4-by-4 as little-Endian unsigned int32s) are treated as a scanline, row major, top to bottom and left to right. The width of a glyph is not always a multiple of 4 pixels, so the scanline can wrap around, i.e., a new row of pixels can start in the middle of a 4-byte element. The start of a glyph, however, is always aligned on a 4-byte element of the TSFT array. The end of a glyph is padded with 0xDEAD.



Difference in the PS2 implementation
0x0C int32 00 00 00 00 unused position of the pixel glyph data in the .raw part of the TSFT file, in quarter-bytes
0x10 int32 00 00 00 00 unused runtime only?

In the PS2 implementation, glyphs are also rectangular grayscale bitmaps, but the storage is much more compact, with only 2 bits per pixel (i.e., 4 pixels per byte), and the scanline is stored continuously for the whole font, without padding/aligning the beginning of a glyph to whole bytes or 4-byte blocks. The scanline is stored in the .raw part of the TSFT file (as opposed to the PC and Mac implementation, which uses a variable array in the .dat). Within a byte, the pixel order is low-to-high (see the TSFT page for an example).

It is not 100% clear why the template checksum is different for PS2, even though the TSGA structure is essentially the same; the field at 0x0C seems to be an (unsigned) int32 in both cases. The runtime field at 0x10 is also an unsigned int32 ("cell pointer"), rather than a bunch of flags.


ONI BINARY DATA
TSFT << Other file types >> TStr
TSGA : Glyph Array
Interface file