2 * Paper printing definitions.
4 * This header file defines data structures and constants which are
5 * shared between bk_paper.c and its clients bk_ps.c and bk_pdf.c.
8 #ifndef HALIBUT_PAPER_H
9 #define HALIBUT_PAPER_H
11 /* Number of internal units per PostScript point. */
12 #define UNITS_PER_PT 1000
13 #define FUNITS_PER_PT 1000.0
15 /* Glyphs are represented by integer indicies into a table of names. */
16 typedef unsigned short glyph
;
17 #define NOGLYPH 0xFFFF
19 typedef struct document_Tag document
;
20 typedef struct glyph_width_Tag glyph_width
;
21 typedef struct kern_pair_Tag kern_pair
;
22 typedef struct ligature_Tag ligature
;
23 typedef struct font_info_Tag font_info
;
24 typedef struct font_data_Tag font_data
;
25 typedef struct font_encoding_Tag font_encoding
;
26 typedef struct font_list_Tag font_list
;
27 typedef struct para_data_Tag para_data
;
28 typedef struct line_data_Tag line_data
;
29 typedef struct page_data_Tag page_data
;
30 typedef struct subfont_map_entry_Tag subfont_map_entry
;
31 typedef struct text_fragment_Tag text_fragment
;
32 typedef struct xref_Tag xref
;
33 typedef struct xref_dest_Tag xref_dest
;
34 typedef struct rect_Tag rect
;
35 typedef struct outline_element_Tag outline_element
;
38 * This data structure represents the overall document, in the form
39 * it will be given to the client backends.
42 int paper_width
, paper_height
;
45 outline_element
*outline_elements
;
46 int n_outline_elements
;
50 * This data structure represents the normal width of a single glyph
53 struct glyph_width_Tag
{
59 * This data structure represents a kerning pair within a font.
61 struct kern_pair_Tag
{
64 /* Kern amount, in internal units. */
69 * ... and this one represents a ligature.
72 glyph left
, right
, lig
;
76 * This data structure holds static information about a font that doesn't
77 * depend on the particular document. It gets generated when the font's
78 * metrics are read in.
83 struct font_info_Tag
{
86 * Specify the PostScript name of the font and its point size.
90 * Pointer to data about the file containing the font, if any.
93 enum { TYPE1
, TRUETYPE
} filetype
;
94 /* A tree of glyph_widths */
96 /* A tree of kern_pairs */
98 /* ... and one of ligatures */
101 * For reasonably speedy lookup, we set up a 65536-element
102 * table representing the Unicode BMP (I can conveniently
103 * restrict myself to the BMP for the moment since I happen to
104 * know that no glyph in the Adobe Glyph List falls outside
105 * it), whose elements are indices into the above two arrays.
109 * Various bits of metadata needed for the /FontDescriptor dictionary
123 * This structure holds the information about how a font is used
126 struct font_data_Tag
{
127 font_info
const *info
;
129 * At some point I'm going to divide the font into sub-fonts
130 * with largely non-overlapping encoding vectors. This tree
131 * will track which glyphs go into which subfonts. Also here I
132 * keep track of the latest subfont of any given font, so I can
133 * go back and extend its encoding.
135 tree234
*subfont_map
;
136 font_encoding
*latest_subfont
;
138 * The font list to which this font belongs.
143 struct subfont_map_entry_Tag
{
144 font_encoding
*subfont
;
145 unsigned char position
;
149 * This data structure represents a sub-font: a font with an
152 struct font_encoding_Tag
{
155 char *name
; /* used by client backends */
157 font_data
*font
; /* the parent font structure */
158 glyph vector
[256]; /* the actual encoding vector */
159 wchar_t to_unicode
[256]; /* PDF will want to know this */
160 int free_pos
; /* space left to extend encoding */
164 * This data structure represents the overall list of sub-fonts in
165 * the whole document.
167 struct font_list_Tag
{
173 * Constants defining array indices for the various fonts used in a
184 * This is the data structure which is stored in the private_data
185 * field of each paragraph. It divides the paragraph up into a
186 * linked list of lines, while at the same time providing for those
187 * lines to be linked together into a much longer list spanning the
188 * whole document for page-breaking purposes.
191 struct para_data_Tag
{
194 * Data about the fonts used in this paragraph. Indices are the
195 * FONT_* constants defined above.
197 font_data
*fonts
[NFONTS
];
200 * Pointers to the first and last line of the paragraph. The
201 * line structures are linked into a list, which runs from
202 * `first' to `last' as might be expected. However, the list
203 * does not terminate there: first->prev will end up pointing
204 * to the last line of the previous paragraph in most cases,
205 * and likewise last->next will point to the first line of the
208 line_data
*first
; /* first line in paragraph */
209 line_data
*last
; /* last line in paragraph */
211 * Some paragraphs have associated graphics; currently this is
212 * nothing more complex than a single black rectangle.
215 RECT_NONE
, RECT_CHAPTER_UNDERLINE
, RECT_RULE
218 * We left- and right-justify in special circumstances.
224 * Sometimes (in code paragraphs) we want to override the flags
225 * passed to render_string().
229 * For constructing the page outline.
231 int outline_level
; /* 0=title 1=C 2=H 3=S 4=S2... */
232 wchar_t *outline_title
;
234 * For adding the page number of a contents entry afterwards.
236 paragraph
*contents_entry
;
239 struct line_data_Tag
{
241 * The parent paragraph.
245 * Pointers to join lines into a linked list.
250 * The extent of the text displayed on this line. Also mention
251 * its starting x position, and by how much the width of spaces
252 * needs to be adjusted for paragraph justification.
254 * (Unlike most of the `last' pointers defined in this file,
255 * this `end' pointer points to the word _after_ the last one
256 * that should be displayed on the line. This is how it's
257 * returned from wrap_para().)
262 int hshortfall
, nspaces
; /* for justifying paragraphs */
265 * Auxiliary text: a section number in a margin, or a list item
266 * bullet or number. Also mention where to display this text
267 * relative to the left margin.
273 * This line might have a non-negotiable page break before it.
274 * Also there will be space required above and below it; also I
275 * store the physical line height (defined as the maximum of
276 * the heights of the three fonts in the pdata) because it's
277 * easier than looking it up repeatedly during page breaking.
284 * Penalties for page breaking before or after this line.
286 int penalty_before
, penalty_after
;
288 * These fields are used in the page breaking algorithm.
291 int *vshortfall
, *text
, *space
;
292 line_data
**page_last
; /* last line on a page starting here */
294 * After page breaking, we can assign an actual y-coordinate on
295 * the page to each line. Also we store a pointer back to the
296 * page structure itself.
303 * This data structure is constructed to describe each page of the
306 struct page_data_Tag
{
308 * Pointers to join pages into a linked list.
313 * The set of lines displayed on this page.
315 line_data
*first_line
;
316 line_data
*last_line
;
318 * After text rendering: the set of actual pieces of text
319 * needing to be displayed on this page.
321 text_fragment
*first_text
;
322 text_fragment
*last_text
;
329 * Rectangles to be drawn. (These are currently only used for
330 * underlining chapter titles and drawing horizontal rules.)
335 * The page number, as a string.
339 * This spare pointer field is for use by the client backends.
344 struct text_fragment_Tag
{
353 struct xref_dest_Tag
{
354 enum { NONE
, PAGE
, URL
} type
;
370 struct outline_element_Tag
{
371 int level
; /* 0=title 1=C 2=H 3=S 4=S2... */
376 * Functions exported from bk_paper.c
378 int width_cmp(void *, void *); /* use when setting up widths */
379 int kern_cmp(void *, void *); /* use when setting up kern_pairs */
380 int lig_cmp(void *, void *); /* use when setting up ligatures */
381 int find_width(font_data
*, glyph
);
384 * Functions and data exported from psdata.c.
386 glyph
glyph_intern(char const *);
387 char const *glyph_extern(glyph
);
388 wchar_t ps_glyph_to_unicode(glyph
);
389 extern const char *const ps_std_glyphs
[];
390 extern glyph
const tt_std_glyphs
[];
391 void init_std_fonts(void);
392 const int *ps_std_font_widths(char const *fontname
);
393 const kern_pair
*ps_std_font_kerns(char const *fontname
);
396 * Functions exported from bk_pdf.c
398 typedef struct object_Tag object
;
399 typedef struct objlist_Tag objlist
;
400 object
*new_object(objlist
*list
);
401 void objtext(object
*o
, char const *text
);
402 void objstream(object
*o
, char const *text
);
403 void objstream_len(object
*o
, char const *text
, size_t len
);
404 char *pdf_outline_convert(wchar_t *s
, int *len
);
407 * Function exported from bk_ps.c
409 void ps_token(FILE *fp
, int *cc
, char const *fmt
, ...);
412 * Backend functions exported by in_pf.c
414 void pf_part1(font_info
*fi
, char **bufp
, size_t *lenp
);
415 void pf_part2(font_info
*fi
, char **bufp
, size_t *lenp
);
416 void pf_writeps(font_info
const *fi
, FILE *ofp
);
419 * Backend functions exported by in_sfnt.c
421 void sfnt_writeps(font_info
const *fi
, FILE *ofp
);
422 void sfnt_cmap(font_encoding
*fe
, object
*);
423 void sfnt_data(font_info
*fi
, char **bufp
, size_t *lenp
);