Improved font rendering interface

This commit is contained in:
2025-12-11 16:44:53 +08:00
parent f6268951b7
commit 7b098e0542
5 changed files with 70 additions and 17 deletions

View File

@@ -31,9 +31,13 @@ TTF_Font* FontManager::loadFont(const std::string& fontID, int ptSize) {
return font; return font;
} }
TTF_Font* FontManager::getFont(const std::string& key) { TTF_Font* FontManager::getFont(const std::string& key, int ptSize) {
auto it = m_fonts.find(key); auto it = m_fonts.find(key);
return (it != m_fonts.end()) ? it->second : nullptr; if (it != m_fonts.end()) {
return it->second;
}
return loadFont(key, ptSize);;
} }

View File

@@ -14,7 +14,7 @@ public:
TTF_Font* loadFont(const std::string& fontID, int ptSize); TTF_Font* loadFont(const std::string& fontID, int ptSize);
// 获取已加载的字体 // 获取已加载的字体
TTF_Font* getFont(const std::string& key); TTF_Font* getFont(const std::string& key, int ptSize);

View File

@@ -1,6 +1,6 @@
#include "TextRenderer.h" #include "TextRenderer.h"
TextRenderer::TextRenderer(FontManager& fontManager,SDL_Renderer* renderer) : TextRenderer::TextRenderer(SDL_Renderer* renderer, FontManager* fontManager) :
m_fontManager(fontManager), m_fontManager(fontManager),
m_renderer(renderer) m_renderer(renderer)
{ {
@@ -18,8 +18,8 @@ TextRenderer::~TextRenderer() {
void TextRenderer::renderText(const std::string& text, const std::string& fontID, int x, int y, SDL_Color color) { void TextRenderer::renderText(const std::string& text, TextStyle style, int x, int y) {
std::string key = makeCacheKey(text, fontID, color); auto key = style.hash();
auto it = m_cache.find(key); auto it = m_cache.find(key);
// 查找缓存 // 查找缓存
@@ -35,13 +35,13 @@ void TextRenderer::renderText(const std::string& text, const std::string& fontID
} }
// 创建新的纹理 // 创建新的纹理
TTF_Font* font = m_fontManager.getFont(fontID); TTF_Font* font = m_fontManager->getFont(style.fontID, style.fontSize);
if (!font) { if (!font) {
SDL_Log("错误:字体未找到 %s\n", fontID.c_str()); SDL_Log("错误:字体未找到 %s\n", style.fontID.c_str());
return; return;
} }
// 创建文字表面 // 创建文字表面
SDL_Surface* surface = TTF_RenderText_Solid(font, text.c_str(),text.length(), color); SDL_Surface* surface = TTF_RenderText_Solid(font, text.c_str(),text.length(), style.color);
if (!surface) { if (!surface) {
printf("错误:无法创建文字表面\n"); printf("错误:无法创建文字表面\n");
return; return;
@@ -74,7 +74,7 @@ void TextRenderer::renderText(const std::string& text, const std::string& fontID
} }
SDL_Texture* TextRenderer::createTextTexture(const std::string& text, const std::string& fontID, SDL_Color color) { SDL_Texture* TextRenderer::createTextTexture(const std::string& text, const std::string& fontID, SDL_Color color) {
return nullptr;
} }

View File

@@ -3,13 +3,13 @@
#include <unordered_map> #include <unordered_map>
#include <SDL3/SDL.h> #include <SDL3/SDL.h>
#include <SDL3_ttf/SDL_ttf.h> #include <SDL3_ttf/SDL_ttf.h>
#include "Textstyle.h"
#include "FontManager.h" #include "FontManager.h"
class TextRenderer { class TextRenderer {
private: private:
SDL_Renderer* m_renderer; SDL_Renderer* m_renderer;
FontManager& m_fontManager; FontManager* m_fontManager;
// 缓存文字纹理 // 缓存文字纹理
@@ -20,23 +20,25 @@ private:
int height; int height;
}; };
std::unordered_map<std::string, CachedText> m_cache;
std::unordered_map<size_t, CachedText> m_cache;
// 创建材质 // 创建材质
SDL_Texture* createTextTexture(const std::string& text, const std::string& fontID, SDL_Color color); SDL_Texture* createTextTexture(const std::string& text, const std::string& fontID, SDL_Color color);
// 创建一个唯一的缓存键:文本 + 字体 + 颜色
std::string makeCacheKey(const std::string& text, const std::string& fontID, SDL_Color color);
public: public:
TextRenderer(FontManager& fontManager, SDL_Renderer* renderer); TextRenderer(SDL_Renderer* renderer, FontManager* fontManager);
~TextRenderer(); ~TextRenderer();
//渲染文本 //渲染文本
void renderText(const std::string& text, const std::string& fontID, int x, int y, SDL_Color color); void renderText(const std::string& text, TextStyle style, int x, int y);
}; };

View File

@@ -0,0 +1,47 @@
#pragma once
#include <SDL3/SDL.h>
#include <SDL3_ttf/SDL_ttf.h>
#include <string>
/**
* @brief 文本样式定义结构体
*
* 封装字体、大小、颜色等文本渲染属性
* 用于统一管理文本外观
*/
struct TextStyle {
std::string fontID; ///< 字体标识符在FontManager中注册的ID
int fontSize = 16; ///< 字体大小(像素)
SDL_Color color = {255, 255, 255, 255}; ///< 文本颜色RGBA
/**
* @brief 比较两个样式是否相等(用于缓存查找)
* @param other 另一个TextStyle对象
* @return true 如果所有属性都相等
*/
bool operator==(const TextStyle& other) const {
return fontID == other.fontID &&
fontSize == other.fontSize &&
color.r == other.color.r &&
color.g == other.color.g &&
color.b == other.color.b &&
color.a == other.color.a;
}
/**
* @brief 计算样式的哈希值用于unordered_map
* @return size_t 哈希值
*/
size_t hash() const {
// 使用组合哈希技术
size_t h1 = std::hash<std::string>{}(fontID);
size_t h2 = std::hash<int>{}(fontSize);
size_t h3 = std::hash<Uint8>{}(color.r);
size_t h4 = std::hash<Uint8>{}(color.g);
size_t h5 = std::hash<Uint8>{}(color.b);
size_t h6 = std::hash<Uint8>{}(color.a);
// 组合哈希(使用黄金比例乘法混合)
return h1 ^ (h2 << 1) ^ (h3 << 2) ^ (h4 << 3) ^ (h5 << 4) ^ (h6 << 5);
}
};