text.h

Go to the documentation of this file.

#pragma once
 
#include <stddef.h>
#include <stdint.h>
 
#include "tinyimg/image.h"
#include "tinyimg/memory.h"
#include "tinyimg/tinyimg.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#pragma region font loading

typedef enum TinyFontKind
{
    TINYIMG_FONT_TRUETYPE = 0,
    TINYIMG_FONT_PSF = 1,
    TINYIMG_FONT_BDF = 2,
} TinyFontKind;

#define TINYIMG_FONT_MAX_AXES 4

typedef struct {
    uint32_t tag;
    float min;
    float def;
    float max;
} TinyFontAxis;

#define TINYIMG_AXIS_WEIGHT 0x77676874u
#define TINYIMG_AXIS_WIDTH 0x77647468u
#define TINYIMG_AXIS_SLANT 0x736C6E74u
#define TINYIMG_AXIS_ITALIC 0x6974616Cu
#define TINYIMG_AXIS_OPTICAL_SIZE 0x6F70737Au

#define TINYIMG_FONT_MAX_FALLBACK 4

typedef struct {
    const uint8_t* data;
    size_t size;
    TinyFontKind kind;

    uint32_t cmap;
    uint32_t glyf;
    uint32_t loca;
    uint32_t hmtx;
    uint32_t kern;
    uint32_t gpos_kern;
    uint32_t gpos_subtables;
    uint32_t gsub_liga;
    uint32_t gsub_subtables;
    uint32_t glyf_size;
    uint32_t glyphs;
    uint32_t hmetrics;
    uint32_t units_per_em;
    uint8_t long_loca;

    uint32_t fvar;
    uint32_t gvar;
    uint32_t avar;
    uint32_t axes;
    float coords[TINYIMG_FONT_MAX_AXES];
    uint8_t varied;

    int32_t ascent;
    int32_t descent;
    int32_t line_gap;

    uint32_t cell_width;
    uint32_t cell_height;
    uint32_t glyph_bytes;
    uint32_t bitmap;

    uint32_t* index;
    uint32_t index_count;
} TinyFont;

typedef struct {
    const TinyFont* face[TINYIMG_FONT_MAX_FALLBACK];
    uint32_t count;
} TinyFontSet;

int tiny_font_set_init(TinyFontSet* set);

int tiny_font_set_add(TinyFontSet* set, const TinyFont* font);

const TinyFont* tiny_font_set_for(const TinyFontSet* set, uint32_t codepoint);

typedef struct {
    float ascent;
    float descent;
    float line_height;
    float size;
    uint32_t glyphs;
    uint8_t fixed_size;
} TinyFontMetrics;

uint32_t tiny_font_axis_count(const TinyFont* font);

int tiny_font_axis(const TinyFont* font, uint32_t index, TinyFontAxis* out);

int tiny_font_set_axis(TinyFont* font, uint32_t tag, float value);

int tiny_font_reset_axes(TinyFont* font);

int tiny_font_load(TinyFont* font, const char* blob_id);

int tiny_font_load_bytes(TinyFont* font, const uint8_t* data, size_t size);

void tiny_font_free(TinyFont* font);

int tiny_font_metrics(const TinyFont* font, float size, TinyFontMetrics* out);

int tiny_font_has_glyph(const TinyFont* font, uint32_t codepoint);

uint32_t tiny_font_sizeof(void);

uint32_t tiny_font_metrics_sizeof(void);
 
#pragma endregion
 
#pragma region text drawing

typedef struct {
    float size;
    float tracking;
    float line_height;
    float stroke;
    float shadow_x;
    float shadow_y;
    float shadow_blur;
    uint8_t kerning;
    uint8_t stroke_color[4];
    uint8_t shadow_color[4];
} TinyTextStyle;

typedef struct {
    float width;
    float height;
    float ascent;
    float descent;
    float line_height;
    uint32_t lines;
    uint32_t glyphs;
    uint32_t missing;
} TinyTextMetrics;

typedef enum TinyTextAlign
{
    TINYIMG_ALIGN_LEFT = 0,
    TINYIMG_ALIGN_CENTER = 1,
    TINYIMG_ALIGN_RIGHT = 2,
    TINYIMG_ALIGN_JUSTIFY = 3,
} TinyTextAlign;

typedef enum TinyTextVAlign
{
    TINYIMG_VALIGN_TOP = 0,
    TINYIMG_VALIGN_MIDDLE = 1,
    TINYIMG_VALIGN_BOTTOM = 2,
} TinyTextVAlign;

typedef enum TinyTextOverflow
{
    TINYIMG_OVERFLOW_CLIP = 0,
    TINYIMG_OVERFLOW_ELLIPSIS = 1,
} TinyTextOverflow;

typedef struct {
    uint32_t width;
    uint32_t height;
    TinyTextAlign align;
    TinyTextVAlign valign;
    TinyTextOverflow overflow;
} TinyTextBox;

typedef struct {
    uint32_t at;
    uint32_t length;
    float width;
    float x;
    float y;
    float baseline;
    uint32_t glyphs;
    uint32_t missing;
    uint8_t clipped;
    uint8_t ellipsized;
} TinyTextLine;

void tiny_text_style(TinyTextStyle* style, float size);

int tiny_image_draw_text(
    TinyImage* image, const TinyFont* font, const char* text, int32_t x,
    int32_t y, const TinyTextStyle* style, const uint8_t* color
);

int tiny_image_draw_text_box(
    TinyImage* image, const TinyFont* font, const char* text, int32_t x,
    int32_t y, uint32_t width, uint32_t height, const TinyTextStyle* style,
    TinyTextAlign align, const uint8_t* color
);

int tiny_image_draw_text_in(
    TinyImage* image, const TinyFont* font, const char* text, int32_t x,
    int32_t y, const TinyTextBox* box, const TinyTextStyle* style,
    const uint8_t* color
);

#define TINYIMG_TEXT_MAX_RUNS 16

typedef struct {
    const TinyFont* font;
    const char* text;
    const TinyTextStyle* style;
    const uint8_t* color;
} TinyTextRun;

int tiny_image_draw_text_set(
    TinyImage* image, const TinyFontSet* set, const char* text, int32_t x,
    int32_t y, const TinyTextBox* box, const TinyTextStyle* style,
    const uint8_t* color
);

int tiny_text_measure_set(
    const TinyFontSet* set, const char* text, const TinyTextBox* box,
    const TinyTextStyle* style, TinyTextMetrics* out
);

int tiny_image_draw_text_runs(
    TinyImage* image, const TinyTextRun* runs, uint32_t count, int32_t x,
    int32_t y, const TinyTextBox* box, const uint8_t* color
);

int tiny_text_measure_runs(
    const TinyTextRun* runs, uint32_t count, const TinyTextBox* box,
    TinyTextMetrics* out
);

int tiny_text_lines(
    const TinyFont* font, const char* text, const TinyTextBox* box,
    const TinyTextStyle* style, TinyTextLine* lines, uint32_t capacity,
    uint32_t* count
);

int tiny_text_measure(
    const TinyFont* font, const char* text, const TinyTextStyle* style,
    TinyTextMetrics* out
);

int tiny_text_measure_wrapped(
    const TinyFont* font, const char* text, uint32_t width,
    const TinyTextStyle* style, TinyTextMetrics* out
);

uint32_t tiny_text_style_sizeof(void);

uint32_t tiny_text_box_sizeof(void);

uint32_t tiny_text_line_sizeof(void);

uint32_t tiny_text_metrics_sizeof(void);
 
#pragma endregion
 
#ifdef __cplusplus
}
#endif