xref: /dragonfly/contrib/mdocml/term_ps.c (revision 684cb317)
1 /*	$Id: term_ps.c,v 1.62 2014/08/01 19:25:52 schwarze Exp $ */
2 /*
3  * Copyright (c) 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
4  * Copyright (c) 2014 Ingo Schwarze <schwarze@openbsd.org>
5  *
6  * Permission to use, copy, modify, and distribute this software for any
7  * purpose with or without fee is hereby granted, provided that the above
8  * copyright notice and this permission notice appear in all copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17  */
18 #ifdef HAVE_CONFIG_H
19 #include "config.h"
20 #endif
21 
22 #include <sys/types.h>
23 
24 #include <assert.h>
25 #include <stdarg.h>
26 #include <stdint.h>
27 #include <stdio.h>
28 #include <stdlib.h>
29 #include <string.h>
30 #include <time.h>
31 #include <unistd.h>
32 
33 #include "mandoc.h"
34 #include "mandoc_aux.h"
35 #include "out.h"
36 #include "main.h"
37 #include "term.h"
38 
39 /* These work the buffer used by the header and footer. */
40 #define	PS_BUFSLOP	  128
41 
42 /* Convert PostScript point "x" to an AFM unit. */
43 #define	PNT2AFM(p, x) \
44 	(size_t)((double)(x) * (1000.0 / (double)(p)->ps->scale))
45 
46 /* Convert an AFM unit "x" to a PostScript points */
47 #define	AFM2PNT(p, x) \
48 	((double)(x) / (1000.0 / (double)(p)->ps->scale))
49 
50 struct	glyph {
51 	unsigned short	  wx; /* WX in AFM */
52 };
53 
54 struct	font {
55 	const char	 *name; /* FontName in AFM */
56 #define	MAXCHAR		  95 /* total characters we can handle */
57 	struct glyph	  gly[MAXCHAR]; /* glyph metrics */
58 };
59 
60 struct	termp_ps {
61 	int		  flags;
62 #define	PS_INLINE	 (1 << 0)	/* we're in a word */
63 #define	PS_MARGINS	 (1 << 1)	/* we're in the margins */
64 #define	PS_NEWPAGE	 (1 << 2)	/* new page, no words yet */
65 	size_t		  pscol;	/* visible column (AFM units) */
66 	size_t		  psrow;	/* visible row (AFM units) */
67 	char		 *psmarg;	/* margin buf */
68 	size_t		  psmargsz;	/* margin buf size */
69 	size_t		  psmargcur;	/* cur index in margin buf */
70 	char		  last;		/* character buffer */
71 	enum termfont	  lastf;	/* last set font */
72 	size_t		  scale;	/* font scaling factor */
73 	size_t		  pages;	/* number of pages shown */
74 	size_t		  lineheight;	/* line height (AFM units) */
75 	size_t		  top;		/* body top (AFM units) */
76 	size_t		  bottom;	/* body bottom (AFM units) */
77 	size_t		  height;	/* page height (AFM units */
78 	size_t		  width;	/* page width (AFM units) */
79 	size_t		  lastwidth;	/* page width before last ll */
80 	size_t		  left;		/* body left (AFM units) */
81 	size_t		  header;	/* header pos (AFM units) */
82 	size_t		  footer;	/* footer pos (AFM units) */
83 	size_t		  pdfbytes;	/* current output byte */
84 	size_t		  pdflastpg;	/* byte of last page mark */
85 	size_t		  pdfbody;	/* start of body object */
86 	size_t		 *pdfobjs;	/* table of object offsets */
87 	size_t		  pdfobjsz;	/* size of pdfobjs */
88 };
89 
90 static	double		  ps_hspan(const struct termp *,
91 				const struct roffsu *);
92 static	size_t		  ps_width(const struct termp *, int);
93 static	void		  ps_advance(struct termp *, size_t);
94 static	void		  ps_begin(struct termp *);
95 static	void		  ps_closepage(struct termp *);
96 static	void		  ps_end(struct termp *);
97 static	void		  ps_endline(struct termp *);
98 static	void		  ps_fclose(struct termp *);
99 static	void		  ps_growbuf(struct termp *, size_t);
100 static	void		  ps_letter(struct termp *, int);
101 static	void		  ps_pclose(struct termp *);
102 static	void		  ps_pletter(struct termp *, int);
103 #if __GNUC__ - 0 >= 4
104 __attribute__((__format__ (__printf__, 2, 3)))
105 #endif
106 static	void		  ps_printf(struct termp *, const char *, ...);
107 static	void		  ps_putchar(struct termp *, char);
108 static	void		  ps_setfont(struct termp *, enum termfont);
109 static	void		  ps_setwidth(struct termp *, int, size_t);
110 static	struct termp	 *pspdf_alloc(char *);
111 static	void		  pdf_obj(struct termp *, size_t);
112 
113 /*
114  * We define, for the time being, three fonts: bold, oblique/italic, and
115  * normal (roman).  The following table hard-codes the font metrics for
116  * ASCII, i.e., 32--127.
117  */
118 
119 static	const struct font fonts[TERMFONT__MAX] = {
120 	{ "Times-Roman", {
121 		{ 250 },
122 		{ 333 },
123 		{ 408 },
124 		{ 500 },
125 		{ 500 },
126 		{ 833 },
127 		{ 778 },
128 		{ 333 },
129 		{ 333 },
130 		{ 333 },
131 		{ 500 },
132 		{ 564 },
133 		{ 250 },
134 		{ 333 },
135 		{ 250 },
136 		{ 278 },
137 		{ 500 },
138 		{ 500 },
139 		{ 500 },
140 		{ 500 },
141 		{ 500 },
142 		{ 500 },
143 		{ 500 },
144 		{ 500 },
145 		{ 500 },
146 		{ 500 },
147 		{ 278 },
148 		{ 278 },
149 		{ 564 },
150 		{ 564 },
151 		{ 564 },
152 		{ 444 },
153 		{ 921 },
154 		{ 722 },
155 		{ 667 },
156 		{ 667 },
157 		{ 722 },
158 		{ 611 },
159 		{ 556 },
160 		{ 722 },
161 		{ 722 },
162 		{ 333 },
163 		{ 389 },
164 		{ 722 },
165 		{ 611 },
166 		{ 889 },
167 		{ 722 },
168 		{ 722 },
169 		{ 556 },
170 		{ 722 },
171 		{ 667 },
172 		{ 556 },
173 		{ 611 },
174 		{ 722 },
175 		{ 722 },
176 		{ 944 },
177 		{ 722 },
178 		{ 722 },
179 		{ 611 },
180 		{ 333 },
181 		{ 278 },
182 		{ 333 },
183 		{ 469 },
184 		{ 500 },
185 		{ 333 },
186 		{ 444 },
187 		{ 500 },
188 		{ 444 },
189 		{  500},
190 		{  444},
191 		{  333},
192 		{  500},
193 		{  500},
194 		{  278},
195 		{  278},
196 		{  500},
197 		{  278},
198 		{  778},
199 		{  500},
200 		{  500},
201 		{  500},
202 		{  500},
203 		{  333},
204 		{  389},
205 		{  278},
206 		{  500},
207 		{  500},
208 		{  722},
209 		{  500},
210 		{  500},
211 		{  444},
212 		{  480},
213 		{  200},
214 		{  480},
215 		{  541},
216 	} },
217 	{ "Times-Bold", {
218 		{ 250  },
219 		{ 333  },
220 		{ 555  },
221 		{ 500  },
222 		{ 500  },
223 		{ 1000 },
224 		{ 833  },
225 		{ 333  },
226 		{ 333  },
227 		{ 333  },
228 		{ 500  },
229 		{ 570  },
230 		{ 250  },
231 		{ 333  },
232 		{ 250  },
233 		{ 278  },
234 		{ 500  },
235 		{ 500  },
236 		{ 500  },
237 		{ 500  },
238 		{ 500  },
239 		{ 500  },
240 		{ 500  },
241 		{ 500  },
242 		{ 500  },
243 		{ 500  },
244 		{ 333  },
245 		{ 333  },
246 		{ 570  },
247 		{ 570  },
248 		{ 570  },
249 		{ 500  },
250 		{ 930  },
251 		{ 722  },
252 		{ 667  },
253 		{ 722  },
254 		{ 722  },
255 		{ 667  },
256 		{ 611  },
257 		{ 778  },
258 		{ 778  },
259 		{ 389  },
260 		{ 500  },
261 		{ 778  },
262 		{ 667  },
263 		{ 944  },
264 		{ 722  },
265 		{ 778  },
266 		{ 611  },
267 		{ 778  },
268 		{ 722  },
269 		{ 556  },
270 		{ 667  },
271 		{ 722  },
272 		{ 722  },
273 		{ 1000 },
274 		{ 722  },
275 		{ 722  },
276 		{ 667  },
277 		{ 333  },
278 		{ 278  },
279 		{ 333  },
280 		{ 581  },
281 		{ 500  },
282 		{ 333  },
283 		{ 500  },
284 		{ 556  },
285 		{ 444  },
286 		{  556 },
287 		{  444 },
288 		{  333 },
289 		{  500 },
290 		{  556 },
291 		{  278 },
292 		{  333 },
293 		{  556 },
294 		{  278 },
295 		{  833 },
296 		{  556 },
297 		{  500 },
298 		{  556 },
299 		{  556 },
300 		{  444 },
301 		{  389 },
302 		{  333 },
303 		{  556 },
304 		{  500 },
305 		{  722 },
306 		{  500 },
307 		{  500 },
308 		{  444 },
309 		{  394 },
310 		{  220 },
311 		{  394 },
312 		{  520 },
313 	} },
314 	{ "Times-Italic", {
315 		{ 250  },
316 		{ 333  },
317 		{ 420  },
318 		{ 500  },
319 		{ 500  },
320 		{ 833  },
321 		{ 778  },
322 		{ 333  },
323 		{ 333  },
324 		{ 333  },
325 		{ 500  },
326 		{ 675  },
327 		{ 250  },
328 		{ 333  },
329 		{ 250  },
330 		{ 278  },
331 		{ 500  },
332 		{ 500  },
333 		{ 500  },
334 		{ 500  },
335 		{ 500  },
336 		{ 500  },
337 		{ 500  },
338 		{ 500  },
339 		{ 500  },
340 		{ 500  },
341 		{ 333  },
342 		{ 333  },
343 		{ 675  },
344 		{ 675  },
345 		{ 675  },
346 		{ 500  },
347 		{ 920  },
348 		{ 611  },
349 		{ 611  },
350 		{ 667  },
351 		{ 722  },
352 		{ 611  },
353 		{ 611  },
354 		{ 722  },
355 		{ 722  },
356 		{ 333  },
357 		{ 444  },
358 		{ 667  },
359 		{ 556  },
360 		{ 833  },
361 		{ 667  },
362 		{ 722  },
363 		{ 611  },
364 		{ 722  },
365 		{ 611  },
366 		{ 500  },
367 		{ 556  },
368 		{ 722  },
369 		{ 611  },
370 		{ 833  },
371 		{ 611  },
372 		{ 556  },
373 		{ 556  },
374 		{ 389  },
375 		{ 278  },
376 		{ 389  },
377 		{ 422  },
378 		{ 500  },
379 		{ 333  },
380 		{ 500  },
381 		{ 500  },
382 		{ 444  },
383 		{  500 },
384 		{  444 },
385 		{  278 },
386 		{  500 },
387 		{  500 },
388 		{  278 },
389 		{  278 },
390 		{  444 },
391 		{  278 },
392 		{  722 },
393 		{  500 },
394 		{  500 },
395 		{  500 },
396 		{  500 },
397 		{  389 },
398 		{  389 },
399 		{  278 },
400 		{  500 },
401 		{  444 },
402 		{  667 },
403 		{  444 },
404 		{  444 },
405 		{  389 },
406 		{  400 },
407 		{  275 },
408 		{  400 },
409 		{  541 },
410 	} },
411 };
412 
413 void *
414 pdf_alloc(char *outopts)
415 {
416 	struct termp	*p;
417 
418 	if (NULL != (p = pspdf_alloc(outopts)))
419 		p->type = TERMTYPE_PDF;
420 
421 	return(p);
422 }
423 
424 void *
425 ps_alloc(char *outopts)
426 {
427 	struct termp	*p;
428 
429 	if (NULL != (p = pspdf_alloc(outopts)))
430 		p->type = TERMTYPE_PS;
431 
432 	return(p);
433 }
434 
435 static struct termp *
436 pspdf_alloc(char *outopts)
437 {
438 	struct termp	*p;
439 	unsigned int	 pagex, pagey;
440 	size_t		 marginx, marginy, lineheight;
441 	const char	*toks[2];
442 	const char	*pp;
443 	char		*v;
444 
445 	p = mandoc_calloc(1, sizeof(struct termp));
446 	p->enc = TERMENC_ASCII;
447 	p->ps = mandoc_calloc(1, sizeof(struct termp_ps));
448 
449 	p->advance = ps_advance;
450 	p->begin = ps_begin;
451 	p->end = ps_end;
452 	p->endline = ps_endline;
453 	p->hspan = ps_hspan;
454 	p->letter = ps_letter;
455 	p->setwidth = ps_setwidth;
456 	p->width = ps_width;
457 
458 	toks[0] = "paper";
459 	toks[1] = NULL;
460 
461 	pp = NULL;
462 
463 	while (outopts && *outopts)
464 		switch (getsubopt(&outopts, UNCONST(toks), &v)) {
465 		case 0:
466 			pp = v;
467 			break;
468 		default:
469 			break;
470 		}
471 
472 	/* Default to US letter (millimetres). */
473 
474 	pagex = 216;
475 	pagey = 279;
476 
477 	/*
478 	 * The ISO-269 paper sizes can be calculated automatically, but
479 	 * it would require bringing in -lm for pow() and I'd rather not
480 	 * do that.  So just do it the easy way for now.  Since this
481 	 * only happens once, I'm not terribly concerned.
482 	 */
483 
484 	if (pp && strcasecmp(pp, "letter")) {
485 		if (0 == strcasecmp(pp, "a3")) {
486 			pagex = 297;
487 			pagey = 420;
488 		} else if (0 == strcasecmp(pp, "a4")) {
489 			pagex = 210;
490 			pagey = 297;
491 		} else if (0 == strcasecmp(pp, "a5")) {
492 			pagex = 148;
493 			pagey = 210;
494 		} else if (0 == strcasecmp(pp, "legal")) {
495 			pagex = 216;
496 			pagey = 356;
497 		} else if (2 != sscanf(pp, "%ux%u", &pagex, &pagey))
498 			fprintf(stderr, "%s: Unknown paper\n", pp);
499 	}
500 
501 	/*
502 	 * This MUST be defined before any PNT2AFM or AFM2PNT
503 	 * calculations occur.
504 	 */
505 
506 	p->ps->scale = 11;
507 
508 	/* Remember millimetres -> AFM units. */
509 
510 	pagex = PNT2AFM(p, ((double)pagex * 2.834));
511 	pagey = PNT2AFM(p, ((double)pagey * 2.834));
512 
513 	/* Margins are 1/9 the page x and y. */
514 
515 	marginx = (size_t)((double)pagex / 9.0);
516 	marginy = (size_t)((double)pagey / 9.0);
517 
518 	/* Line-height is 1.4em. */
519 
520 	lineheight = PNT2AFM(p, ((double)p->ps->scale * 1.4));
521 
522 	p->ps->width = p->ps->lastwidth = (size_t)pagex;
523 	p->ps->height = (size_t)pagey;
524 	p->ps->header = pagey - (marginy / 2) - (lineheight / 2);
525 	p->ps->top = pagey - marginy;
526 	p->ps->footer = (marginy / 2) - (lineheight / 2);
527 	p->ps->bottom = marginy;
528 	p->ps->left = marginx;
529 	p->ps->lineheight = lineheight;
530 
531 	p->defrmargin = pagex - (marginx * 2);
532 	return(p);
533 }
534 
535 static void
536 ps_setwidth(struct termp *p, int iop, size_t width)
537 {
538 	size_t	 lastwidth;
539 
540 	lastwidth = p->ps->width;
541 	if (0 < iop)
542 		p->ps->width += width;
543 	else if (0 > iop)
544 		p->ps->width -= width;
545 	else
546 		p->ps->width = width ? width : p->ps->lastwidth;
547 	p->ps->lastwidth = lastwidth;
548 }
549 
550 void
551 pspdf_free(void *arg)
552 {
553 	struct termp	*p;
554 
555 	p = (struct termp *)arg;
556 
557 	if (p->ps->psmarg)
558 		free(p->ps->psmarg);
559 	if (p->ps->pdfobjs)
560 		free(p->ps->pdfobjs);
561 
562 	free(p->ps);
563 	term_free(p);
564 }
565 
566 static void
567 ps_printf(struct termp *p, const char *fmt, ...)
568 {
569 	va_list		 ap;
570 	int		 pos, len;
571 
572 	va_start(ap, fmt);
573 
574 	/*
575 	 * If we're running in regular mode, then pipe directly into
576 	 * vprintf().  If we're processing margins, then push the data
577 	 * into our growable margin buffer.
578 	 */
579 
580 	if ( ! (PS_MARGINS & p->ps->flags)) {
581 		len = vprintf(fmt, ap);
582 		va_end(ap);
583 		p->ps->pdfbytes += len < 0 ? 0 : (size_t)len;
584 		return;
585 	}
586 
587 	/*
588 	 * XXX: I assume that the in-margin print won't exceed
589 	 * PS_BUFSLOP (128 bytes), which is reasonable but still an
590 	 * assumption that will cause pukeage if it's not the case.
591 	 */
592 
593 	ps_growbuf(p, PS_BUFSLOP);
594 
595 	pos = (int)p->ps->psmargcur;
596 	vsnprintf(&p->ps->psmarg[pos], PS_BUFSLOP, fmt, ap);
597 
598 	va_end(ap);
599 
600 	p->ps->psmargcur = strlen(p->ps->psmarg);
601 }
602 
603 static void
604 ps_putchar(struct termp *p, char c)
605 {
606 	int		 pos;
607 
608 	/* See ps_printf(). */
609 
610 	if ( ! (PS_MARGINS & p->ps->flags)) {
611 		putchar(c);
612 		p->ps->pdfbytes++;
613 		return;
614 	}
615 
616 	ps_growbuf(p, 2);
617 
618 	pos = (int)p->ps->psmargcur++;
619 	p->ps->psmarg[pos++] = c;
620 	p->ps->psmarg[pos] = '\0';
621 }
622 
623 static void
624 pdf_obj(struct termp *p, size_t obj)
625 {
626 
627 	assert(obj > 0);
628 
629 	if ((obj - 1) >= p->ps->pdfobjsz) {
630 		p->ps->pdfobjsz = obj + 128;
631 		p->ps->pdfobjs = mandoc_reallocarray(p->ps->pdfobjs,
632 		    p->ps->pdfobjsz, sizeof(size_t));
633 	}
634 
635 	p->ps->pdfobjs[(int)obj - 1] = p->ps->pdfbytes;
636 	ps_printf(p, "%zu 0 obj\n", obj);
637 }
638 
639 static void
640 ps_closepage(struct termp *p)
641 {
642 	int		 i;
643 	size_t		 len, base;
644 
645 	/*
646 	 * Close out a page that we've already flushed to output.  In
647 	 * PostScript, we simply note that the page must be showed.  In
648 	 * PDF, we must now create the Length, Resource, and Page node
649 	 * for the page contents.
650 	 */
651 
652 	assert(p->ps->psmarg && p->ps->psmarg[0]);
653 	ps_printf(p, "%s", p->ps->psmarg);
654 
655 	if (TERMTYPE_PS != p->type) {
656 		ps_printf(p, "ET\n");
657 
658 		len = p->ps->pdfbytes - p->ps->pdflastpg;
659 		base = p->ps->pages * 4 + p->ps->pdfbody;
660 
661 		ps_printf(p, "endstream\nendobj\n");
662 
663 		/* Length of content. */
664 		pdf_obj(p, base + 1);
665 		ps_printf(p, "%zu\nendobj\n", len);
666 
667 		/* Resource for content. */
668 		pdf_obj(p, base + 2);
669 		ps_printf(p, "<<\n/ProcSet [/PDF /Text]\n");
670 		ps_printf(p, "/Font <<\n");
671 		for (i = 0; i < (int)TERMFONT__MAX; i++)
672 			ps_printf(p, "/F%d %d 0 R\n", i, 3 + i);
673 		ps_printf(p, ">>\n>>\n");
674 
675 		/* Page node. */
676 		pdf_obj(p, base + 3);
677 		ps_printf(p, "<<\n");
678 		ps_printf(p, "/Type /Page\n");
679 		ps_printf(p, "/Parent 2 0 R\n");
680 		ps_printf(p, "/Resources %zu 0 R\n", base + 2);
681 		ps_printf(p, "/Contents %zu 0 R\n", base);
682 		ps_printf(p, ">>\nendobj\n");
683 	} else
684 		ps_printf(p, "showpage\n");
685 
686 	p->ps->pages++;
687 	p->ps->psrow = p->ps->top;
688 	assert( ! (PS_NEWPAGE & p->ps->flags));
689 	p->ps->flags |= PS_NEWPAGE;
690 }
691 
692 static void
693 ps_end(struct termp *p)
694 {
695 	size_t		 i, xref, base;
696 
697 	/*
698 	 * At the end of the file, do one last showpage.  This is the
699 	 * same behaviour as groff(1) and works for multiple pages as
700 	 * well as just one.
701 	 */
702 
703 	if ( ! (PS_NEWPAGE & p->ps->flags)) {
704 		assert(0 == p->ps->flags);
705 		assert('\0' == p->ps->last);
706 		ps_closepage(p);
707 	}
708 
709 	if (TERMTYPE_PS == p->type) {
710 		ps_printf(p, "%%%%Trailer\n");
711 		ps_printf(p, "%%%%Pages: %zu\n", p->ps->pages);
712 		ps_printf(p, "%%%%EOF\n");
713 		return;
714 	}
715 
716 	pdf_obj(p, 2);
717 	ps_printf(p, "<<\n/Type /Pages\n");
718 	ps_printf(p, "/MediaBox [0 0 %zu %zu]\n",
719 			(size_t)AFM2PNT(p, p->ps->width),
720 			(size_t)AFM2PNT(p, p->ps->height));
721 
722 	ps_printf(p, "/Count %zu\n", p->ps->pages);
723 	ps_printf(p, "/Kids [");
724 
725 	for (i = 0; i < p->ps->pages; i++)
726 		ps_printf(p, " %zu 0 R", i * 4 + p->ps->pdfbody + 3);
727 
728 	base = (p->ps->pages - 1) * 4 + p->ps->pdfbody + 4;
729 
730 	ps_printf(p, "]\n>>\nendobj\n");
731 	pdf_obj(p, base);
732 	ps_printf(p, "<<\n");
733 	ps_printf(p, "/Type /Catalog\n");
734 	ps_printf(p, "/Pages 2 0 R\n");
735 	ps_printf(p, ">>\n");
736 	xref = p->ps->pdfbytes;
737 	ps_printf(p, "xref\n");
738 	ps_printf(p, "0 %zu\n", base + 1);
739 	ps_printf(p, "0000000000 65535 f \n");
740 
741 	for (i = 0; i < base; i++)
742 		ps_printf(p, "%.10zu 00000 n \n",
743 		    p->ps->pdfobjs[(int)i]);
744 
745 	ps_printf(p, "trailer\n");
746 	ps_printf(p, "<<\n");
747 	ps_printf(p, "/Size %zu\n", base + 1);
748 	ps_printf(p, "/Root %zu 0 R\n", base);
749 	ps_printf(p, "/Info 1 0 R\n");
750 	ps_printf(p, ">>\n");
751 	ps_printf(p, "startxref\n");
752 	ps_printf(p, "%zu\n", xref);
753 	ps_printf(p, "%%%%EOF\n");
754 }
755 
756 static void
757 ps_begin(struct termp *p)
758 {
759 	time_t		 t;
760 	int		 i;
761 
762 	/*
763 	 * Print margins into margin buffer.  Nothing gets output to the
764 	 * screen yet, so we don't need to initialise the primary state.
765 	 */
766 
767 	if (p->ps->psmarg) {
768 		assert(p->ps->psmargsz);
769 		p->ps->psmarg[0] = '\0';
770 	}
771 
772 	/*p->ps->pdfbytes = 0;*/
773 	p->ps->psmargcur = 0;
774 	p->ps->flags = PS_MARGINS;
775 	p->ps->pscol = p->ps->left;
776 	p->ps->psrow = p->ps->header;
777 
778 	ps_setfont(p, TERMFONT_NONE);
779 
780 	(*p->headf)(p, p->argf);
781 	(*p->endline)(p);
782 
783 	p->ps->pscol = p->ps->left;
784 	p->ps->psrow = p->ps->footer;
785 
786 	(*p->footf)(p, p->argf);
787 	(*p->endline)(p);
788 
789 	p->ps->flags &= ~PS_MARGINS;
790 
791 	assert(0 == p->ps->flags);
792 	assert(p->ps->psmarg);
793 	assert('\0' != p->ps->psmarg[0]);
794 
795 	/*
796 	 * Print header and initialise page state.  Following this,
797 	 * stuff gets printed to the screen, so make sure we're sane.
798 	 */
799 
800 	t = time(NULL);
801 
802 	if (TERMTYPE_PS == p->type) {
803 		ps_printf(p, "%%!PS-Adobe-3.0\n");
804 		ps_printf(p, "%%%%CreationDate: %s", ctime(&t));
805 		ps_printf(p, "%%%%DocumentData: Clean7Bit\n");
806 		ps_printf(p, "%%%%Orientation: Portrait\n");
807 		ps_printf(p, "%%%%Pages: (atend)\n");
808 		ps_printf(p, "%%%%PageOrder: Ascend\n");
809 		ps_printf(p, "%%%%DocumentMedia: "
810 		    "Default %zu %zu 0 () ()\n",
811 		    (size_t)AFM2PNT(p, p->ps->width),
812 		    (size_t)AFM2PNT(p, p->ps->height));
813 		ps_printf(p, "%%%%DocumentNeededResources: font");
814 
815 		for (i = 0; i < (int)TERMFONT__MAX; i++)
816 			ps_printf(p, " %s", fonts[i].name);
817 
818 		ps_printf(p, "\n%%%%EndComments\n");
819 	} else {
820 		ps_printf(p, "%%PDF-1.1\n");
821 		pdf_obj(p, 1);
822 		ps_printf(p, "<<\n");
823 		ps_printf(p, ">>\n");
824 		ps_printf(p, "endobj\n");
825 
826 		for (i = 0; i < (int)TERMFONT__MAX; i++) {
827 			pdf_obj(p, (size_t)i + 3);
828 			ps_printf(p, "<<\n");
829 			ps_printf(p, "/Type /Font\n");
830 			ps_printf(p, "/Subtype /Type1\n");
831 			ps_printf(p, "/Name /F%d\n", i);
832 			ps_printf(p, "/BaseFont /%s\n", fonts[i].name);
833 			ps_printf(p, ">>\n");
834 		}
835 	}
836 
837 	p->ps->pdfbody = (size_t)TERMFONT__MAX + 3;
838 	p->ps->pscol = p->ps->left;
839 	p->ps->psrow = p->ps->top;
840 	p->ps->flags |= PS_NEWPAGE;
841 	ps_setfont(p, TERMFONT_NONE);
842 }
843 
844 static void
845 ps_pletter(struct termp *p, int c)
846 {
847 	int		 f;
848 
849 	/*
850 	 * If we haven't opened a page context, then output that we're
851 	 * in a new page and make sure the font is correctly set.
852 	 */
853 
854 	if (PS_NEWPAGE & p->ps->flags) {
855 		if (TERMTYPE_PS == p->type) {
856 			ps_printf(p, "%%%%Page: %zu %zu\n",
857 			    p->ps->pages + 1, p->ps->pages + 1);
858 			ps_printf(p, "/%s %zu selectfont\n",
859 			    fonts[(int)p->ps->lastf].name,
860 			    p->ps->scale);
861 		} else {
862 			pdf_obj(p, p->ps->pdfbody +
863 			    p->ps->pages * 4);
864 			ps_printf(p, "<<\n");
865 			ps_printf(p, "/Length %zu 0 R\n",
866 			    p->ps->pdfbody + 1 + p->ps->pages * 4);
867 			ps_printf(p, ">>\nstream\n");
868 		}
869 		p->ps->pdflastpg = p->ps->pdfbytes;
870 		p->ps->flags &= ~PS_NEWPAGE;
871 	}
872 
873 	/*
874 	 * If we're not in a PostScript "word" context, then open one
875 	 * now at the current cursor.
876 	 */
877 
878 	if ( ! (PS_INLINE & p->ps->flags)) {
879 		if (TERMTYPE_PS != p->type) {
880 			ps_printf(p, "BT\n/F%d %zu Tf\n",
881 			    (int)p->ps->lastf, p->ps->scale);
882 			ps_printf(p, "%.3f %.3f Td\n(",
883 			    AFM2PNT(p, p->ps->pscol),
884 			    AFM2PNT(p, p->ps->psrow));
885 		} else
886 			ps_printf(p, "%.3f %.3f moveto\n(",
887 			    AFM2PNT(p, p->ps->pscol),
888 			    AFM2PNT(p, p->ps->psrow));
889 		p->ps->flags |= PS_INLINE;
890 	}
891 
892 	assert( ! (PS_NEWPAGE & p->ps->flags));
893 
894 	/*
895 	 * We need to escape these characters as per the PostScript
896 	 * specification.  We would also escape non-graphable characters
897 	 * (like tabs), but none of them would get to this point and
898 	 * it's superfluous to abort() on them.
899 	 */
900 
901 	switch (c) {
902 	case '(':
903 		/* FALLTHROUGH */
904 	case ')':
905 		/* FALLTHROUGH */
906 	case '\\':
907 		ps_putchar(p, '\\');
908 		break;
909 	default:
910 		break;
911 	}
912 
913 	/* Write the character and adjust where we are on the page. */
914 
915 	f = (int)p->ps->lastf;
916 
917 	if (c <= 32 || c - 32 >= MAXCHAR)
918 		c = 32;
919 
920 	ps_putchar(p, (char)c);
921 	c -= 32;
922 	p->ps->pscol += (size_t)fonts[f].gly[c].wx;
923 }
924 
925 static void
926 ps_pclose(struct termp *p)
927 {
928 
929 	/*
930 	 * Spit out that we're exiting a word context (this is a
931 	 * "partial close" because we don't check the last-char buffer
932 	 * or anything).
933 	 */
934 
935 	if ( ! (PS_INLINE & p->ps->flags))
936 		return;
937 
938 	if (TERMTYPE_PS != p->type) {
939 		ps_printf(p, ") Tj\nET\n");
940 	} else
941 		ps_printf(p, ") show\n");
942 
943 	p->ps->flags &= ~PS_INLINE;
944 }
945 
946 static void
947 ps_fclose(struct termp *p)
948 {
949 
950 	/*
951 	 * Strong closure: if we have a last-char, spit it out after
952 	 * checking that we're in the right font mode.  This will of
953 	 * course open a new scope, if applicable.
954 	 *
955 	 * Following this, close out any scope that's open.
956 	 */
957 
958 	if ('\0' != p->ps->last) {
959 		if (p->ps->lastf != TERMFONT_NONE) {
960 			ps_pclose(p);
961 			ps_setfont(p, TERMFONT_NONE);
962 		}
963 		ps_pletter(p, p->ps->last);
964 		p->ps->last = '\0';
965 	}
966 
967 	if ( ! (PS_INLINE & p->ps->flags))
968 		return;
969 
970 	ps_pclose(p);
971 }
972 
973 static void
974 ps_letter(struct termp *p, int arg)
975 {
976 	char		cc, c;
977 
978 	c = arg >= 128 || arg <= 0 ? '?' : arg;
979 
980 	/*
981 	 * State machine dictates whether to buffer the last character
982 	 * or not.  Basically, encoded words are detected by checking if
983 	 * we're an "8" and switching on the buffer.  Then we put "8" in
984 	 * our buffer, and on the next charater, flush both character
985 	 * and buffer.  Thus, "regular" words are detected by having a
986 	 * regular character and a regular buffer character.
987 	 */
988 
989 	if ('\0' == p->ps->last) {
990 		assert(8 != c);
991 		p->ps->last = c;
992 		return;
993 	} else if (8 == p->ps->last) {
994 		assert(8 != c);
995 		p->ps->last = '\0';
996 	} else if (8 == c) {
997 		assert(8 != p->ps->last);
998 		if ('_' == p->ps->last) {
999 			if (p->ps->lastf != TERMFONT_UNDER) {
1000 				ps_pclose(p);
1001 				ps_setfont(p, TERMFONT_UNDER);
1002 			}
1003 		} else if (p->ps->lastf != TERMFONT_BOLD) {
1004 			ps_pclose(p);
1005 			ps_setfont(p, TERMFONT_BOLD);
1006 		}
1007 		p->ps->last = c;
1008 		return;
1009 	} else {
1010 		if (p->ps->lastf != TERMFONT_NONE) {
1011 			ps_pclose(p);
1012 			ps_setfont(p, TERMFONT_NONE);
1013 		}
1014 		cc = p->ps->last;
1015 		p->ps->last = c;
1016 		c = cc;
1017 	}
1018 
1019 	ps_pletter(p, c);
1020 }
1021 
1022 static void
1023 ps_advance(struct termp *p, size_t len)
1024 {
1025 
1026 	/*
1027 	 * Advance some spaces.  This can probably be made smarter,
1028 	 * i.e., to have multiple space-separated words in the same
1029 	 * scope, but this is easier:  just close out the current scope
1030 	 * and readjust our column settings.
1031 	 */
1032 
1033 	ps_fclose(p);
1034 	p->ps->pscol += len;
1035 }
1036 
1037 static void
1038 ps_endline(struct termp *p)
1039 {
1040 
1041 	/* Close out any scopes we have open: we're at eoln. */
1042 
1043 	ps_fclose(p);
1044 
1045 	/*
1046 	 * If we're in the margin, don't try to recalculate our current
1047 	 * row.  XXX: if the column tries to be fancy with multiple
1048 	 * lines, we'll do nasty stuff.
1049 	 */
1050 
1051 	if (PS_MARGINS & p->ps->flags)
1052 		return;
1053 
1054 	/* Left-justify. */
1055 
1056 	p->ps->pscol = p->ps->left;
1057 
1058 	/* If we haven't printed anything, return. */
1059 
1060 	if (PS_NEWPAGE & p->ps->flags)
1061 		return;
1062 
1063 	/*
1064 	 * Put us down a line.  If we're at the page bottom, spit out a
1065 	 * showpage and restart our row.
1066 	 */
1067 
1068 	if (p->ps->psrow >= p->ps->lineheight + p->ps->bottom) {
1069 		p->ps->psrow -= p->ps->lineheight;
1070 		return;
1071 	}
1072 
1073 	ps_closepage(p);
1074 }
1075 
1076 static void
1077 ps_setfont(struct termp *p, enum termfont f)
1078 {
1079 
1080 	assert(f < TERMFONT__MAX);
1081 	p->ps->lastf = f;
1082 
1083 	/*
1084 	 * If we're still at the top of the page, let the font-setting
1085 	 * be delayed until we actually have stuff to print.
1086 	 */
1087 
1088 	if (PS_NEWPAGE & p->ps->flags)
1089 		return;
1090 
1091 	if (TERMTYPE_PS == p->type)
1092 		ps_printf(p, "/%s %zu selectfont\n",
1093 		    fonts[(int)f].name, p->ps->scale);
1094 	else
1095 		ps_printf(p, "/F%d %zu Tf\n",
1096 		    (int)f, p->ps->scale);
1097 }
1098 
1099 static size_t
1100 ps_width(const struct termp *p, int c)
1101 {
1102 
1103 	if (c <= 32 || c - 32 >= MAXCHAR)
1104 		c = 0;
1105 	else
1106 		c -= 32;
1107 
1108 	return((size_t)fonts[(int)TERMFONT_NONE].gly[c].wx);
1109 }
1110 
1111 static double
1112 ps_hspan(const struct termp *p, const struct roffsu *su)
1113 {
1114 	double		 r;
1115 
1116 	/*
1117 	 * All of these measurements are derived by converting from the
1118 	 * native measurement to AFM units.
1119 	 */
1120 
1121 	switch (su->unit) {
1122 	case SCALE_CM:
1123 		r = PNT2AFM(p, su->scale * 28.34);
1124 		break;
1125 	case SCALE_IN:
1126 		r = PNT2AFM(p, su->scale * 72.0);
1127 		break;
1128 	case SCALE_PC:
1129 		r = PNT2AFM(p, su->scale * 12.0);
1130 		break;
1131 	case SCALE_PT:
1132 		r = PNT2AFM(p, su->scale * 100.0);
1133 		break;
1134 	case SCALE_EM:
1135 		r = su->scale *
1136 		    fonts[(int)TERMFONT_NONE].gly[109 - 32].wx;
1137 		break;
1138 	case SCALE_MM:
1139 		r = PNT2AFM(p, su->scale * 2.834);
1140 		break;
1141 	case SCALE_EN:
1142 		r = su->scale *
1143 		    fonts[(int)TERMFONT_NONE].gly[110 - 32].wx;
1144 		break;
1145 	case SCALE_VS:
1146 		r = su->scale * p->ps->lineheight;
1147 		break;
1148 	default:
1149 		r = su->scale;
1150 		break;
1151 	}
1152 
1153 	return(r);
1154 }
1155 
1156 static void
1157 ps_growbuf(struct termp *p, size_t sz)
1158 {
1159 	if (p->ps->psmargcur + sz <= p->ps->psmargsz)
1160 		return;
1161 
1162 	if (sz < PS_BUFSLOP)
1163 		sz = PS_BUFSLOP;
1164 
1165 	p->ps->psmargsz += sz;
1166 	p->ps->psmarg = mandoc_realloc(p->ps->psmarg, p->ps->psmargsz);
1167 }
1168