/* * line formatting buffer for line adjustment and hyphenation * * The line formatting buffer does two main functions: breaking * words into lines (possibly after breaking them at their * hyphenation points), and, if requested, adjusting the space * between words in a line. In this file the first step is * referred to as filling. * * Functions like fmt_word() return nonzero on failure, which * means the call should be repeated after fetching previously * formatted lines via fmt_nextline(). */ #include #include #include #include "roff.h" #define FMT_LLEN(f) MAX(0, (f)->ll - (f)->li) #define FMT_FILL(f) (!n_ce && n_u) #define FMT_ADJ(f) (n_u && !n_na && !n_ce && (n_j & AD_B) == AD_B) struct word { char *s; int wid; /* word's width */ int elsn, elsp; /* els_neg and els_pos */ int gap; /* the space before this word */ int hy; /* hyphen width if inserted after this word */ int str; /* does the space before it stretch */ }; struct line { struct sbuf sbuf; int wid, li, ll; int elsn, elsp; }; struct fmt { /* queued words */ struct word words[NWORDS]; int nwords; /* queued lines */ struct line lines[NLINES]; int l_head, l_tail; /* for paragraph adjustment */ long best[NWORDS]; int best_pos[NWORDS]; int best_dep[NWORDS]; /* current line */ int gap; /* space before the next word */ int nls; /* newlines before the next word */ int nls_sup; /* suppressed newlines */ int li, ll; /* current line indentation and length */ int filled; /* filled all words in the last fmt_fill() */ int eos; /* last word ends a sentence */ int fillreq; /* fill after the last word (\p) */ }; /* .ll, .in and .ti are delayed until the partial line is output */ static void fmt_confupdate(struct fmt *f) { f->ll = n_l; f->li = n_ti >= 0 ? n_ti : n_i; n_ti = -1; } static int fmt_confchanged(struct fmt *f) { return f->ll != n_l || f->li != (n_ti >= 0 ? n_ti : n_i); } /* move words inside an fmt struct */ static void fmt_movewords(struct fmt *a, int dst, int src, int len) { memmove(a->words + dst, a->words + src, len * sizeof(a->words[0])); } /* move words from the buffer to s */ static int fmt_wordscopy(struct fmt *f, int beg, int end, struct sbuf *s, int *els_neg, int *els_pos) { struct word *wcur; int w = 0; int i; *els_neg = 0; *els_pos = 0; for (i = beg; i < end; i++) { wcur = &f->words[i]; sbuf_printf(s, "%ch'%du'", c_ec, wcur->gap); sbuf_append(s, wcur->s); w += wcur->wid + wcur->gap; if (wcur->elsn < *els_neg) *els_neg = wcur->elsn; if (wcur->elsp > *els_pos) *els_pos = wcur->elsp; free(wcur->s); } if (beg < end) { wcur = &f->words[end - 1]; if (wcur->hy) sbuf_append(s, "\\(hy"); w += wcur->hy; } return w; } static int fmt_nlines(struct fmt *f) { if (f->l_tail <= f->l_head) return f->l_head - f->l_tail; return NLINES - f->l_tail + f->l_head; } /* the total width of the specified words in f->words[] */ static int fmt_wordslen(struct fmt *f, int beg, int end) { int i, w = 0; for (i = beg; i < end; i++) w += f->words[i].wid + f->words[i].gap; return beg < end ? w + f->words[end - 1].hy : 0; } /* the number of stretchable spaces in f */ static int fmt_spaces(struct fmt *f, int beg, int end) { int i, n = 0; for (i = beg + 1; i < end; i++) if (f->words[i].str) n++; return n; } /* the amount of stretchable spaces in f */ static int fmt_spacessum(struct fmt *f, int beg, int end) { int i, n = 0; for (i = beg + 1; i < end; i++) if (f->words[i].str) n += f->words[i].gap; return n; } /* return the next line in the buffer */ int fmt_nextline(struct fmt *f, struct sbuf *sbuf, int *w, int *li, int *ll, int *els_neg, int *els_pos) { struct line *l; l = &f->lines[f->l_tail]; if (f->l_head == f->l_tail) return 1; *li = l->li; *ll = l->ll; *w = l->wid; *els_neg = l->elsn; *els_pos = l->elsp; sbuf_append(sbuf, sbuf_buf(&l->sbuf)); sbuf_done(&l->sbuf); f->l_tail = (f->l_tail + 1) % NLINES; return 0; } static struct line *fmt_mkline(struct fmt *f) { struct line *l = &f->lines[f->l_head]; if ((f->l_head + 1) % NLINES == f->l_tail) return NULL; f->l_head = (f->l_head + 1) % NLINES; l->li = f->li; l->ll = f->ll; sbuf_init(&l->sbuf); return l; } static int fmt_sp(struct fmt *f) { struct line *l; if (fmt_fill(f)) return 1; l = fmt_mkline(f); if (!l) return 1; f->filled = 0; f->nls--; f->nls_sup = 0; l->wid = fmt_wordscopy(f, 0, f->nwords, &l->sbuf, &l->elsn, &l->elsp); f->nwords = 0; f->fillreq = 0; return 0; } int fmt_br(struct fmt *f) { if (fmt_fill(f)) return 1; f->filled = 0; if (f->nwords) fmt_sp(f); return 0; } void fmt_space(struct fmt *fmt) { fmt->gap += font_swid(dev_font(n_f), n_s, n_ss); } int fmt_newline(struct fmt *f) { f->gap = 0; if (!FMT_FILL(f)) { f->nls++; fmt_sp(f); return 0; } if (f->nls >= 1) if (fmt_sp(f)) return 1; if (f->nls == 0 && !f->filled && !f->nwords) fmt_sp(f); f->nls++; return 0; } /* format the paragraph after the next word (\p) */ int fmt_fillreq(struct fmt *f) { if (f->fillreq > 0) if (fmt_fill(f)) return 1; f->fillreq = f->nwords + 1; return 0; } static void fmt_wb2word(struct fmt *f, struct word *word, struct wb *wb, int hy, int str, int gap) { int len = strlen(wb_buf(wb)); word->s = xmalloc(len + 1); memcpy(word->s, wb_buf(wb), len + 1); word->wid = wb_wid(wb); word->elsn = wb->els_neg; word->elsp = wb->els_pos; word->hy = hy ? wb_dashwid(wb) : 0; word->str = str; word->gap = gap; } /* find explicit hyphenation positions: dashes, \: and \% */ static int fmt_hyphmarks(char *word, int *hyidx, int *hyins) { char d[ILNLEN]; char *s = word; int c, n = 0; while ((c = escread(&s, d)) > 0) ; if (c < 0 || !strcmp(c_hc, d)) return -1; while ((c = escread(&s, d)) >= 0 && n < NHYPHSWORD) { if (!c && !strcmp(c_hc, d)) { hyins[n] = 1; hyidx[n++] = s - word; } if (!c && (!strcmp(c_bp, d) || c_isdash(d))) { hyins[n] = 0; hyidx[n++] = s - word; } } return n; } static void fmt_insertword(struct fmt *f, struct wb *wb, int gap) { int hyidx[NHYPHSWORD]; int hyins[NHYPHSWORD] = {0}; char *src = wb_buf(wb); struct wb wbc; char *beg; char *end; int n, i; int cf, cs, cm; n = fmt_hyphmarks(src, hyidx, hyins); if (n <= 0) { fmt_wb2word(f, &f->words[f->nwords++], wb, 0, 1, gap); return; } wb_init(&wbc); for (i = 0; i <= n; i++) { beg = src + (i > 0 ? hyidx[i - 1] : 0); end = src + (i < n ? hyidx[i] : strlen(src)); wb_catstr(&wbc, beg, end); fmt_wb2word(f, &f->words[f->nwords++], &wbc, i < n && hyins[i], i == 0, i == 0 ? gap : 0); /* restoring wbc */ wb_fnszget(&wbc, &cs, &cf, &cm); wb_reset(&wbc); wb_fnszset(&wbc, cs, cf, cm); } wb_done(&wbc); } /* the amount of space necessary before the next word */ static int fmt_wordgap(struct fmt *f) { int nls = f->nls || f->nls_sup; int swid = font_swid(dev_font(n_f), n_s, n_ss); if (f->eos && f->nwords) if ((nls && !f->gap) || (!nls && f->gap == 2 * swid)) return swid + font_swid(dev_font(n_f), n_s, n_sss); return (nls && !f->gap && f->nwords) ? swid : f->gap; } /* insert wb into fmt */ int fmt_word(struct fmt *f, struct wb *wb) { if (wb_empty(wb)) return 0; if (f->nwords + NHYPHSWORD >= NWORDS || fmt_confchanged(f)) if (fmt_fill(f)) return 1; if (FMT_FILL(f) && f->nls && f->gap) if (fmt_sp(f)) return 1; if (!f->nwords) /* apply the new .l and .i */ fmt_confupdate(f); f->gap = fmt_wordgap(f); f->eos = wb_eos(wb); fmt_insertword(f, wb, f->filled ? 0 : f->gap); f->filled = 0; f->nls = 0; f->nls_sup = 0; f->gap = 0; return 0; } /* assuming an empty line has cost 10000; take care of integer overflow */ #define POW2(x) ((x) * (x)) #define FMT_COST(lwid, llen, pen) (POW2(((llen) - (lwid)) * 1000l / (llen)) / 100l + (pen) * 10l) /* the cost of putting a line break before word pos */ static long fmt_findcost(struct fmt *f, int pos) { int i, pen = 0; long cur; int lwid = 0; /* current line length */ int swid = 0; /* amount of spaces */ int llen = MAX(1, FMT_LLEN(f)); if (pos <= 0) return 0; if (f->best_pos[pos] >= 0) return f->best[pos]; i = pos - 1; lwid = 0; if (f->words[i].hy) /* the last word is hyphenated */ lwid += f->words[i].hy; if (f->words[i].hy) pen = n_hyp; while (i >= 0) { lwid += f->words[i].wid; if (i + 1 < pos) lwid += f->words[i + 1].gap; if (i + 1 < pos && f->words[i + 1].str) swid += f->words[i + 1].gap; if (lwid - (swid * n_ssh / 100) > llen) if (pos - i > 1) break; cur = fmt_findcost(f, i) + FMT_COST(lwid, llen, pen); if (f->best_pos[pos] < 0 || cur < f->best[pos]) { f->best_pos[pos] = i; f->best_dep[pos] = f->best_dep[i] + 1; f->best[pos] = cur; } i--; } return f->best[pos]; } static int fmt_bestpos(struct fmt *f, int pos) { fmt_findcost(f, pos); return MAX(0, f->best_pos[pos]); } static int fmt_bestdep(struct fmt *f, int pos) { fmt_findcost(f, pos); return MAX(0, f->best_dep[pos]); } /* return the last filled word */ static int fmt_breakparagraph(struct fmt *f, int pos) { int i; int best = -1; int llen = FMT_LLEN(f); int lwid = 0; if (f->fillreq > 0 && f->fillreq <= f->nwords) { fmt_findcost(f, f->fillreq); return f->fillreq; } if (pos > 0 && f->words[pos - 1].wid >= llen) { fmt_findcost(f, pos); return pos; } i = pos - 1; lwid = 0; if (f->words[i].hy) /* the last word is hyphenated */ lwid += f->words[i].hy; while (i >= 0) { lwid += f->words[i].wid; if (i + 1 < pos) lwid += f->words[i + 1].gap; if (lwid > llen && i + 1 < pos) break; if (best < 0 || fmt_findcost(f, i) < fmt_findcost(f, best)) best = i; i--; } return best; } /* extract the first nreq formatted lines before the word at pos */ static int fmt_head(struct fmt *f, int nreq, int pos) { int best = pos; /* best line break for nreq-th line */ int prev, next; /* best line breaks without hyphenation */ if (nreq <= 0 || fmt_bestdep(f, pos) < nreq) return pos; /* finding the optimal line break for nreq-th line */ while (best > 0 && fmt_bestdep(f, best) > nreq) best = fmt_bestpos(f, best); prev = best; next = best; /* finding closest line breaks without hyphenation */ while (prev > 1 && f->words[prev - 1].hy && fmt_bestdep(f, prev - 1) == nreq) prev--; while (next < pos && f->words[next - 1].hy && fmt_bestdep(f, next + 1) == nreq) next++; /* choosing the best of them */ if (!f->words[prev - 1].hy && !f->words[next - 1].hy) return fmt_findcost(f, prev) <= fmt_findcost(f, next) ? prev : next; if (!f->words[prev - 1].hy) return prev; if (!f->words[next - 1].hy) return next; return best; } /* break f->words[0..end] into lines according to fmt_bestpos() */ static int fmt_break(struct fmt *f, int end) { int llen, fmt_div, fmt_rem, beg; int w, i, nspc; struct line *l; int ret = 0; beg = fmt_bestpos(f, end); if (beg > 0) ret += fmt_break(f, beg); l = fmt_mkline(f); if (!l) return ret; llen = FMT_LLEN(f); f->words[beg].gap = 0; w = fmt_wordslen(f, beg, end); nspc = fmt_spaces(f, beg, end); if (FMT_ADJ(f) && nspc) { fmt_div = (llen - w) / nspc; fmt_rem = (llen - w) % nspc; if (fmt_rem < 0) { fmt_div--; fmt_rem += nspc; } for (i = beg + 1; i < end; i++) if (f->words[i].str) f->words[i].gap += fmt_div + (fmt_rem-- > 0); } l->wid = fmt_wordscopy(f, beg, end, &l->sbuf, &l->elsn, &l->elsp); if (beg > 0) fmt_confupdate(f); return ret + (end - beg); } /* estimated number of lines until traps or the end of a page */ static int fmt_safelines(void) { int lnht = MAX(1, n_L) * n_v; return (f_nexttrap() + lnht - 1) / lnht; } /* fill the words collected in the buffer */ int fmt_fill(struct fmt *f) { int nreq; /* the number of lines until a trap */ int end; /* the final line ends before this word */ int end_head; /* like end, but only the first nreq lines included */ int head = 0; /* only nreq first lines have been formatted */ int llen; /* line length, taking shrinkable spaces into account */ int n, i; if (!FMT_FILL(f)) return 0; llen = fmt_wordslen(f, 0, f->nwords) - fmt_spacessum(f, 0, f->nwords) * n_ssh / 100; /* not enough words to fill */ if ((f->fillreq <= 0 || f->nwords < f->fillreq) && llen <= FMT_LLEN(f)) return 0; nreq = (n_hy & HY_LAST) ? fmt_safelines() : 0; if (nreq > 0 && nreq <= fmt_nlines(f)) return 1; /* resetting positions */ for (i = 0; i < f->nwords + 1; i++) f->best_pos[i] = -1; end = fmt_breakparagraph(f, f->nwords); if (nreq > 0) { end_head = fmt_head(f, nreq - fmt_nlines(f), end); head = end_head < end; end = end_head; } /* recursively add lines */ n = fmt_break(f, end); f->nwords -= n; f->fillreq -= n; fmt_movewords(f, 0, n, f->nwords); f->filled = n && !f->nwords; if (f->nwords) f->words[0].gap = 0; if (f->nwords) /* apply the new .l and .i */ fmt_confupdate(f); return head || n != end; } struct fmt *fmt_alloc(void) { struct fmt *fmt = xmalloc(sizeof(*fmt)); memset(fmt, 0, sizeof(*fmt)); return fmt; } void fmt_free(struct fmt *fmt) { free(fmt); } int fmt_wid(struct fmt *fmt) { return fmt_wordslen(fmt, 0, fmt->nwords) + fmt_wordgap(fmt); } int fmt_morewords(struct fmt *fmt) { return fmt_morelines(fmt) || fmt->nwords; } int fmt_morelines(struct fmt *fmt) { return fmt->l_head != fmt->l_tail; } /* suppress the last newline */ void fmt_suppressnl(struct fmt *fmt) { if (fmt->nls) { fmt->nls--; fmt->nls_sup = 1; } }