/* * Copyright © 2009 Red Hat, Inc. * Copyright © 2011 Codethink Limited * Copyright © 2010,2011,2012 Google, Inc. * * 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. * * Red Hat Author(s): Behdad Esfahbod * Codethink Author(s): Ryan Lortie * Google Author(s): Behdad Esfahbod */ #include "hb.hh" #include "hb-unicode.hh" /** * SECTION: hb-unicode * @title: hb-unicode * @short_description: Unicode character property access * @include: hb.h * * Unicode functions are used to access Unicode character properties. * With these functions, client programs can query various properties from * the Unicode Character Database for any code point, such as General * Category (gc), Script (sc), Canonical Combining Class (ccc), etc. * * Client programs can optionally pass in their own Unicode functions * that implement the same queries. The set of functions available is * defined by the virtual methods in #hb_unicode_funcs_t. * * HarfBuzz provides built-in default functions for each method in * #hb_unicode_funcs_t. **/ /* * hb_unicode_funcs_t */ static hb_unicode_combining_class_t hb_unicode_combining_class_nil (hb_unicode_funcs_t *ufuncs HB_UNUSED, hb_codepoint_t unicode HB_UNUSED, void *user_data HB_UNUSED) { … } #ifndef HB_DISABLE_DEPRECATED static unsigned int hb_unicode_eastasian_width_nil (hb_unicode_funcs_t *ufuncs HB_UNUSED, hb_codepoint_t unicode HB_UNUSED, void *user_data HB_UNUSED) { … } #endif static hb_unicode_general_category_t hb_unicode_general_category_nil (hb_unicode_funcs_t *ufuncs HB_UNUSED, hb_codepoint_t unicode HB_UNUSED, void *user_data HB_UNUSED) { … } static hb_codepoint_t hb_unicode_mirroring_nil (hb_unicode_funcs_t *ufuncs HB_UNUSED, hb_codepoint_t unicode, void *user_data HB_UNUSED) { … } static hb_script_t hb_unicode_script_nil (hb_unicode_funcs_t *ufuncs HB_UNUSED, hb_codepoint_t unicode HB_UNUSED, void *user_data HB_UNUSED) { … } static hb_bool_t hb_unicode_compose_nil (hb_unicode_funcs_t *ufuncs HB_UNUSED, hb_codepoint_t a HB_UNUSED, hb_codepoint_t b HB_UNUSED, hb_codepoint_t *ab HB_UNUSED, void *user_data HB_UNUSED) { … } static hb_bool_t hb_unicode_decompose_nil (hb_unicode_funcs_t *ufuncs HB_UNUSED, hb_codepoint_t ab HB_UNUSED, hb_codepoint_t *a HB_UNUSED, hb_codepoint_t *b HB_UNUSED, void *user_data HB_UNUSED) { … } #ifndef HB_DISABLE_DEPRECATED static unsigned int hb_unicode_decompose_compatibility_nil (hb_unicode_funcs_t *ufuncs HB_UNUSED, hb_codepoint_t u HB_UNUSED, hb_codepoint_t *decomposed HB_UNUSED, void *user_data HB_UNUSED) { … } #endif #if !defined(HB_NO_UNICODE_FUNCS) && defined(HAVE_GLIB) #include "hb-glib.h" #endif #if !defined(HB_NO_UNICODE_FUNCS) && defined(HAVE_ICU) && defined(HAVE_ICU_BUILTIN) #include "hb-icu.h" #endif /** * hb_unicode_funcs_get_default: * * Fetches a pointer to the default Unicode-functions structure that is used * when no functions are explicitly set on #hb_buffer_t. * * Return value: (transfer none): a pointer to the #hb_unicode_funcs_t Unicode-functions structure * * Since: 0.9.2 **/ hb_unicode_funcs_t * hb_unicode_funcs_get_default () { … } #if !defined(HB_NO_UNICODE_FUNCS) && defined(HB_UNICODE_FUNCS_NIL) #error "Could not find any Unicode functions implementation, you have to provide your own" #error "Consider building hb-ucd.cc. If you absolutely want to build without any, define HB_NO_UNICODE_FUNCS." #endif /** * hb_unicode_funcs_create: * @parent: (nullable): Parent Unicode-functions structure * * Creates a new #hb_unicode_funcs_t structure of Unicode functions. * * Return value: (transfer full): The Unicode-functions structure * * Since: 0.9.2 **/ hb_unicode_funcs_t * hb_unicode_funcs_create (hb_unicode_funcs_t *parent) { … } DEFINE_NULL_INSTANCE (hb_unicode_funcs_t) = …; /** * hb_unicode_funcs_get_empty: * * Fetches the singleton empty Unicode-functions structure. * * Return value: (transfer full): The empty Unicode-functions structure * * Since: 0.9.2 **/ hb_unicode_funcs_t * hb_unicode_funcs_get_empty () { … } /** * hb_unicode_funcs_reference: (skip) * @ufuncs: The Unicode-functions structure * * Increases the reference count on a Unicode-functions structure. * * Return value: (transfer full): The Unicode-functions structure * * Since: 0.9.2 **/ hb_unicode_funcs_t * hb_unicode_funcs_reference (hb_unicode_funcs_t *ufuncs) { … } /** * hb_unicode_funcs_destroy: (skip) * @ufuncs: The Unicode-functions structure * * Decreases the reference count on a Unicode-functions structure. When * the reference count reaches zero, the Unicode-functions structure is * destroyed, freeing all memory. * * Since: 0.9.2 **/ void hb_unicode_funcs_destroy (hb_unicode_funcs_t *ufuncs) { … } /** * hb_unicode_funcs_set_user_data: (skip) * @ufuncs: The Unicode-functions structure * @key: The user-data key * @data: A pointer to the user data * @destroy: (nullable): A callback to call when @data is not needed anymore * @replace: Whether to replace an existing data with the same key * * Attaches a user-data key/data pair to the specified Unicode-functions structure. * * Return value: `true` if success, `false` otherwise * * Since: 0.9.2 **/ hb_bool_t hb_unicode_funcs_set_user_data (hb_unicode_funcs_t *ufuncs, hb_user_data_key_t *key, void * data, hb_destroy_func_t destroy, hb_bool_t replace) { … } /** * hb_unicode_funcs_get_user_data: (skip) * @ufuncs: The Unicode-functions structure * @key: The user-data key to query * * Fetches the user-data associated with the specified key, * attached to the specified Unicode-functions structure. * * Return value: (transfer none): A pointer to the user data * * Since: 0.9.2 **/ void * hb_unicode_funcs_get_user_data (const hb_unicode_funcs_t *ufuncs, hb_user_data_key_t *key) { … } /** * hb_unicode_funcs_make_immutable: * @ufuncs: The Unicode-functions structure * * Makes the specified Unicode-functions structure * immutable. * * Since: 0.9.2 **/ void hb_unicode_funcs_make_immutable (hb_unicode_funcs_t *ufuncs) { … } /** * hb_unicode_funcs_is_immutable: * @ufuncs: The Unicode-functions structure * * Tests whether the specified Unicode-functions structure * is immutable. * * Return value: `true` if @ufuncs is immutable, `false` otherwise * * Since: 0.9.2 **/ hb_bool_t hb_unicode_funcs_is_immutable (hb_unicode_funcs_t *ufuncs) { … } /** * hb_unicode_funcs_get_parent: * @ufuncs: The Unicode-functions structure * * Fetches the parent of the Unicode-functions structure * @ufuncs. * * Return value: The parent Unicode-functions structure * * Since: 0.9.2 **/ hb_unicode_funcs_t * hb_unicode_funcs_get_parent (hb_unicode_funcs_t *ufuncs) { … } #define HB_UNICODE_FUNC_IMPLEMENT … HB_UNICODE_FUNCS_IMPLEMENT_CALLBACKS #undef HB_UNICODE_FUNC_IMPLEMENT #define HB_UNICODE_FUNC_IMPLEMENT … HB_UNICODE_FUNCS_IMPLEMENT_CALLBACKS_SIMPLE #undef HB_UNICODE_FUNC_IMPLEMENT /** * hb_unicode_compose: * @ufuncs: The Unicode-functions structure * @a: The first Unicode code point to compose * @b: The second Unicode code point to compose * @ab: (out): The composition of @a, @b * * Fetches the composition of a sequence of two Unicode * code points. * * Calls the composition function of the specified * Unicode-functions structure @ufuncs. * * Return value: `true` if @a and @b composed, `false` otherwise * * Since: 0.9.2 **/ hb_bool_t hb_unicode_compose (hb_unicode_funcs_t *ufuncs, hb_codepoint_t a, hb_codepoint_t b, hb_codepoint_t *ab) { … } /** * hb_unicode_decompose: * @ufuncs: The Unicode-functions structure * @ab: Unicode code point to decompose * @a: (out): The first code point of the decomposition of @ab * @b: (out): The second code point of the decomposition of @ab * * Fetches the decomposition of a Unicode code point. * * Calls the decomposition function of the specified * Unicode-functions structure @ufuncs. * * Return value: `true` if @ab was decomposed, `false` otherwise * * Since: 0.9.2 **/ hb_bool_t hb_unicode_decompose (hb_unicode_funcs_t *ufuncs, hb_codepoint_t ab, hb_codepoint_t *a, hb_codepoint_t *b) { … } #ifndef HB_DISABLE_DEPRECATED /** * hb_unicode_decompose_compatibility: * @ufuncs: The Unicode-functions structure * @u: Code point to decompose * @decomposed: (out): Compatibility decomposition of @u * * Fetches the compatibility decomposition of a Unicode * code point. Deprecated. * * Return value: length of @decomposed. * * Since: 0.9.2 * Deprecated: 2.0.0 **/ unsigned int hb_unicode_decompose_compatibility (hb_unicode_funcs_t *ufuncs, hb_codepoint_t u, hb_codepoint_t *decomposed) { … } #endif #ifndef HB_NO_OT_SHAPE /* See hb-unicode.hh for details. */ const uint8_t _hb_modified_combining_class[256] = …; #endif /* * Emoji */ #ifndef HB_NO_EMOJI_SEQUENCES #include "hb-unicode-emoji-table.hh" bool _hb_unicode_is_emoji_Extended_Pictographic (hb_codepoint_t cp) { … } #endif