TextRenderer.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Valentin Eloy
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
#include <cstdint>
#include <string_view>
 
#include <DirectXMath.h>
 
#include "Core/Ecs/Components/Sprite.h"  // core::Color
#include "HMI/Graphics/ComposedScene.h"
#include "HMI/Graphics/ProceduralFont.h"  // hmi::FontMetrics
#include "HMI/Graphics/RenderLayer.h"

 
namespace hmi {
 
class BitmapFont;

enum class TextHorizontalAnchor { Left, Center, Right };

enum class TextVerticalAnchor { Top, Middle, Bottom };

struct TextAnchor {
    TextHorizontalAnchor horizontal = TextHorizontalAnchor::Left;
    TextVerticalAnchor vertical = TextVerticalAnchor::Top;
};

[[nodiscard]] DirectX::XMFLOAT4X4 screenProjectionMatrix(int viewportWidth,
                                                         int viewportHeight) noexcept;

void composeText(ComposedScene& scene, const FontMetrics& metrics, TextureHandle texture,
                 int textureWidth, int textureHeight, std::string_view text, float x, float y,
                 float scale, const core::Color& tint, TextAnchor anchor = {},
                 std::int32_t sortOrder = 0);

void composeText(ComposedScene& scene, const BitmapFont& font, std::string_view text, float x,
                 float y, float scale, const core::Color& tint, TextAnchor anchor = {},
                 std::int32_t sortOrder = 0);
 
}  // namespace hmi