gp_text.h

Go to the documentation of this file.

// SPDX-License-Identifier: LGPL-2.1-or-later
/*
 * Copyright (C) 2009-2011 Jiri "BlueBear" Dluhos
 *                         <jiri.bluebear.dluhos@gmail.com>
 *
 * Copyright (C) 2009-2024 Cyril Hrubis <metan@ucw.cz>
 */
 
#ifndef TEXT_GP_TEXT_H
#define TEXT_GP_TEXT_H
 
#include <stdarg.h>
 
#include <core/gp_types.h>
#include <core/gp_compiler.h>
#include <text/gp_text_style.h>
#include <text/gp_text_metric.h>
#include <text/gp_fonts.h>
 
typedef enum gp_text_flags {
        GP_ALIGN_LEFT = 0x01,
        GP_ALIGN_CENTER = 0x02,
        GP_ALIGN_RIGHT = 0x03,
        GP_ALIGN_HORIZ = 0x03,
        GP_TEXT_BEARING = 0x04,
        GP_VALIGN_ABOVE = 0x10,
        GP_VALIGN_TOP = GP_VALIGN_ABOVE,
        GP_VALIGN_CENTER = 0x20,
        GP_VALIGN_BASELINE = 0x30,
        GP_VALIGN_BELOW = 0x40,
        GP_VALIGN_BOTTOM = GP_VALIGN_BELOW,
        GP_VALIGN_VERT = 0x70,
        GP_TEXT_NOBG = 0x80,
} gp_text_flags;
 
gp_size gp_text_raw(gp_pixmap *pixmap, const gp_text_style *style,
                    gp_coord x, gp_coord y, gp_text_flags flags,
                    gp_pixel fg_color, gp_pixel bg_color,
                    const char *str, size_t max_chars);
 
gp_size gp_text(gp_pixmap *pixmap, const gp_text_style *style,
                gp_coord x, gp_coord y, gp_text_flags flags,
                gp_pixel fg_color, gp_pixel bg_color, const char *str);
 
gp_size gp_glyph_draw(gp_pixmap *pixmap, const gp_text_style *style,
                      gp_coord x, gp_coord y, int flags,
                      gp_pixel fg_color, gp_pixel bg_color,
                      uint32_t glyph);
 
static inline gp_size gp_text_xxy(gp_pixmap *pixmap, const gp_text_style *style,
                                  gp_coord x1, gp_coord x2, gp_coord y, gp_text_flags flags,
                                  gp_pixel fg_color, gp_pixel bg_color, const char *str)
{
        gp_coord x, len;
 
        if (x1 < x2) {
                x = x1;
                len = x2 - x1;
        } else {
                x = x2;
                len = x1 - x2;
        }
 
        int halign = flags & GP_ALIGN_HORIZ;
 
        flags &= ~GP_ALIGN_HORIZ;
 
        switch (halign) {
        case GP_ALIGN_LEFT:
                flags |= GP_ALIGN_RIGHT;
        break;
        case GP_ALIGN_CENTER:
                x += len/2;
                flags |= GP_ALIGN_CENTER;
        break;
        case GP_ALIGN_RIGHT:
                x += len;
                flags |= GP_ALIGN_LEFT;
        break;
        }
 
        return gp_text(pixmap, style, x, y, flags, fg_color, bg_color, str);
}
 
/*
 * Same as the gp_text() but the number of characters can be limited.
 */
gp_size gp_text_ext(gp_pixmap *pixmap, const gp_text_style *style,
                    gp_coord x, gp_coord y, gp_text_flags flags,
                    gp_pixel fg_color, gp_pixel bg_color,
                    const char *str, size_t max_chars);
 
gp_size gp_print(gp_pixmap *pixmap, const gp_text_style *style,
                 gp_coord x, gp_coord y, gp_text_flags flags,
                 gp_pixel fg_color, gp_pixel bg_color, const char *fmt, ...)
                 GP_FMT_PRINTF(8, 9);
 
gp_size gp_vprint(gp_pixmap *pixmap, const gp_text_style *style,
                  gp_coord x, gp_coord y, gp_text_flags flags,
                  gp_pixel fg_color, gp_pixel bg_color,
                  const char *fmt, va_list va)
                  GP_FMT_PRINTF(8, 0);
 
GP_FMT_PRINTF(9, 10)
static inline gp_size gp_print_xxy(gp_pixmap *pixmap, const gp_text_style *style,
                                   gp_coord x1, gp_coord x2, gp_coord y, gp_text_flags flags,
                                   gp_pixel fg_color, gp_pixel bg_color, const char *fmt, ...)
{
        gp_coord x, len;
        gp_size ret;
        va_list va;
 
        if (x1 < x2) {
                x = x1;
                len = x2 - x1;
        } else {
                x = x2;
                len = x1 - x2;
        }
 
        int halign = flags & GP_ALIGN_HORIZ;
 
        flags &= ~GP_ALIGN_HORIZ;
 
        switch (halign) {
        case GP_ALIGN_LEFT:
                flags |= GP_ALIGN_RIGHT;
        break;
        case GP_ALIGN_CENTER:
                x += len/2;
                flags |= GP_ALIGN_CENTER;
        break;
        case GP_ALIGN_RIGHT:
                x += len;
                flags |= GP_ALIGN_LEFT;
        break;
        }
 
        va_start(va, fmt);
        ret = gp_vprint(pixmap, style, x, y, flags, fg_color, bg_color, fmt, va);
        va_end(va);
 
        return ret;
}
 
void gp_text_clear(gp_pixmap *pixmap, const gp_text_style *style,
                   gp_coord x, gp_coord y, gp_text_flags flags,
                   gp_pixel bg_color, gp_size size);
 
/*
 * Dtto, but with string.
 */
void gp_text_clear_str(gp_pixmap *pixmap, const gp_text_style *style,
                       gp_coord x, gp_coord y, gp_text_flags flags,
                       gp_pixel bg_color, const char *str);
 
#endif /* TEXT_GP_TEXT_H */