Function setupFontTextWidth

apps/tools/Tools/commands/FontCommand.cpp:199–307

font textwidth — engine-exact rendered text width as a screen-width fraction Reproduces the FreeType branch of Engine::GetTextWidth (FontDraw.cpp): resolve the font alias through the active per-role slot mapping (FindFontMapping), load the mapped TTF, then apply the same widthScale / letterSpacing / synthetic bold-oblique and aspect/FOV scaling. Output is a fraction of screen width, so it compare

// it compares directly against a control's `w`. Used to flag credit / cutscene
// text that overflows its bounds with the real shipping font.
static void setupFontTextWidth(CLI::App& font)
{
    auto* cmd = font.add_subcommand(
        "textwidth", "Engine-exact rendered text width (screen-width fraction) for a font alias + sizeEx");

    static std::string alias;
    static double sizeEx = 0.0;
    static std::string text;
    static std::string dataDir = "packages/Remaster";
    static int width = 1920;
    static int height = 1080;
    static double fovTop = 0.75;
    static double fovLeft = 1.0;
    static double maxW = -1.0;
    static bool asJson = false;

    cmd->add_option("font", alias, "Font alias as used in a resource (e.g. SteelfishB64CE)")->required();
    cmd->add_option("sizeEx", sizeEx, "Control sizeEx (font height as a fraction of screen height)")->required();
    cmd->add_option("text", text, "Text to measure")->required();
    cmd->add_option("--data-dir", dataDir, "Game data dir holding fonts/ (default packages/Remaster)");
    cmd->add_option("--width", width, "Surface width px (default 1920)");
    cmd->add_option("--height", height, "Surface height px (default 1080)");
    cmd->add_option("--fov-top", fovTop, "Aspect topFOV (config fovTop, default 0.75)");
    cmd->add_option("--fov-left", fovLeft, "Aspect leftFOV (config fovLeft, default 1.0)");
    cmd->add_option("--max-width", maxW, "If set, also report fits = width <= maxWidth (the control w)");
    cmd->add_flag("--json", asJson, "Emit a single-line JSON result");

    cmd->callback(
        []()
        {
            std::string low = alias;
            for (char& c : low)
                c = static_cast<char>(std::tolower(static_cast<unsigned char>(c)));

            const Poseidon::FreeTypeFontMapping* m = Poseidon::FindFontMapping(low.c_str());
            if (!m)
            {
                std::cerr << "Error: no font mapping for alias '" << alias << "' (prefix not found)\n";
                throw CLI::RuntimeError(2);
            }

            std::string ttf = dataDir;
            if (!ttf.empty() && ttf.back() != '/' && ttf.back() != '\\')
                ttf += '/';
            for (const char* p = m->ttfPath; *p; ++p)
                ttf += (*p == '\\') ? '/' : *p;

            Poseidon::ui::FontRenderer fr;
            fr.SetSyntheticOblique(m->syntheticOblique);
            fr.SetSyntheticBold(m->syntheticBold);
            if (!fr.LoadFont(ttf))
            {
                std::cerr << "Error: cannot load font file: " << ttf << "\n";
                throw CLI::RuntimeError(1);
            }

            // Engine::GetTextWidth FreeType branch, headless: Width2D()/Height2D()
            // collapse to Width()/Height() over the full-screen UI region.