Added MGS Font support

Author: GrzybDev

src/mgtools/__init__.py

@@ -8,6 +8,7 @@
 from mgtools.enumerators.game import Game
 from mgtools.mg1.constants import RESOURCE_SECTION_COUNT as MG1_SECTION_COUNT
 from mgtools.mg2.constants import RESOURCE_SECTION_COUNT as MG2_SECTION_COUNT
+from mgtools.mgs_font import export_mgs_font, import_mgs_font
 from mgtools.resource import Resource
 
 app = typer.Typer(help="Tools for modding PC ports of Metal Gear / Metal Gear 2")
@@ -21,6 +22,14 @@
 )
 ctxr_app = typer.Typer(help="Tools for working with ctxr textures")
 app.add_typer(ctxr_app, name="ctxr", help="Tools for working with ctxr textures")
+mgs_font_app = typer.Typer(
+    help="Tools for working with MGS font files (MGS_Font_nht.raw)"
+)
+app.add_typer(
+    mgs_font_app,
+    name="mgs-font",
+    help="Tools for working with MGS font files (MGS_Font.raw, MGS_Font_nht.raw)",
+)
 
 
 @res_app.command(
@@ -115,3 +124,37 @@ def ctxr_import(
                 continue
 
             import_ctxr(png_file, output_dir)
+
+
+@mgs_font_app.command(
+    "export", help="Export MGS font file to a folder with glyph images and metadata."
+)
+def mgs_font_export(
+    input_file: Annotated[
+        Path, typer.Argument(exists=True, file_okay=True, readable=True)
+    ],
+    output_dir: Annotated[
+        Path | None, typer.Argument(file_okay=False, writable=True)
+    ] = None,
+):
+    if output_dir is None:
+        output_dir = input_file.parent / input_file.stem
+
+    export_mgs_font(input_file, output_dir)
+
+
+@mgs_font_app.command(
+    "import", help="Import glyph images and metadata back into MGS font file."
+)
+def mgs_font_import(
+    input_dir: Annotated[
+        Path, typer.Argument(exists=True, dir_okay=True, readable=True)
+    ],
+    output_file: Annotated[
+        Path | None, typer.Argument(file_okay=True, writable=True)
+    ] = None,
+):
+    if output_file is None:
+        output_file = input_dir.parent / f"{input_dir.name}.raw"
+
+    import_mgs_font(input_dir, output_file)

src/mgtools/constants.py

@@ -20,3 +20,7 @@
 TXTR_MAGIC = b"TXTR"
 TXTR_HEADER_SIZE = 0x84
 TXTR_ALIGNMENT = 32
+
+FONT_MAGIC = b"TNOF"
+FONT_HEADER_SIZE = 0x18
+FONT_GLYPH_HEADER_SIZE = 5

src/mgtools/dataclasses/mgs_glyph.py

@@ -0,0 +1,35 @@
+import struct
+from dataclasses import dataclass
+
+from PIL import Image
+
+
+@dataclass
+class MgsGlyph:
+    char_code: int
+    width: int
+    height: int
+    bearing_x: int
+    bearing_y: int
+    advance: int
+    pixel_data: bytes = b""
+
+    def to_image(self) -> Image.Image | None:
+        # Convert glyph pixel data to a PIL Image (grayscale).
+        if self.width == 0 or self.height == 0:
+            return None
+        return Image.frombytes("L", (self.width, self.height), self.pixel_data)
+
+    def data_bytes(self) -> bytes:
+        # Serialize glyph data (5-byte header + pixel data).
+        return (
+            struct.pack(
+                "BBBBB",
+                self.width,
+                self.height,
+                self.bearing_x,
+                self.bearing_y,
+                self.advance,
+            )
+            + self.pixel_data
+        )