Annotation of researchv10dc/man/adm/man9/string.9, revision 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 .

unix.superglobalmegacorp.com

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