The FontManager class provides centralized management for TrueType fonts. It handles font loading, caching, and provides convenient methods for text rendering and metrics calculation.
Singleton Access
getInstance()
static FontManager& getInstance()
Reference to the singleton FontManager instance
FontManager::getInstance().loadTTFFont("main", "font.ttf");
TTF Font Management
loadTTFFont()
bool loadTTFFont(const std::string& name, const std::string& fontPath)
name
const std::string&
required
Name to register the font under
fontPath
const std::string&
required
Path to the .ttf font file
True if the font was loaded successfully, false otherwise
FontManager::getInstance().loadTTFFont("main", "assets/fonts/OpenSans.ttf");
setDefaultTTFFont()
void setDefaultTTFFont(const std::string& name)
name
const std::string&
required
Name of the registered font to use as default
FontManager::getInstance().setDefaultTTFFont("main");
hasTTFFont()
Checks if at least one TTF font has been loaded.
True if at least one TTF font is loaded, false otherwise
if (FontManager::getInstance().hasTTFFont()) {
// Use TTF rendering
}
getTTFFont()
TTFFontRenderer* getTTFFont(const std::string& name = "")
name
const std::string&
default:""
Name of the font to retrieve (empty string gets default)
Pointer to the font renderer, or nullptr if not found
TTFFontRenderer* font = FontManager::getInstance().getTTFFont("main");
Font Metrics
getTextWidth()
int getTextWidth(const std::string& text, int size, const std::string& fontName = "")
text
const std::string&
required
Text string to measure
fontName
const std::string&
default:""
Name of the font to use (empty string uses default)
int width = FontManager::getInstance().getTextWidth("Hello", 24, "main");
getTextHeight()
int getTextHeight(int size, const std::string& fontName = "")
fontName
const std::string&
default:""
Name of the font to use (empty string uses default)
int height = FontManager::getInstance().getTextHeight(24, "main");
Cache Management
clearAllCaches()
Clears all cached glyph data for all loaded fonts. This can help free memory but will require re-rendering glyphs on next use.
FontManager::getInstance().clearAllCaches();
Example Usage
Basic Font Setup
// Load fonts
FontManager& fm = FontManager::getInstance();
fm.loadTTFFont("regular", "assets/fonts/OpenSans-Regular.ttf");
fm.loadTTFFont("bold", "assets/fonts/OpenSans-Bold.ttf");
fm.setDefaultTTFFont("regular");
Text Measurement
// Calculate centered position
std::string text = "Centered Text";
int width = FontManager::getInstance().getTextWidth(text, 24);
int height = FontManager::getInstance().getTextHeight(24);
int x = (canvasWidth - width) / 2;
int y = (canvasHeight - height) / 2;
Multiple Fonts
FontManager& fm = FontManager::getInstance();
// Load multiple fonts
fm.loadTTFFont("title", "fonts/Title.ttf");
fm.loadTTFFont("body", "fonts/Body.ttf");
fm.loadTTFFont("mono", "fonts/Mono.ttf");
// Use different fonts for different purposes
int titleWidth = fm.getTextWidth("Title", 32, "title");
int bodyWidth = fm.getTextWidth("Body text", 16, "body");
int codeWidth = fm.getTextWidth("code", 14, "mono");
Memory Management
// Clear caches when memory is tight
if (needToFreeMemory) {
FontManager::getInstance().clearAllCaches();
}