forked from KolibriOS/kolibrios
721 lines
28 KiB
C
721 lines
28 KiB
C
|
/* cairo - a vector graphics library with display and print output
|
||
|
|
*
|
||
|
|
* Copyright © 2006 Red Hat, Inc
|
||
|
|
*
|
||
|
|
* This library is free software; you can redistribute it and/or
|
||
|
|
* modify it either under the terms of the GNU Lesser General Public
|
||
|
|
* License version 2.1 as published by the Free Software Foundation
|
||
|
|
* (the "LGPL") or, at your option, under the terms of the Mozilla
|
||
|
|
* Public License Version 1.1 (the "MPL"). If you do not alter this
|
||
|
|
* notice, a recipient may use your version of this file under either
|
||
|
|
* the MPL or the LGPL.
|
||
|
|
*
|
||
|
|
* You should have received a copy of the LGPL along with this library
|
||
|
|
* in the file COPYING-LGPL-2.1; if not, write to the Free Software
|
||
|
|
* Foundation, Inc., 51 Franklin Street, Suite 500, Boston, MA 02110-1335, USA
|
||
|
|
* You should have received a copy of the MPL along with this library
|
||
|
|
* in the file COPYING-MPL-1.1
|
||
|
|
*
|
||
|
|
* The contents of this file are subject to the Mozilla Public License
|
||
|
|
* Version 1.1 (the "License"); you may not use this file except in
|
||
|
|
* compliance with the License. You may obtain a copy of the License at
|
||
|
|
* http://www.mozilla.org/MPL/
|
||
|
|
*
|
||
|
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY
|
||
|
|
* OF ANY KIND, either express or implied. See the LGPL or the MPL for
|
||
|
|
* the specific language governing rights and limitations.
|
||
|
|
*
|
||
|
|
* The Original Code is the cairo graphics library.
|
||
|
|
*
|
||
|
|
* The Initial Developer of the Original Code is University of Southern
|
||
|
|
* California.
|
||
|
|
*
|
||
|
|
* Contributor(s):
|
||
|
|
* Carl D. Worth <cworth@cworth.org>
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef CAIRO_SCALED_FONT_SUBSETS_PRIVATE_H
|
||
|
|
#define CAIRO_SCALED_FONT_SUBSETS_PRIVATE_H
|
||
|
|
|
||
|
|
#include "cairoint.h"
|
||
|
|
|
||
|
|
#if CAIRO_HAS_FONT_SUBSET
|
||
|
|
|
||
|
|
typedef struct _cairo_scaled_font_subsets_glyph {
|
||
|
|
unsigned int font_id;
|
||
|
|
unsigned int subset_id;
|
||
|
|
unsigned int subset_glyph_index;
|
||
|
|
cairo_bool_t is_scaled;
|
||
|
|
cairo_bool_t is_composite;
|
||
|
|
cairo_bool_t is_latin;
|
||
|
|
double x_advance;
|
||
|
|
double y_advance;
|
||
|
|
cairo_bool_t utf8_is_mapped;
|
||
|
|
uint32_t unicode;
|
||
|
|
} cairo_scaled_font_subsets_glyph_t;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_scaled_font_subsets_create_scaled:
|
||
|
|
*
|
||
|
|
* Create a new #cairo_scaled_font_subsets_t object which can be used
|
||
|
|
* to create subsets of any number of #cairo_scaled_font_t
|
||
|
|
* objects. This allows the (arbitrarily large and sparse) glyph
|
||
|
|
* indices of a #cairo_scaled_font_t to be mapped to one or more font
|
||
|
|
* subsets with glyph indices packed into the range
|
||
|
|
* [0 .. max_glyphs_per_subset).
|
||
|
|
*
|
||
|
|
* Return value: a pointer to the newly creates font subsets. The
|
||
|
|
* caller owns this object and should call
|
||
|
|
* _cairo_scaled_font_subsets_destroy() when done with it.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_scaled_font_subsets_t *
|
||
|
|
_cairo_scaled_font_subsets_create_scaled (void);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_scaled_font_subsets_create_simple:
|
||
|
|
*
|
||
|
|
* Create a new #cairo_scaled_font_subsets_t object which can be used
|
||
|
|
* to create font subsets suitable for embedding as Postscript or PDF
|
||
|
|
* simple fonts.
|
||
|
|
*
|
||
|
|
* Glyphs with an outline path available will be mapped to one font
|
||
|
|
* subset for each font face. Glyphs from bitmap fonts will mapped to
|
||
|
|
* separate font subsets for each #cairo_scaled_font_t object.
|
||
|
|
*
|
||
|
|
* The maximum number of glyphs per subset is 256. Each subset
|
||
|
|
* reserves the first glyph for the .notdef glyph.
|
||
|
|
*
|
||
|
|
* Return value: a pointer to the newly creates font subsets. The
|
||
|
|
* caller owns this object and should call
|
||
|
|
* _cairo_scaled_font_subsets_destroy() when done with it.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_scaled_font_subsets_t *
|
||
|
|
_cairo_scaled_font_subsets_create_simple (void);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_scaled_font_subsets_create_composite:
|
||
|
|
*
|
||
|
|
* Create a new #cairo_scaled_font_subsets_t object which can be used
|
||
|
|
* to create font subsets suitable for embedding as Postscript or PDF
|
||
|
|
* composite fonts.
|
||
|
|
*
|
||
|
|
* Glyphs with an outline path available will be mapped to one font
|
||
|
|
* subset for each font face. Each unscaled subset has a maximum of
|
||
|
|
* 65536 glyphs except for Type1 fonts which have a maximum of 256 glyphs.
|
||
|
|
*
|
||
|
|
* Glyphs from bitmap fonts will mapped to separate font subsets for
|
||
|
|
* each #cairo_scaled_font_t object. Each unscaled subset has a maximum
|
||
|
|
* of 256 glyphs.
|
||
|
|
*
|
||
|
|
* Each subset reserves the first glyph for the .notdef glyph.
|
||
|
|
*
|
||
|
|
* Return value: a pointer to the newly creates font subsets. The
|
||
|
|
* caller owns this object and should call
|
||
|
|
* _cairo_scaled_font_subsets_destroy() when done with it.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_scaled_font_subsets_t *
|
||
|
|
_cairo_scaled_font_subsets_create_composite (void);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_scaled_font_subsets_destroy:
|
||
|
|
* @font_subsets: a #cairo_scaled_font_subsets_t object to be destroyed
|
||
|
|
*
|
||
|
|
* Destroys @font_subsets and all resources associated with it.
|
||
|
|
**/
|
||
|
|
cairo_private void
|
||
|
|
_cairo_scaled_font_subsets_destroy (cairo_scaled_font_subsets_t *font_subsets);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_scaled_font_subsets_enable_latin_subset:
|
||
|
|
* @font_subsets: a #cairo_scaled_font_subsets_t object to be destroyed
|
||
|
|
* @use_latin: a #cairo_bool_t indicating if a latin subset is to be used
|
||
|
|
*
|
||
|
|
* If enabled, all CP1252 characters will be placed in a separate
|
||
|
|
* 8-bit latin subset.
|
||
|
|
**/
|
||
|
|
cairo_private void
|
||
|
|
_cairo_scaled_font_subsets_enable_latin_subset (cairo_scaled_font_subsets_t *font_subsets,
|
||
|
|
cairo_bool_t use_latin);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_scaled_font_subsets_map_glyph:
|
||
|
|
* @font_subsets: a #cairo_scaled_font_subsets_t
|
||
|
|
* @scaled_font: the font of the glyph to be mapped
|
||
|
|
* @scaled_font_glyph_index: the index of the glyph to be mapped
|
||
|
|
* @utf8: a string of text encoded in UTF-8
|
||
|
|
* @utf8_len: length of @utf8 in bytes
|
||
|
|
* @subset_glyph_ret: return structure containing subset font and glyph id
|
||
|
|
*
|
||
|
|
* Map a glyph from a #cairo_scaled_font to a new index within a
|
||
|
|
* subset of that font. The mapping performed is from the tuple:
|
||
|
|
*
|
||
|
|
* (scaled_font, scaled_font_glyph_index)
|
||
|
|
*
|
||
|
|
* to the tuple:
|
||
|
|
*
|
||
|
|
* (font_id, subset_id, subset_glyph_index)
|
||
|
|
*
|
||
|
|
* This mapping is 1:1. If the input tuple has previously mapped, the
|
||
|
|
* the output tuple previously returned will be returned again.
|
||
|
|
*
|
||
|
|
* Otherwise, the return tuple will be constructed as follows:
|
||
|
|
*
|
||
|
|
* 1) There is a 1:1 correspondence between the input scaled_font
|
||
|
|
* value and the output font_id value. If no mapping has been
|
||
|
|
* previously performed with the scaled_font value then the
|
||
|
|
* smallest unused font_id value will be returned.
|
||
|
|
*
|
||
|
|
* 2) Within the set of output tuples of the same font_id value the
|
||
|
|
* smallest value of subset_id will be returned such that
|
||
|
|
* subset_glyph_index does not exceed max_glyphs_per_subset (as
|
||
|
|
* passed to _cairo_scaled_font_subsets_create()) and that the
|
||
|
|
* resulting tuple is unique.
|
||
|
|
*
|
||
|
|
* 3) The smallest value of subset_glyph_index is returned such that
|
||
|
|
* the resulting tuple is unique.
|
||
|
|
*
|
||
|
|
* The net result is that any #cairo_scaled_font_t will be represented
|
||
|
|
* by one or more font subsets. Each subset is effectively a tuple of
|
||
|
|
* (scaled_font, font_id, subset_id) and within each subset there
|
||
|
|
* exists a mapping of scaled_glyph_font_index to subset_glyph_index.
|
||
|
|
*
|
||
|
|
* This final description of a font subset is the same representation
|
||
|
|
* used by #cairo_scaled_font_subset_t as provided by
|
||
|
|
* _cairo_scaled_font_subsets_foreach.
|
||
|
|
*
|
||
|
|
* @utf8 and @utf8_len specify a string of unicode characters that the
|
||
|
|
* glyph @scaled_font_glyph_index maps to. If @utf8_is_mapped in
|
||
|
|
* @subset_glyph_ret is %TRUE, the font subsetting will (where index to
|
||
|
|
* unicode mapping is supported) ensure that @scaled_font_glyph_index
|
||
|
|
* maps to @utf8. If @utf8_is_mapped is %FALSE,
|
||
|
|
* @scaled_font_glyph_index has already been mapped to a different
|
||
|
|
* unicode string.
|
||
|
|
*
|
||
|
|
* The returned values in the #cairo_scaled_font_subsets_glyph_t struct are:
|
||
|
|
*
|
||
|
|
* @font_id: The font ID of the mapped glyph
|
||
|
|
* @subset_id : The subset ID of the mapped glyph within the @font_id
|
||
|
|
* @subset_glyph_index: The index of the mapped glyph within the @subset_id subset
|
||
|
|
* @is_scaled: If true, the mapped glyph is from a bitmap font, and separate font
|
||
|
|
* subset is created for each font scale used. If false, the outline of the mapped glyph
|
||
|
|
* is available. One font subset for each font face is created.
|
||
|
|
* @x_advance, @y_advance: When @is_scaled is true, @x_advance and @y_advance contain
|
||
|
|
* the x and y advance for the mapped glyph in device space.
|
||
|
|
* When @is_scaled is false, @x_advance and @y_advance contain the x and y advance for
|
||
|
|
* the the mapped glyph from an unhinted 1 point font.
|
||
|
|
* @utf8_is_mapped: If true the utf8 string provided to _cairo_scaled_font_subsets_map_glyph()
|
||
|
|
* is (or already was) the utf8 string mapped to this glyph. If false the glyph is already
|
||
|
|
* mapped to a different utf8 string.
|
||
|
|
* @unicode: the unicode character mapped to this glyph by the font backend.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful, or a non-zero
|
||
|
|
* value indicating an error. Possible errors include
|
||
|
|
* %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_scaled_font_subsets_map_glyph (cairo_scaled_font_subsets_t *font_subsets,
|
||
|
|
cairo_scaled_font_t *scaled_font,
|
||
|
|
unsigned long scaled_font_glyph_index,
|
||
|
|
const char * utf8,
|
||
|
|
int utf8_len,
|
||
|
|
cairo_scaled_font_subsets_glyph_t *subset_glyph_ret);
|
||
|
|
|
||
|
|
typedef cairo_int_status_t
|
||
|
|
(*cairo_scaled_font_subset_callback_func_t) (cairo_scaled_font_subset_t *font_subset,
|
||
|
|
void *closure);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_scaled_font_subsets_foreach_scaled:
|
||
|
|
* @font_subsets: a #cairo_scaled_font_subsets_t
|
||
|
|
* @font_subset_callback: a function to be called for each font subset
|
||
|
|
* @closure: closure data for the callback function
|
||
|
|
*
|
||
|
|
* Iterate over each unique scaled font subset as created by calls to
|
||
|
|
* _cairo_scaled_font_subsets_map_glyph(). A subset is determined by
|
||
|
|
* unique pairs of (font_id, subset_id) as returned by
|
||
|
|
* _cairo_scaled_font_subsets_map_glyph().
|
||
|
|
*
|
||
|
|
* For each subset, @font_subset_callback will be called and will be
|
||
|
|
* provided with both a #cairo_scaled_font_subset_t object containing
|
||
|
|
* all the glyphs in the subset as well as the value of @closure.
|
||
|
|
*
|
||
|
|
* The #cairo_scaled_font_subset_t object contains the scaled_font,
|
||
|
|
* the font_id, and the subset_id corresponding to all glyphs
|
||
|
|
* belonging to the subset. In addition, it contains an array providing
|
||
|
|
* a mapping between subset glyph indices and the original scaled font
|
||
|
|
* glyph indices.
|
||
|
|
*
|
||
|
|
* The index of the array corresponds to subset_glyph_index values
|
||
|
|
* returned by _cairo_scaled_font_subsets_map_glyph() while the
|
||
|
|
* values of the array correspond to the scaled_font_glyph_index
|
||
|
|
* values passed as input to the same function.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful, or a non-zero
|
||
|
|
* value indicating an error. Possible errors include
|
||
|
|
* %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_scaled_font_subsets_foreach_scaled (cairo_scaled_font_subsets_t *font_subsets,
|
||
|
|
cairo_scaled_font_subset_callback_func_t font_subset_callback,
|
||
|
|
void *closure);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_scaled_font_subsets_foreach_unscaled:
|
||
|
|
* @font_subsets: a #cairo_scaled_font_subsets_t
|
||
|
|
* @font_subset_callback: a function to be called for each font subset
|
||
|
|
* @closure: closure data for the callback function
|
||
|
|
*
|
||
|
|
* Iterate over each unique unscaled font subset as created by calls to
|
||
|
|
* _cairo_scaled_font_subsets_map_glyph(). A subset is determined by
|
||
|
|
* unique pairs of (font_id, subset_id) as returned by
|
||
|
|
* _cairo_scaled_font_subsets_map_glyph().
|
||
|
|
*
|
||
|
|
* For each subset, @font_subset_callback will be called and will be
|
||
|
|
* provided with both a #cairo_scaled_font_subset_t object containing
|
||
|
|
* all the glyphs in the subset as well as the value of @closure.
|
||
|
|
*
|
||
|
|
* The #cairo_scaled_font_subset_t object contains the scaled_font,
|
||
|
|
* the font_id, and the subset_id corresponding to all glyphs
|
||
|
|
* belonging to the subset. In addition, it contains an array providing
|
||
|
|
* a mapping between subset glyph indices and the original scaled font
|
||
|
|
* glyph indices.
|
||
|
|
*
|
||
|
|
* The index of the array corresponds to subset_glyph_index values
|
||
|
|
* returned by _cairo_scaled_font_subsets_map_glyph() while the
|
||
|
|
* values of the array correspond to the scaled_font_glyph_index
|
||
|
|
* values passed as input to the same function.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful, or a non-zero
|
||
|
|
* value indicating an error. Possible errors include
|
||
|
|
* %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_scaled_font_subsets_foreach_unscaled (cairo_scaled_font_subsets_t *font_subsets,
|
||
|
|
cairo_scaled_font_subset_callback_func_t font_subset_callback,
|
||
|
|
void *closure);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_scaled_font_subsets_foreach_user:
|
||
|
|
* @font_subsets: a #cairo_scaled_font_subsets_t
|
||
|
|
* @font_subset_callback: a function to be called for each font subset
|
||
|
|
* @closure: closure data for the callback function
|
||
|
|
*
|
||
|
|
* Iterate over each unique scaled font subset as created by calls to
|
||
|
|
* _cairo_scaled_font_subsets_map_glyph(). A subset is determined by
|
||
|
|
* unique pairs of (font_id, subset_id) as returned by
|
||
|
|
* _cairo_scaled_font_subsets_map_glyph().
|
||
|
|
*
|
||
|
|
* For each subset, @font_subset_callback will be called and will be
|
||
|
|
* provided with both a #cairo_scaled_font_subset_t object containing
|
||
|
|
* all the glyphs in the subset as well as the value of @closure.
|
||
|
|
*
|
||
|
|
* The #cairo_scaled_font_subset_t object contains the scaled_font,
|
||
|
|
* the font_id, and the subset_id corresponding to all glyphs
|
||
|
|
* belonging to the subset. In addition, it contains an array providing
|
||
|
|
* a mapping between subset glyph indices and the original scaled font
|
||
|
|
* glyph indices.
|
||
|
|
*
|
||
|
|
* The index of the array corresponds to subset_glyph_index values
|
||
|
|
* returned by _cairo_scaled_font_subsets_map_glyph() while the
|
||
|
|
* values of the array correspond to the scaled_font_glyph_index
|
||
|
|
* values passed as input to the same function.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful, or a non-zero
|
||
|
|
* value indicating an error. Possible errors include
|
||
|
|
* %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_scaled_font_subsets_foreach_user (cairo_scaled_font_subsets_t *font_subsets,
|
||
|
|
cairo_scaled_font_subset_callback_func_t font_subset_callback,
|
||
|
|
void *closure);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_scaled_font_subset_create_glyph_names:
|
||
|
|
* @font_subsets: a #cairo_scaled_font_subsets_t
|
||
|
|
*
|
||
|
|
* Create an array of strings containing the glyph name for each glyph
|
||
|
|
* in @font_subsets. The array as store in font_subsets->glyph_names.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if the font backend does not support
|
||
|
|
* mapping the glyph indices to unicode characters. Possible errors
|
||
|
|
* include %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_int_status_t
|
||
|
|
_cairo_scaled_font_subset_create_glyph_names (cairo_scaled_font_subset_t *subset);
|
||
|
|
|
||
|
|
typedef struct _cairo_cff_subset {
|
||
|
|
char *family_name_utf8;
|
||
|
|
char *ps_name;
|
||
|
|
double *widths;
|
||
|
|
double x_min, y_min, x_max, y_max;
|
||
|
|
double ascent, descent;
|
||
|
|
char *data;
|
||
|
|
unsigned long data_length;
|
||
|
|
} cairo_cff_subset_t;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_cff_subset_init:
|
||
|
|
* @cff_subset: a #cairo_cff_subset_t to initialize
|
||
|
|
* @font_subset: the #cairo_scaled_font_subset_t to initialize from
|
||
|
|
*
|
||
|
|
* If possible (depending on the format of the underlying
|
||
|
|
* #cairo_scaled_font_t and the font backend in use) generate a
|
||
|
|
* cff file corresponding to @font_subset and initialize
|
||
|
|
* @cff_subset with information about the subset and the cff
|
||
|
|
* data.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if the font can't be subset as a
|
||
|
|
* cff file, or an non-zero value indicating an error. Possible
|
||
|
|
* errors include %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_cff_subset_init (cairo_cff_subset_t *cff_subset,
|
||
|
|
const char *name,
|
||
|
|
cairo_scaled_font_subset_t *font_subset);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_cff_subset_fini:
|
||
|
|
* @cff_subset: a #cairo_cff_subset_t
|
||
|
|
*
|
||
|
|
* Free all resources associated with @cff_subset. After this
|
||
|
|
* call, @cff_subset should not be used again without a
|
||
|
|
* subsequent call to _cairo_cff_subset_init() again first.
|
||
|
|
**/
|
||
|
|
cairo_private void
|
||
|
|
_cairo_cff_subset_fini (cairo_cff_subset_t *cff_subset);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_cff_scaled_font_is_cid_cff:
|
||
|
|
* @scaled_font: a #cairo_scaled_font_t
|
||
|
|
*
|
||
|
|
* Return %TRUE if @scaled_font is a CID CFF font, otherwise return %FALSE.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_bool_t
|
||
|
|
_cairo_cff_scaled_font_is_cid_cff (cairo_scaled_font_t *scaled_font);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_cff_fallback_init:
|
||
|
|
* @cff_subset: a #cairo_cff_subset_t to initialize
|
||
|
|
* @font_subset: the #cairo_scaled_font_subset_t to initialize from
|
||
|
|
*
|
||
|
|
* If possible (depending on the format of the underlying
|
||
|
|
* #cairo_scaled_font_t and the font backend in use) generate a cff
|
||
|
|
* file corresponding to @font_subset and initialize @cff_subset
|
||
|
|
* with information about the subset and the cff data.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if the font can't be subset as a
|
||
|
|
* cff file, or an non-zero value indicating an error. Possible
|
||
|
|
* errors include %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_cff_fallback_init (cairo_cff_subset_t *cff_subset,
|
||
|
|
const char *name,
|
||
|
|
cairo_scaled_font_subset_t *font_subset);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_cff_fallback_fini:
|
||
|
|
* @cff_subset: a #cairo_cff_subset_t
|
||
|
|
*
|
||
|
|
* Free all resources associated with @cff_subset. After this
|
||
|
|
* call, @cff_subset should not be used again without a
|
||
|
|
* subsequent call to _cairo_cff_subset_init() again first.
|
||
|
|
**/
|
||
|
|
cairo_private void
|
||
|
|
_cairo_cff_fallback_fini (cairo_cff_subset_t *cff_subset);
|
||
|
|
|
||
|
|
typedef struct _cairo_truetype_subset {
|
||
|
|
char *family_name_utf8;
|
||
|
|
char *ps_name;
|
||
|
|
double *widths;
|
||
|
|
double x_min, y_min, x_max, y_max;
|
||
|
|
double ascent, descent;
|
||
|
|
unsigned char *data;
|
||
|
|
unsigned long data_length;
|
||
|
|
unsigned long *string_offsets;
|
||
|
|
unsigned long num_string_offsets;
|
||
|
|
} cairo_truetype_subset_t;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_truetype_subset_init_ps:
|
||
|
|
* @truetype_subset: a #cairo_truetype_subset_t to initialize
|
||
|
|
* @font_subset: the #cairo_scaled_font_subset_t to initialize from
|
||
|
|
*
|
||
|
|
* If possible (depending on the format of the underlying
|
||
|
|
* #cairo_scaled_font_t and the font backend in use) generate a
|
||
|
|
* truetype file corresponding to @font_subset and initialize
|
||
|
|
* @truetype_subset with information about the subset and the truetype
|
||
|
|
* data. The generated font will be suitable for embedding in
|
||
|
|
* PostScript.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if the font can't be subset as a
|
||
|
|
* truetype file, or an non-zero value indicating an error. Possible
|
||
|
|
* errors include %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_truetype_subset_init_ps (cairo_truetype_subset_t *truetype_subset,
|
||
|
|
cairo_scaled_font_subset_t *font_subset);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_truetype_subset_init_pdf:
|
||
|
|
* @truetype_subset: a #cairo_truetype_subset_t to initialize
|
||
|
|
* @font_subset: the #cairo_scaled_font_subset_t to initialize from
|
||
|
|
*
|
||
|
|
* If possible (depending on the format of the underlying
|
||
|
|
* #cairo_scaled_font_t and the font backend in use) generate a
|
||
|
|
* truetype file corresponding to @font_subset and initialize
|
||
|
|
* @truetype_subset with information about the subset and the truetype
|
||
|
|
* data. The generated font will be suitable for embedding in
|
||
|
|
* PDF.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if the font can't be subset as a
|
||
|
|
* truetype file, or an non-zero value indicating an error. Possible
|
||
|
|
* errors include %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_truetype_subset_init_pdf (cairo_truetype_subset_t *truetype_subset,
|
||
|
|
cairo_scaled_font_subset_t *font_subset);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_truetype_subset_fini:
|
||
|
|
* @truetype_subset: a #cairo_truetype_subset_t
|
||
|
|
*
|
||
|
|
* Free all resources associated with @truetype_subset. After this
|
||
|
|
* call, @truetype_subset should not be used again without a
|
||
|
|
* subsequent call to _cairo_truetype_subset_init() again first.
|
||
|
|
**/
|
||
|
|
cairo_private void
|
||
|
|
_cairo_truetype_subset_fini (cairo_truetype_subset_t *truetype_subset);
|
||
|
|
|
||
|
|
cairo_private const char *
|
||
|
|
_cairo_ps_standard_encoding_to_glyphname (int glyph);
|
||
|
|
|
||
|
|
cairo_private int
|
||
|
|
_cairo_unicode_to_winansi (unsigned long unicode);
|
||
|
|
|
||
|
|
cairo_private const char *
|
||
|
|
_cairo_winansi_to_glyphname (int glyph);
|
||
|
|
|
||
|
|
typedef struct _cairo_type1_subset {
|
||
|
|
char *base_font;
|
||
|
|
double *widths;
|
||
|
|
double x_min, y_min, x_max, y_max;
|
||
|
|
double ascent, descent;
|
||
|
|
char *data;
|
||
|
|
unsigned long header_length;
|
||
|
|
unsigned long data_length;
|
||
|
|
unsigned long trailer_length;
|
||
|
|
} cairo_type1_subset_t;
|
||
|
|
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_type1_subset_init:
|
||
|
|
* @type1_subset: a #cairo_type1_subset_t to initialize
|
||
|
|
* @font_subset: the #cairo_scaled_font_subset_t to initialize from
|
||
|
|
* @hex_encode: if true the encrypted portion of the font is hex encoded
|
||
|
|
*
|
||
|
|
* If possible (depending on the format of the underlying
|
||
|
|
* #cairo_scaled_font_t and the font backend in use) generate a type1
|
||
|
|
* file corresponding to @font_subset and initialize @type1_subset
|
||
|
|
* with information about the subset and the type1 data.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if the font can't be subset as a type1
|
||
|
|
* file, or an non-zero value indicating an error. Possible errors
|
||
|
|
* include %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_type1_subset_init (cairo_type1_subset_t *type_subset,
|
||
|
|
const char *name,
|
||
|
|
cairo_scaled_font_subset_t *font_subset,
|
||
|
|
cairo_bool_t hex_encode);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_type1_subset_fini:
|
||
|
|
* @type1_subset: a #cairo_type1_subset_t
|
||
|
|
*
|
||
|
|
* Free all resources associated with @type1_subset. After this call,
|
||
|
|
* @type1_subset should not be used again without a subsequent call to
|
||
|
|
* _cairo_truetype_type1_init() again first.
|
||
|
|
**/
|
||
|
|
cairo_private void
|
||
|
|
_cairo_type1_subset_fini (cairo_type1_subset_t *subset);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_type1_scaled_font_is_type1:
|
||
|
|
* @scaled_font: a #cairo_scaled_font_t
|
||
|
|
*
|
||
|
|
* Return %TRUE if @scaled_font is a Type 1 font, otherwise return %FALSE.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_bool_t
|
||
|
|
_cairo_type1_scaled_font_is_type1 (cairo_scaled_font_t *scaled_font);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_type1_fallback_init_binary:
|
||
|
|
* @type1_subset: a #cairo_type1_subset_t to initialize
|
||
|
|
* @font_subset: the #cairo_scaled_font_subset_t to initialize from
|
||
|
|
*
|
||
|
|
* If possible (depending on the format of the underlying
|
||
|
|
* #cairo_scaled_font_t and the font backend in use) generate a type1
|
||
|
|
* file corresponding to @font_subset and initialize @type1_subset
|
||
|
|
* with information about the subset and the type1 data. The encrypted
|
||
|
|
* part of the font is binary encoded.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if the font can't be subset as a type1
|
||
|
|
* file, or an non-zero value indicating an error. Possible errors
|
||
|
|
* include %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_type1_fallback_init_binary (cairo_type1_subset_t *type_subset,
|
||
|
|
const char *name,
|
||
|
|
cairo_scaled_font_subset_t *font_subset);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_type1_fallback_init_hex:
|
||
|
|
* @type1_subset: a #cairo_type1_subset_t to initialize
|
||
|
|
* @font_subset: the #cairo_scaled_font_subset_t to initialize from
|
||
|
|
*
|
||
|
|
* If possible (depending on the format of the underlying
|
||
|
|
* #cairo_scaled_font_t and the font backend in use) generate a type1
|
||
|
|
* file corresponding to @font_subset and initialize @type1_subset
|
||
|
|
* with information about the subset and the type1 data. The encrypted
|
||
|
|
* part of the font is hex encoded.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if the font can't be subset as a type1
|
||
|
|
* file, or an non-zero value indicating an error. Possible errors
|
||
|
|
* include %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_type1_fallback_init_hex (cairo_type1_subset_t *type_subset,
|
||
|
|
const char *name,
|
||
|
|
cairo_scaled_font_subset_t *font_subset);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_type1_fallback_fini:
|
||
|
|
* @type1_subset: a #cairo_type1_subset_t
|
||
|
|
*
|
||
|
|
* Free all resources associated with @type1_subset. After this call,
|
||
|
|
* @type1_subset should not be used again without a subsequent call to
|
||
|
|
* _cairo_truetype_type1_init() again first.
|
||
|
|
**/
|
||
|
|
cairo_private void
|
||
|
|
_cairo_type1_fallback_fini (cairo_type1_subset_t *subset);
|
||
|
|
|
||
|
|
typedef struct _cairo_type2_charstrings {
|
||
|
|
int *widths;
|
||
|
|
long x_min, y_min, x_max, y_max;
|
||
|
|
long ascent, descent;
|
||
|
|
cairo_array_t charstrings;
|
||
|
|
} cairo_type2_charstrings_t;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_type2_charstrings_init:
|
||
|
|
* @type2_subset: a #cairo_type2_subset_t to initialize
|
||
|
|
* @font_subset: the #cairo_scaled_font_subset_t to initialize from
|
||
|
|
*
|
||
|
|
* If possible (depending on the format of the underlying
|
||
|
|
* #cairo_scaled_font_t and the font backend in use) generate type2
|
||
|
|
* charstrings to @font_subset and initialize @type2_subset
|
||
|
|
* with information about the subset.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if the font can't be subset as a type2
|
||
|
|
* charstrings, or an non-zero value indicating an error. Possible errors
|
||
|
|
* include %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_status_t
|
||
|
|
_cairo_type2_charstrings_init (cairo_type2_charstrings_t *charstrings,
|
||
|
|
cairo_scaled_font_subset_t *font_subset);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_type2_charstrings_fini:
|
||
|
|
* @subset: a #cairo_type2_charstrings_t
|
||
|
|
*
|
||
|
|
* Free all resources associated with @type2_charstring. After this call,
|
||
|
|
* @type2_charstring should not be used again without a subsequent call to
|
||
|
|
* _cairo_type2_charstring_init() again first.
|
||
|
|
**/
|
||
|
|
cairo_private void
|
||
|
|
_cairo_type2_charstrings_fini (cairo_type2_charstrings_t *charstrings);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_truetype_index_to_ucs4:
|
||
|
|
* @scaled_font: the #cairo_scaled_font_t
|
||
|
|
* @index: the glyph index
|
||
|
|
* @ucs4: return value for the unicode value of the glyph
|
||
|
|
*
|
||
|
|
* If possible (depending on the format of the underlying
|
||
|
|
* #cairo_scaled_font_t and the font backend in use) assign
|
||
|
|
* the unicode character of the glyph to @ucs4.
|
||
|
|
*
|
||
|
|
* If mapping glyph indices to unicode is supported but the unicode
|
||
|
|
* value of the specified glyph is not available, @ucs4 is set to -1.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if mapping glyph indices to unicode
|
||
|
|
* is not supported. Possible errors include %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_int_status_t
|
||
|
|
_cairo_truetype_index_to_ucs4 (cairo_scaled_font_t *scaled_font,
|
||
|
|
unsigned long index,
|
||
|
|
uint32_t *ucs4);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_truetype_read_font_name:
|
||
|
|
* @scaled_font: the #cairo_scaled_font_t
|
||
|
|
* @ps_name: returns the PostScript name of the font
|
||
|
|
* or %NULL if the name could not be found.
|
||
|
|
* @font_name: returns the font name or %NULL if the name could not be found.
|
||
|
|
*
|
||
|
|
* If possible (depending on the format of the underlying
|
||
|
|
* #cairo_scaled_font_t and the font backend in use) read the
|
||
|
|
* PostScript and Font names from a TrueType/OpenType font.
|
||
|
|
*
|
||
|
|
* The font name is the full name of the font eg "DejaVu Sans Bold".
|
||
|
|
* The PostScript name is a shortened name with spaces removed
|
||
|
|
* suitable for use as the font name in a PS or PDF file eg
|
||
|
|
* "DejaVuSans-Bold".
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if the font is not TrueType/OpenType
|
||
|
|
* or the name table is not present. Possible errors include
|
||
|
|
* %CAIRO_STATUS_NO_MEMORY.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_int_status_t
|
||
|
|
_cairo_truetype_read_font_name (cairo_scaled_font_t *scaled_font,
|
||
|
|
char **ps_name,
|
||
|
|
char **font_name);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* _cairo_truetype_get_style:
|
||
|
|
* @scaled_font: the #cairo_scaled_font_t
|
||
|
|
* @weight: returns the font weight from the OS/2 table
|
||
|
|
* @bold: returns true if font is bold
|
||
|
|
* @italic: returns true if font is italic
|
||
|
|
*
|
||
|
|
* If the font is a truetype/opentype font with an OS/2 table, get the
|
||
|
|
* weight, bold, and italic data from the OS/2 table. The weight
|
||
|
|
* values have the same meaning as the lfWeight field of the Windows
|
||
|
|
* LOGFONT structure. Refer to the TrueType Specification for
|
||
|
|
* definition of the weight values.
|
||
|
|
*
|
||
|
|
* Return value: %CAIRO_STATUS_SUCCESS if successful,
|
||
|
|
* %CAIRO_INT_STATUS_UNSUPPORTED if the font is not TrueType/OpenType
|
||
|
|
* or the OS/2 table is not present.
|
||
|
|
**/
|
||
|
|
cairo_private cairo_int_status_t
|
||
|
|
_cairo_truetype_get_style (cairo_scaled_font_t *scaled_font,
|
||
|
|
int *weight,
|
||
|
|
cairo_bool_t *bold,
|
||
|
|
cairo_bool_t *italic);
|
||
|
|
|
||
|
|
#endif /* CAIRO_HAS_FONT_SUBSET */
|
||
|
|
|
||
|
|
#endif /* CAIRO_SCALED_FONT_SUBSETS_PRIVATE_H */
|