Lines Matching +full:set +full:- +full:output
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
11 main APIs. These include a set of command-line tools, a set of
12 lower-level APIs for common data types that may be of interest to
16 <section id="utilities-command-line-tools">
17 <title>Command-line tools</title>
19 HarfBuzz include three command-line tools:
20 <command>hb-shape</command>, <command>hb-view</command>, and
21 <command>hb-subset</command>. They can be used to examine
26 <section id="utilities-command-line-hbshape">
27 <title>hb-shape</title>
29 <emphasis><command>hb-shape</command></emphasis> allows you to run HarfBuzz's
31 to examine the outcome, in human-readable form, as terminal
32 output. <command>hb-shape</command> does
34 into rendered text (you can use <command>hb-view</command>, below, for
41 command-line options, you can add various aspects of the
42 internal state to the output that is sent to the terminal. The
46 <command>hb-shape</command> <optional>[OPTIONS]</optional>
51 The default output format is plain text (although JSON output
53 <optional>--output-format=json</optional>). The default output
59 Output options exist to skip any of these elements in the
60 output, and to include additional data, such as Unicode
61 code-point values, glyph extents, glyph flags, or interim
65 Output can also be redirected to a file, or input read from a
67 specific font features, to set variation-font axis values, to
75 <command>hb-shape</command> <parameter>--help</parameter>
79 <section id="utilities-command-line-hbview">
80 <title>hb-view</title>
82 <emphasis><command>hb-view</command></emphasis> allows you to
83 see the shaped output of an input string in rendered
84 form. Like <command>hb-shape</command>,
85 <command>hb-view</command> takes a font file and a text string
89 <command>hb-view</command> <optional>[OPTIONS]</optional>
94 By default, <command>hb-view</command> renders the shaped
95 text in ASCII block-character images as terminal output. By
97 <command>--output-file=<optional>filename</optional></command>
98 switch, you can write the output to a PNG, SVG, or PDF file
102 As with <command>hb-shape</command>, a lengthy set of options
104 specific font features, set variation-font axis values,
110 You can also set the foreground and background colors used for
111 the output, independently control the width of all four
112 margins, alter the line spacing, and annotate the output image
116 In general, <command>hb-view</command> is a quick way to
117 verify that the output of HarfBuzz's shaping operation looks
118 correct for a given text-and-font combination, but you may
119 want to use <command>hb-shape</command> to figure out exactly
124 <section id="utilities-command-line-hbsubset">
125 <title>hb-subset</title>
127 <emphasis><command>hb-subset</command></emphasis> allows you
128 to generate a subset of a given font, with a limited set of
133 as the arguments to <command>hb-subset</command>, and it will
138 <command>hb-subset</command> <optional>[OPTIONS]</optional>
147 <command>hb-subset</command> <optional>[OPTIONS]</optional>
148 <parameter>NotoSerif-Regular.ttf</parameter>
153 subsetted font and to specify a list of variation-axis settings.
159 <section id="utilities-common-types-apis">
162 HarfBuzz includes several APIs for working with general-purpose
164 software. They include set operations and integer-to-integer
168 HarfBuzz uses set operations for internal bookkeeping, such as
170 font feature. You can also use the set API to build sets, add
176 All set elements are integers (specifically,
177 <type>hb_codepoint_t</type> 32-bit unsigned ints), and there are
179 set. The set API also includes some functions that might not
180 be part of a generic set facility, such as the ability to add a
181 contiguous range of integer elements to a set in bulk, and the
182 ability to fetch the next-smallest or next-largest element.
185 The HarfBuzz set API includes some conveniences as well. All
186 sets are lifecycle-managed, just like other HarfBuzz
187 objects. You increase the reference count on a set with
190 user data to a set, just like you can to blobs, buffers, faces,
191 fonts, and other objects, and set destroy callbacks.
195 integer-to-integer mappings. As with the set API, each integer is
196 stored as an unsigned 32-bit <type>hb_codepoint_t</type>
200 integer-to-integer key:value pairs to the map, testing for the
208 scripts, languages, font features, table names, variation-axis
210 to tags and vice-versa.