vg_freetype.h

Go to the documentation of this file.

/*
 * C
 *
 * Copyright 2020-2026 MicroEJ Corp. All rights reserved.
 * MicroEJ Corp. PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
 *
 * Build: 7E4D1F7C
 */
 
#if !defined VG_FREETYPE_H
#define VG_FREETYPE_H
 
#if defined __cplusplus
extern "C" {
#endif
 
#include "vg_configuration.h"
 
#if defined VG_FEATURE_FONT &&                                                              \
    (defined VG_FEATURE_FONT_FREETYPE_VECTOR || defined VG_FEATURE_FONT_FREETYPE_BITMAP) && \
    (VG_FEATURE_FONT == VG_FEATURE_FONT_FREETYPE_VECTOR || VG_FEATURE_FONT == VG_FEATURE_FONT_FREETYPE_BITMAP)
 
// -----------------------------------------------------------------------------
// Includes
// -----------------------------------------------------------------------------
 
#include "vg_path.h"
 
// --------------------------------------------------------------------------------
// Typedef
// --------------------------------------------------------------------------------
 
typedef jint (* VG_FREETYPE_draw_glyph_t) (
    /*
     * @brief The path of the glyph.
     */
    VG_PATH_HEADER_t *path,
 
    /*
     * @brief The deformation to apply on the path.
     */
    jfloat *matrix,
 
    /*
     * @brief The specific glyph color (example: emoji) or the current destination
     * color. Useless if the string is drawn with a gradient.
     */
    uint32_t color,
 
    /*
     * @brief The glyph outline: true: EVEN_ODD or false: NON_ZERO.
     */
    bool fill_rule_even_odd,
 
    /*
     * @brief The custom drawer data (may be null). For instance this structure can
     * hold the gradient if the GPU's drawing function requires it. In case of
     * the gradient is set before calling VG_FREETYPE_draw_string(), the
     * gradient doesn't need to be stored in this structure.
     */
    void *user_data);
 
// --------------------------------------------------------------------------------
// API
// --------------------------------------------------------------------------------
 
void VG_FREETYPE_initialize(void);
 
bool VG_FREETYPE_string_span(const jchar *text, jint length, jint face_handle, jfloat letter_spacing_font_units,
                             jfloat *left, jfloat *right);
 
jfloat VG_FREETYPE_string_width(jchar *text, jint length, jint face_handle, jfloat size, jfloat letter_spacing);
 
jfloat VG_FREETYPE_get_scale(jint face_handle, jfloat size);
 
jint VG_FREETYPE_draw_string(VG_FREETYPE_draw_glyph_t drawer, const jchar *text, jint length, jint face_handle,
                             jfloat size, const jfloat *matrix, uint32_t color, jfloat letter_spacing, jfloat radius,
                             jint direction, void *user_data);
 
// -----------------------------------------------------------------------------
// Implementation
// -----------------------------------------------------------------------------
 
/*
 * @brief Converts an ARGB8888 color to a format compatible with the GPU. The default
 * implementation does nothing and just returns the original color.
 */
jint VG_FREETYPE_IMPL_convert_color(jint color);
 
// -----------------------------------------------------------------------------
// EOF
// -----------------------------------------------------------------------------
#endif \
    // defined VG_FEATURE_FONT && \
    // (defined VG_FEATURE_FONT_FREETYPE_VECTOR || defined VG_FEATURE_FONT_FREETYPE_BITMAP) && \
    // (VG_FEATURE_FONT == VG_FEATURE_FONT_FREETYPE_VECTOR || VG_FEATURE_FONT == VG_FEATURE_FONT_FREETYPE_BITMAP)
 
#ifdef __cplusplus
}
#endif
 
#endif // !defined VG_FREETYPE_H