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