TrueType fonts. More...

#include <Font.h>

Inheritance diagram for Font:

Public Member Functions
Class *	_Font (void)
	The Font archetype.

Font *	cachedFont (const char *family, int size, int style)
	Resolves the cached Font with the given attributes.

void	cacheFont (Data data, const char family)

void	clearCache (void)
	Clears the Font cache.

Font *	defaultFont (void)

Font *	initWithData (Font self, Data data, const char *family, int size, int style)
	Initializes this Font with the given TTF Data and attributes.

Font *	initWithData (Font self, Data data, int size, int index)

void	renderCharacters (const Font self, const char chars, SDL_Color color, int wrapWidth)
	Renders the given characters in this Font.

void	renderDeviceDidReset (Font *self)
	This method should be invoked when the render context is invalidated. Callers must update self->scale before invoking this method.

void	sizeCharacters (const Font self, const char chars, int w, int h)
	Measures the given characters in this Font.

Data Fields
Data *	data
	The raw font data.

char *	family
	The family name.

TTF_Font *	font
	The backing font.

Object	object
	The superclass.

int	renderSize
	The render size, adjusted for display density.

float	scale
	The display pixel density scale (e.g. 2.0 on Retina). Updated by callers via the scale field before invoking renderDeviceDidReset.

int	size
	The point size.

int	style
	The style.

Static Public Attributes
void(*	cacheFont )(Data data, const char family)
	Caches the specified font Data.

Protected Attributes
FontInterface *	interface
	The interface.

Detailed Description

TrueType fonts.

Definition at line 63 of file Font.h.

Member Function Documentation

◆ _Font()

Class * _Font ( void )

The Font archetype.

Returns: The Font Class.

Definition at line 355 of file Font.c.

                   {
  static Class *clazz;
  static Once once;
 
  do_once(&once, {
    clazz = _initialize(&(const ClassDef) {
      .name = "Font",
      .superclass = _Object(),
      .instanceSize = sizeof(Font),
      .interfaceOffset = offsetof(Font, interface),
      .interfaceSize = sizeof(FontInterface),
      .initialize = initialize,
      .destroy = destroy,
    });
  });
 
  return clazz;
}

◆ cachedFont()

Font * cachedFont	(	const char *	family,
		int	size,
		int	style
	)

Resolves the cached Font with the given attributes.

Parameters

family	The family.
size	The size.
style	The style.

Returns: The cached Font, or the default Font if not found.

Definition at line 126 of file Font.c.

                                                                 {
 
  if (family == NULL) {
    family = DEFAULT_FONT_FAMILY;
  }
  if (size < 1) {
    size = DEFAULT_FONT_SIZE;
  }
  if (style < FontStyleRegular || style > FontStyleStrikeThrough) {
    style = DEFAULT_FONT_STYLE;
  }
 
  const Array *fonts = (Array *) _fonts;
  for (size_t i = 0; i < fonts->count; i++) {
 
    Font *font = $(fonts, objectAtIndex, i);
 
    if (!strcmp(font->family, family) &&
        font->size == size &&
        font->style == style) {
      return font;
    }
  }
 
  Data *data = $((Dictionary *) _cache, objectForKeyPath, family);
  if (data) {
    Font *font = $(alloc(Font), initWithData, data, family, size, style);
    assert(font);
 
    $(_fonts, addObject, font);
    release(font);
 
    return font;
  }
 
  MVC_LogWarn("%s-%d-%d not found\n", family, size, style);
  return $$(Font, defaultFont);
}

◆ cacheFont()

void cacheFont	(	Data *	data,
		const char *	family
	)

Definition at line 118 of file Font.c.

                                                      {
  $(_cache, setObjectForKeyPath, data, family);
}

◆ clearCache()

void clearCache ( void )

Clears the Font cache.

Definition at line 169 of file Font.c.

                             {
  $(_cache, removeAllObjects);
}

◆ defaultFont()

Font * defaultFont ( void )

Returns: The default Font.

Definition at line 177 of file Font.c.

                               {
  static Once once;
 
  do_once(&once, {
    Data *data = $(alloc(Data), initWithConstMemory, coda_ttf, coda_ttf_len - 1);
    assert(data);
 
    $$(Font, cacheFont, data, DEFAULT_FONT_FAMILY);
 
    release(data);
  });
 
  return $$(Font, cachedFont, DEFAULT_FONT_FAMILY, DEFAULT_FONT_SIZE, DEFAULT_FONT_STYLE);
}

◆ initWithData() [1/2]

Font * initWithData	(	Font *	self,
		Data *	data,
		const char *	family,
		int	size,
		int	style
	)

Initializes this Font with the given TTF Data and attributes.

Parameters

self	The Font.
data	The Data.
family	The family.
size	The size.
style	The style.

Returns: The initialized Font, or NULL on error.

Definition at line 196 of file Font.c.

                                                                                           {
 
  self = (Font *) super(Object, self, init);
  if (self) {
 
    self->data = retain(data);
    assert(self->data);
 
    self->family = strdup(family);
    assert(self->family);
 
    self->size = size;
    assert(self->size);
 
    self->style = style;
    self->scale = 1.0f;
 
    $(self, renderDeviceDidReset);
  }
 
  return self;
}

◆ initWithData() [2/2]

Font * initWithData	(	Font *	self,
		Data *	data,
		int	size,
		int	index
	)

◆ renderCharacters()

SDL_Surface * renderCharacters	(	const Font *	self,
		const char *	chars,
		SDL_Color	color,
		int	wrapWidth
	)

Renders the given characters in this Font.

Parameters

self	The Font.
chars	The null-terminated UTF-8 encoded C string to render.
color	The color.
wrapWidth	The maximum line width, in logical pixels, where wrapping should occur.

Returns: The rendered surface, or NULL on error.

Definition at line 223 of file Font.c.

                                                                                                          {
 
  SDL_Surface *surface;
  if (wrapWidth) {
    surface = TTF_RenderText_Blended_Wrapped(self->font, chars, 0, color, wrapWidth * self->scale);
  } else {
    surface = TTF_RenderText_Blended(self->font, chars, 0, color);
  }
 
  SDL_Surface *converted = NULL;
  if (surface) {
    converted = SDL_ConvertSurface(surface, SDL_PIXELFORMAT_RGBA32);
    SDL_DestroySurface(surface);
  } else {
    MVC_LogError("%s\n", SDL_GetError());
  }
 
  return converted;
}

◆ renderDeviceDidReset()

void renderDeviceDidReset ( Font * self )

This method should be invoked when the render context is invalidated. Callers must update self->scale before invoking this method.

Parameters

self The Font.

Definition at line 247 of file Font.c.

                                             {
 
  const int renderSize = self->size * self->scale;
  if (renderSize != self->renderSize) {
 
    self->renderSize = renderSize;
 
    if (self->font) {
      TTF_CloseFont(self->font);
    }
 
    SDL_IOStream *buffer = SDL_IOFromConstMem(self->data->bytes, (int) self->data->length);
    assert(buffer);
 
    self->font = TTF_OpenFontIO(buffer, 1, self->renderSize);
    assert(self->font);
 
    TTF_SetFontStyle(self->font, self->style);
    TTF_SetFontHinting(self->font, TTF_HINTING_LIGHT_SUBPIXEL);
  }
}

◆ sizeCharacters()

void sizeCharacters	(	const Font *	self,
		const char *	chars,
		int *	w,
		int *	h
	)

Measures the given characters in this Font.

Parameters

self	The Font.
chars	The null-terminated UTF-8 encoded C string to size.
w	The width to return.
h	The height to return.

Returns: The size of the rendered characters in logical pixels.

Definition at line 273 of file Font.c.

                                                                                {
 
  if (w) {
    *w = 0;
  }
  if (h) {
    *h = 0;
  }
 
  if (chars) {
    char *lines = strdup(chars);
 
    const int font_h = TTF_GetFontHeight(self->font);
 
    for (char *line = strtok(lines, "\n\r"); line; line = strtok(NULL, "\n\r")) {
 
      if (w) {
        int line_w;
        TTF_GetStringSize(self->font, line, 0, &line_w, NULL);
        *w = max(*w, line_w);
      }
      if (h) {
        *h += font_h;
      }
    }
    free(lines);
 
    if (w) {
      *w = ceilf(*w / self->scale);
    }
    if (h) {
      *h = ceilf(*h / self->scale);
    }
  }
}

Field Documentation

◆ cacheFont

void(* cacheFont) (Data *data, const char *family)

static

Caches the specified font Data.

Parameters

data	The TTF Data.
family	The family.

Definition at line 142 of file Font.h.

◆ data

Data* Font::data

The raw font data.

Definition at line 79 of file Font.h.

◆ family

char* Font::family

The family name.

Definition at line 84 of file Font.h.

◆ font

TTF_Font* Font::font

The backing font.

Definition at line 89 of file Font.h.

◆ interface

FontInterface* Font::interface

protected

The interface.

Definition at line 74 of file Font.h.

◆ object

Object Font::object

The superclass.

Definition at line 68 of file Font.h.

◆ renderSize

int Font::renderSize

The render size, adjusted for display density.

Definition at line 94 of file Font.h.

◆ scale

float Font::scale

The display pixel density scale (e.g. 2.0 on Retina). Updated by callers via the scale field before invoking renderDeviceDidReset.

Definition at line 100 of file Font.h.

◆ size

int Font::size

The point size.

Definition at line 105 of file Font.h.

◆ style

int Font::style

The style.

Definition at line 110 of file Font.h.

The documentation for this struct was generated from the following files:

Sources/ObjectivelyMVC/Font.h
Sources/ObjectivelyMVC/Font.c

Public Member Functions

Data Fields

Static Public Attributes

Protected Attributes

Detailed Description

Member Function Documentation

◆ _Font()

◆ cachedFont()

◆ cacheFont()

◆ clearCache()

◆ defaultFont()

◆ initWithData() [1/2]

◆ initWithData() [2/2]

◆ renderCharacters()

◆ renderDeviceDidReset()

◆ sizeCharacters()

Field Documentation

◆ cacheFont

◆ data

◆ family

◆ font

◆ interface

◆ object

◆ renderSize

◆ scale

◆ size

◆ style