|
|
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.