Skip to content

libSceFreeType.md

Latest commit

 

History

History
37 lines (20 loc) · 9.68 KB

libSceFreeType.md

File metadata and controls

37 lines (20 loc) · 9.68 KB
Raw

libSceFreeType technical debt

Unknown function info

  • FT_Get_Sfnt_Name_Count, FT_Get_Sfnt_Name (libSceFreeType) - console signatures, record layout and errors are unverified; the adapter follows bundled FreeType 2.13.3 and assumes the public LP64 FT_SfntName layout (24 bytes, string pointer at 8, byte length at 16). Strings retain their original encoding, borrow native face storage and remain valid only while the face is alive

  • FT_Select_Charmap, FT_Set_Charmap, FT_Get_First_Char, FT_Get_Next_Char, FT_Get_Glyph_Name, FT_Get_Name_Index, FT_Get_Postscript_Name (libSceFreeType) - console signatures, naming rules and errors are unverified; the LP64 adapter follows bundled FreeType 2.13.3. Iteration uses the low 32 input bits and updates only the selected guest charmap; charmap fields are read-only copies. Naming preserves LP64 invalid-index errors on Windows. PostScript names borrow native face storage and remain valid only while the face is alive

  • FT_Init_FreeType, FT_New_Face, FT_Set_Pixel_Sizes, FT_Get_Char_Index, FT_Load_Glyph, FT_Render_Glyph (libSceFreeType) - the PS4 library is taken to be FreeType 2 built for LP64: the face, size, charmap, glyph slot, bitmap and outline layouts follow the public headers of the bundled FreeType 2.13.3 with a 64-bit long, which matches the offsets the OpenOrbis samples read (face->glyph at 0x98, slot->advance at 0x80, slot->bitmap at 0x98, slot->bitmap_left at 0xc0). Which FreeType version and options the console library is built with is unknown, so the behaviour and error codes are those of FreeType 2.13.3. The OpenOrbis font, keyboard, threading, system and SDL2 samples import these six functions

  • FT_Request_Size (libSceFreeType) - console signature, request layout and errors are unverified; the guest request follows the LP64 public headers of the bundled FreeType 2.13.3. Host overflow behavior remains that of the bundled build. On Windows, native FT_Long is 32 bits; valid requests whose width or height exceeds that range throw before changing the size.

  • FT_New_Memory_Face, FT_Done_Face and FT_Done_FreeType (libSceFreeType) - console signatures, errors and generic-finalizer ordering are unverified; they follow the bundled FreeType 2.13.3 with LP64 guest arguments. Caller-owned font bytes must remain valid until the face is freed.

  • FT_Outline_Check, FT_Outline_Get_CBox (libSceFreeType) - console signatures, count signedness and errors are unverified; the adapter follows bundled FreeType 2.13.3, including its unsigned 16-bit counts and contour endpoints. Control-box coordinates use the existing guest LP64 layout and retain their full 64-bit range on Windows; contour checking does not validate point tags

  • FT_Get_Charmap_Index, FT_Get_CMap_Language_ID, FT_Get_CMap_Format (libSceFreeType) - console signatures and return values are unverified; the adapter follows bundled FreeType 2.13.3 and the existing guest LP64 model. Charmaps must be the face's original read-only guest records; copied or otherwise unregistered records with a non-null face throw instead of reading private native cmap fields from guest memory

  • FT_Outline_Reverse, FT_Outline_Translate (libSceFreeType) - console signatures, count signedness and overflow behavior are unverified; the adapter follows bundled FreeType 2.13.3 with LP64 coordinates. Translation uses 64-bit modular addition to match that build's ADD_LONG; reversal preserves each contour's first point and toggles the reverse-fill flag. Coordinates outside the host FT_Pos range still throw if the modified outline is later rendered on Windows

  • FT_Get_X11_Font_Format, FT_Get_FSType_Flags (libSceFreeType) - console signatures, format labels and embedding-flag behavior are unverified; the adapter follows bundled FreeType 2.13.3's format and FSType services. Format strings borrow native driver storage; the console's string lifetime has not been measured

  • FT_Get_Kerning (libSceFreeType) - the name and NID LPtlB241JSg occur in the PS5 3.20 libSceFreeTypeOt inventory, but the console signature and kerning results are unverified. The adapter assumes the existing LP64 guest layout and follows bundled FreeType 2.13.3 for scaling, rounding and errors

Functional

  • FT_Set_Transform (libSceFreeType) - console ABI, transform arithmetic and FreeType-version equivalence are unverified. The name and NID bcM5xfX2SeA come from the PS5 3.20 inventory; the 32-byte LP64 matrix, 16-byte vector, null defaults and glyph behavior follow bundled FreeType 2.13.3. Input components outside the native FT_Long range throw without changing the transform; on Windows this rejects values outside signed 32 bits. Native arithmetic limits remain those of the host library.

  • libSceFreeType (libSceFreeType) - private fields (driver, memory, stream, sizes_list, extensions) and subglyphs stay null. Face, size and glyph-slot records are copies. Only edits to outline points and flags are written back before FT_Render_Glyph; replacing arrays or exceeding the host FT_Pos range throws. FT_New_Face reads the whole file into memory and throws for files of 2 GiB or more on Windows. On macOS, native FreeType symbols remain exported and could resolve guest imports without adaptation; Windows and Linux hide them with --exclude-libs.

  • FT_List_Add, FT_List_Insert, FT_List_Find, FT_List_Remove, FT_List_Up, FT_List_Iterate and FT_List_Finalize - console signatures, callback ordering and error compatibility are unverified. Names and NIDs follow the PS5 3.20 inventory; the pointer-only 16-byte list, 24-byte node and operations follow bundled FreeType 2.13.3. The 32-byte allocator record uses LP64 guest callbacks, and finalization calls its guest free callback for each node. Native list-membership and callback preconditions still apply; malformed lists and callbacks that invalidate a later node are not validated.

  • FT_New_Memory_Face (libSceFreeType) - on Windows, the host FT_Long is 32 bits, so buffer sizes of 2 GiB or more or below -2 GiB throw before the font buffer is read

  • FT_Outline_Get_Orientation (libSceFreeType) - console ABI/version and large-outline equivalence are unverified. The adapter follows bundled FreeType 2.13.3 with the existing unsigned guest counts and an LP64 area accumulator, including on Windows.

  • FT_Set_Char_Size (libSceFreeType) - console ABI, FreeType version and error compatibility are unverified. The name and NID xuY99Qcb108 are in the PS5 3.20 inventory; the LP64 signature and behavior follow bundled FreeType 2.13.3, not a console measurement. After applying its defaults and minimum-size clamp, requests whose dimension * dpi + 36 exceeds the host's signed FT_Long range throw before the native call. This is a 32-bit limit on Windows; larger console requests remain unsupported.

  • FT_Get_Gasp (libSceFreeType) - console FreeType version and query-result compatibility are unverified. The guest face adapter follows bundled FreeType 2.13.3 and its existing LP64 face bridge.