Font Manager Module

This module provides a centralized FontManager class responsible for loading, caching, and scaling fonts used throughout the Property Tycoon application. It ensures consistent font usage and adapts font sizes dynamically based on the current screen resolution, maintaining readability across different display sizes.

The Font Manager module provides:

A mechanism to load TrueType Fonts (.ttf) from a specified path.
Caching of loaded pygame.font.Font objects to improve performance by avoiding redundant file loading.
Automatic scaling of requested font sizes based on the current screen dimensions relative to a base resolution (1280x720).
A global font_manager instance for easy access from other modules.
Methods to update the font path or recalculate the scale factor, clearing the cache when necessary.

class src.Font_Manager.FontManager[source]

Bases: object

classmethod clear_cache()[source]: Clear the font cache

classmethod get_font(size)[source]: Get a font at the specified base size (will be automatically scaled)

classmethod get_scaled_size(base_size)[source]: Get a scaled font size based on the current scale factor

classmethod update_font_path(new_font_path)[source]: Update the current font and clear the cache

classmethod update_scale_factor(width, height)[source]: Update the text scaling factor based on screen dimensions

Detailed Design

FontManager Class Diagram

This diagram illustrates the structure of the FontManager class, emphasizing its use of class attributes and methods to manage font resources globally.

$@startuml class FontManager <<Singleton>> { {static} - _instance : FontManager = None ' Conceptual instance, access via class {static} - _fonts : Dict(tuple, pygame.font.Font) = {} ' Cache: (path, scaled_size) -> Font {static} - _current_font_path : str = None {static} - _base_width : int = 1280 {static} - _base_height : int = 720 {static} - _scale_factor : float = 1.0 {static} + get_font(size: int) : pygame.font.Font {static} + update_font_path(new_font_path: str) {static} + update_scale_factor(width: int, height: int) : float {static} + get_scaled_size(base_size: int) : int {static} + clear_cache() } class "pygame.font.Font" as PygameFont FontManager ..> PygameFont : creates & caches > FontManager ..> os : uses for path operations > FontManager ..> pygame : uses for font loading & errors > note right of FontManager::_fonts Cache stores loaded fonts. Key is (font_path, scaled_size). end note note right of FontManager::_scale_factor Determines how much to scale base font sizes based on current screen resolution vs base resolution. end note @enduml Sequence Diagram: Getting a Font$

Shows the process of requesting a font from the FontManager, including scaling and cache interaction.

Illustrates how the scale factor is updated (e.g., on window resize) and how it affects the cache.