Return to string.9 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man9

Annotation of researchv10dc/man/adm/man9/string.9, revision 1.1.1.1

1.1       root        1: .TH STRING 9.3
                      2: .CT 2 comm_term
                      3: .SH NAME
                      4: string, defont, strwidth, infont, outfont, getfont \- text and font operations
                      5: .SH SYNOPSIS
                      6: .B #include <jerq.h>
                      7: .br
                      8: .B #include <font.h>
                      9: .PP
                     10: .B Point string(ft, s, b, p, f)
                     11: .B "Font *ft; char *s; Bitmap *b; Point p; Code f;
                     12: .PP
                     13: .B extern Font defont;
                     14: .PP
                     15: .B "int strwidth(ft, s) Font *ft; char *s;
                     16: .PP
                     17: .B "Font *infont(inch) int (*inch)();
                     18: .PP
                     19: .B "int outfont(ft, ouch) Font *ft; int (*ouch)();
                     20: .PP
                     21: .B void ffree(ft) Font *ft;
                     22: .PP
                     23: .B #include <jerqio.h>
                     24: .PP
                     25: .B "Font *getfont(file) char *file;
                     26: .SH DESCRIPTION
                     27: .I String
                     28: draws the null-terminated string
                     29: .I s
                     30: using characters from font
                     31: .I ft
                     32: in Bitmap
                     33: .I b
                     34: at Point
                     35: .IR p ,
                     36: with Code
                     37: .IR f .
                     38: The return value is the location of the first character
                     39: .I after
                     40: .IR s ;
                     41: passed to another call to
                     42: .IR string ,
                     43: the two strings will be concatenated.
                     44: The characters are drawn such that the
                     45: .B origin
                     46: point of the bounding rectangle of a maximum height character
                     47: lies at
                     48: .IR p .
                     49: Therefore, a character drawn on the screen at (0,0)
                     50: will occupy the upper-leftmost character position on the screen.
                     51: .I String
                     52: draws characters as they are in the font.
                     53: No special action is taken for control characters such as tabs or newlines.
                     54: .PP
                     55: The global
                     56: .I defont
                     57: is the name of the standard font (not a pointer to it).
                     58: .PP
                     59: .I Strwidth
                     60: returns the width in pixels
                     61: of the null-terminated string
                     62: .IR s ,
                     63: interpreted in the Font
                     64: .IR *ft .
                     65: The height of a character string is simply
                     66: .BI ft ->height.
                     67: .PP
                     68: .I Infont
                     69: creates a font by reading the byte-wise binary representation
                     70: returned by successive calls to
                     71: .IR inch .
                     72: It returns 0
                     73: on error.
                     74: .I Inch
                     75: must return successive bytes of the Unix file representation of the font,
                     76: and \-1
                     77: at end-of-file.
                     78: .I Outfont
                     79: calls the routine
                     80: .I ouch
                     81: to write successive bytes of the binary representation of font
                     82: .IR ft .
                     83: It returns
                     84: \-1
                     85: on error, as must
                     86: .I ouch .
                     87: For programs running under
                     88: .IR jx ,
                     89: .I getfont
                     90: returns a pointer to a font read from the named
                     91: .IR file ,
                     92: essentially by calling
                     93: .I infont
                     94: with argument routine
                     95: .IR getc .
                     96: It returns 0
                     97: on error.
                     98: .I Ffree
                     99: frees a font allocated by
                    100: .I infont
                    101: or
                    102: .IR getfont .

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.