/* * Copyright © 2026 Behdad Esfahbod * * This is part of HarfBuzz, a text shaping library. * * Permission is hereby granted, without written agreement and without * license or royalty fees, to use, copy, modify, and distribute this * software and its documentation for any purpose, provided that the * above copyright notice and the following two paragraphs appear in * all copies of this software. * * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH * DAMAGE. * * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. * * Author(s): Behdad Esfahbod */ #include "hb.hh" #include "hb-machinery.hh" #include "hb-vector-buf.hh" /** * SECTION:hb-vector * @title: hb-vector * @short_description: Glyph vector conversion * @include: hb-vector.h * * Functions for converting glyph outlines and color paint trees * into SVG or PDF vector output. * * #hb_vector_draw_t converts monochrome glyph outlines into vector * paths. Typical flow: * * |[ * hb_vector_draw_t *draw = hb_vector_draw_create_or_fail (HB_VECTOR_FORMAT_SVG); * hb_vector_draw_set_scale_factor (draw, 64.f, 64.f); * hb_vector_draw_set_foreground (draw, foreground); * hb_vector_draw_glyph (draw, font, gid, pen_x, pen_y); * hb_blob_t *svg = hb_vector_draw_render (draw); * ]| * * #hb_vector_paint_t renders color paint graphs (COLRv0/v1) and * embedded PNG images into vector output with gradients, layers, * and compositing. Typical flow: * * |[ * hb_vector_paint_t *paint = hb_vector_paint_create_or_fail (HB_VECTOR_FORMAT_SVG); * hb_vector_paint_set_scale_factor (paint, 64.f, 64.f); * hb_vector_paint_set_foreground (paint, foreground); * hb_vector_paint_glyph (paint, font, gid, pen_x, pen_y, * HB_VECTOR_EXTENTS_MODE_EXPAND); * hb_blob_t *svg = hb_vector_paint_render (paint); * ]| * * Both contexts accumulate multiple glyphs into a single document. * Call hb_vector_draw_render() / hb_vector_paint_render() to * retrieve the final blob. Rendering clears all accumulated * content (including extents), so retrieve any needed extents * via hb_vector_draw_get_extents() / hb_vector_paint_get_extents() * before rendering. * * Each glyph is emitted as an independent element. If glyphs * overlap and the foreground color is semi-transparent, the * overlapping regions will be composited separately rather than * painted as a single uniform layer. **/ struct hb_vector_decimal_point_t { char value[8]; }; static hb_vector_decimal_point_t hb_vector_decimal_point_default = {{'.', '\0'}}; static inline void free_static_svg_decimal_point (); static struct hb_vector_decimal_point_lazy_loader_t : hb_lazy_loader_t { static hb_vector_decimal_point_t *create () { auto *p = (hb_vector_decimal_point_t *) hb_calloc (1, sizeof (hb_vector_decimal_point_t)); if (!p) return nullptr; p->value[0] = '.'; p->value[1] = '\0'; #ifndef HB_NO_SETLOCALE lconv *lc = nullptr; #ifdef HAVE_LOCALECONV_L hb_locale_t current_locale = hb_uselocale ((hb_locale_t) 0); if (current_locale) lc = localeconv_l (current_locale); #endif if (!lc) lc = localeconv (); if (lc && lc->decimal_point && lc->decimal_point[0]) { strncpy (p->value, lc->decimal_point, sizeof (p->value) - 1); p->value[sizeof (p->value) - 1] = '\0'; } #endif hb_atexit (free_static_svg_decimal_point); return p; } static void destroy (hb_vector_decimal_point_t *p) { hb_free (p); } static const hb_vector_decimal_point_t *get_null () { return &hb_vector_decimal_point_default; } } static_svg_decimal_point; static inline void free_static_svg_decimal_point () { static_svg_decimal_point.free_instance (); } const char * hb_vector_decimal_point_get (void) { return static_svg_decimal_point.get_unconst ()->value; }