137 lines
4.4 KiB
C++
137 lines
4.4 KiB
C++
/*
|
|
* 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:
|
|
*
|
|
* |[<!-- language="plain" -->
|
|
* 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:
|
|
*
|
|
* |[<!-- language="plain" -->
|
|
* 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<hb_vector_decimal_point_t, hb_vector_decimal_point_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;
|
|
}
|