Mercurial > hgrepos > Python2 > PyMuPDF

comparison mupdf-source/include/mupdf/fitz/glyph-cache.h @ 2:b50eed0cc0ef upstream

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
ADD: MuPDF v1.26.7: the MuPDF source as downloaded by a default build of PyMuPDF 1.26.4. The directory name has changed: no version number in the expanded directory now.
author Franz Glasner <fzglas.hg@dom66.de>
date Mon, 15 Sep 2025 11:43:07 +0200
parents
children
comparison
equal deleted inserted replaced
1:1d09e1dec1d9 2:b50eed0cc0ef
1 // Copyright (C) 2004-2025 Artifex Software, Inc.
2 //
3 // This file is part of MuPDF.
4 //
5 // MuPDF is free software: you can redistribute it and/or modify it under the
6 // terms of the GNU Affero General Public License as published by the Free
7 // Software Foundation, either version 3 of the License, or (at your option)
8 // any later version.
9 //
10 // MuPDF is distributed in the hope that it will be useful, but WITHOUT ANY
11 // WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
12 // FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
13 // details.
14 //
15 // You should have received a copy of the GNU Affero General Public License
16 // along with MuPDF. If not, see <https://www.gnu.org/licenses/agpl-3.0.en.html>
17 //
18 // Alternative licensing terms are available from the licensor.
19 // For commercial licensing, see <https://www.artifex.com/> or contact
20 // Artifex Software, Inc., 39 Mesa Street, Suite 108A, San Francisco,
21 // CA 94129, USA, for further information.
22
23 #ifndef MUPDF_FITZ_GLYPH_CACHE_H
24 #define MUPDF_FITZ_GLYPH_CACHE_H
25
26 #include "mupdf/fitz/context.h"
27 #include "mupdf/fitz/geometry.h"
28 #include "mupdf/fitz/font.h"
29 #include "mupdf/fitz/pixmap.h"
30 #include "mupdf/fitz/device.h"
31
32 /**
33 Purge all the glyphs from the cache.
34 */
35 void fz_purge_glyph_cache(fz_context *ctx);
36
37 /**
38 Create a pixmap containing a rendered glyph.
39
40 Lookup gid from font, clip it with scissor, and rendering it
41 with aa bits of antialiasing into a new pixmap.
42
43 The caller takes ownership of the pixmap and so must free it.
44
45 Note: This function is no longer used for normal rendering
46 operations, and is kept around just because we use it in the
47 app. It should be considered "at risk" of removal from the API.
48 */
49 fz_pixmap *fz_render_glyph_pixmap(fz_context *ctx, fz_font *font, int gid, fz_matrix *ctm, const fz_irect *scissor, int aa);
50
51 /**
52 Nasty PDF interpreter specific hernia, required to allow the
53 interpreter to replay glyphs from a type3 font directly into
54 the target device.
55
56 This is only used in exceptional circumstances (such as type3
57 glyphs that inherit current graphics state, or nested type3
58 glyphs).
59 */
60 void fz_render_t3_glyph_direct(fz_context *ctx, fz_device *dev, fz_font *font, int gid, fz_matrix trm, void *gstate, fz_default_colorspaces *def_cs, void *fill_gstate, void *stroke_gstate);
61
62 /**
63 Force a type3 font to cache the displaylist for a given glyph
64 id.
65
66 This caching can involve reading the underlying file, so must
67 happen ahead of time, so we aren't suddenly forced to read the
68 file while playing a displaylist back.
69 */
70 void fz_prepare_t3_glyph(fz_context *ctx, fz_font *font, int gid);
71
72 /**
73 Dump debug statistics for the glyph cache.
74 */
75 void fz_dump_glyph_cache_stats(fz_context *ctx, fz_output *out);
76
77 /**
78 Perform subpixel quantisation and adjustment on a glyph matrix.
79
80 ctm: On entry, the desired 'ideal' transformation for a glyph.
81 On exit, adjusted to a (very similar) transformation quantised
82 for subpixel caching.
83
84 subpix_ctm: Initialised by the routine to the transform that
85 should be used to render the glyph.
86
87 qe, qf: which subpixel position we quantised to.
88
89 Returns: the size of the glyph.
90
91 Note: This is currently only exposed for use in our app. It
92 should be considered "at risk" of removal from the API.
93 */
94 float fz_subpixel_adjust(fz_context *ctx, fz_matrix *ctm, fz_matrix *subpix_ctm, unsigned char *qe, unsigned char *qf);
95
96 #endif