fortplot_text_fonts Module


Uses


Functions

public function init_text_system() result(success)

Initialize STB TrueType font system with robust font discovery

Arguments

None

Return Value logical

public function find_font_by_name(font_name, font_path) result(found)

Find font by name in typical system locations

Arguments

Type IntentOptional Attributes Name
character(len=*), intent(in) :: font_name
character(len=256), intent(out) :: font_path

Return Value logical

public function find_any_available_font(font_path) result(found)

Find any available font using same priority order as system initialization

Arguments

Type IntentOptional Attributes Name
character(len=256), intent(out) :: font_path

Return Value logical

public function get_font_ascent_ratio() result(ratio)

Get font ascent ratio for baseline positioning

Arguments

None

Return Value real(kind=wp)

public function get_global_font() result(font)

Arguments

None

Return Value type(truetype_font_t)

public function get_font_scale() result(scale)

Arguments

None

Return Value real(kind=wp)

public function get_font_scale_for_size(pixel_height) result(scale)

Get font scale for a specific pixel height

Arguments

Type IntentOptional Attributes Name
real(kind=wp), intent(in) :: pixel_height

Return Value real(kind=wp)

public function is_font_initialized() result(initialized)

Arguments

None

Return Value logical


Subroutines

public subroutine set_preferred_font(font_name)

Set preferred font and reinitialize if needed. Call before rendering to switch fonts for a style mode.

Arguments

Type IntentOptional Attributes Name
character(len=*), intent(in) :: font_name

public subroutine cleanup_text_system()

Clean up text system resources

Arguments

None

public subroutine get_font_metrics(ascent_pixels, descent_pixels, line_gap_pixels, success)

Get font metrics in pixels for current font and scale

Arguments

Type IntentOptional Attributes Name
real(kind=wp), intent(out) :: ascent_pixels
real(kind=wp), intent(out) :: descent_pixels
real(kind=wp), intent(out) :: line_gap_pixels
logical, intent(out) :: success

public subroutine glyph_bitmap(scale, codepoint, bitmap, width, height, xoff, yoff)

Rasterise codepoint at the primary-font scale, drawing it from a fallback font when the primary font has no such glyph.

Arguments

Type IntentOptional Attributes Name
real(kind=wp), intent(in) :: scale
integer, intent(in) :: codepoint
integer(kind=int8), intent(out), allocatable :: bitmap(:)
integer, intent(out) :: width
integer, intent(out) :: height
integer, intent(out) :: xoff
integer, intent(out) :: yoff

public subroutine glyph_hmetrics(codepoint, advance_width, left_side_bearing)

Horizontal metrics in primary-font units, from the font that draws the glyph.

Arguments

Type IntentOptional Attributes Name
integer, intent(in) :: codepoint
integer, intent(out) :: advance_width
integer, intent(out) :: left_side_bearing

public subroutine glyph_bitmap_box(codepoint, scale, ix0, iy0, ix1, iy1)

Bitmap box at the primary-font scale, from the drawing font.

Arguments

Type IntentOptional Attributes Name
integer, intent(in) :: codepoint
real(kind=wp), intent(in) :: scale
integer, intent(out) :: ix0
integer, intent(out) :: iy0
integer, intent(out) :: ix1
integer, intent(out) :: iy1