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