Return to string.3r CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / p_man / man3

Annotation of researchv10dc/630/man/src/p_man/man3/string.3r, revision 1.1.1.1

1.1       root        1: .ds ZZ DEVELOPMENT PACKAGE
                      2: .TH STRING 3R "630 MTG"
                      3: .XE "string()"
                      4: .XE "smallfont"
                      5: .XE "mediumfont"
                      6: .XE "largefont"
                      7: .XE "FONTWIDTH()"
                      8: .XE FONTHEIGHT()"
                      9: .SH NAME  
                     10: string, FONTWIDTH, FONTHEIGHT, smallfont, mediumfont, largefont \- draw string in bitmap
                     11: .SH SYNOPSIS
                     12: \f3
                     13: #include <dmd.h>
                     14: .br
                     15: #include <font.h>
                     16: .sp
                     17: Point string (ft, s, b, p, f)
                     18: .br
                     19: Font \(**ft; 
                     20: .br 
                     21: char \(**s;
                     22: .br 
                     23: Bitmap \(**b;
                     24: .br 
                     25: Point p;
                     26: .br 
                     27: Code f;
                     28: .sp
                     29: int FONTWIDTH (fnt)
                     30: .br
                     31: int FONTHEIGHT (fnt)
                     32: .sp
                     33: Font fnt;
                     34: .sp
                     35: Font smallfont;
                     36: .br
                     37: Font mediumfont;
                     38: .br
                     39: Font largefont;
                     40: \f1
                     41: .SH DESCRIPTION
                     42: The
                     43: .I string
                     44: function
                     45: draws the null-terminated string
                     46: .I s
                     47: using characters from Font
                     48: .I \(**ft
                     49: in Bitmap
                     50: .I \(**b
                     51: at Point
                     52: .I p
                     53: with function Code
                     54: .IR f .
                     55: The returned Point value is the location of the first character position
                     56: following the string
                     57: .IR s .
                     58: The returned Point can be passed to successive calls to
                     59: .I string
                     60: to concatenate strings.
                     61: .PP
                     62: The drawing of the characters is done such that the bounding rectangle
                     63: of the maximum height character in the font would have its origin at
                     64: .IR p .
                     65: Therefore, a character drawn on the screen at the point
                     66: .I Drect.origin
                     67: will occupy the upper-leftmost character position of the application's
                     68: window.
                     69: .PP
                     70: The
                     71: .I string
                     72: function
                     73: draws characters as they are in the font.
                     74: No special action is taken for control characters such as tabs and newlines.
                     75: .PP
                     76: The globals
                     77: .IR smallfont ,
                     78: .IR mediumfont ,
                     79: and
                     80: .IR largefont
                     81: are the names of, not pointers to, the three resident fonts in the 630
                     82: MTG.
                     83: .P
                     84: The
                     85: .I FONTWIDTH
                     86: macro returns the width of the space character in the given
                     87: font. This is only useful if all
                     88: the characters in the font have the same width.
                     89: The
                     90: .I FONTHEIGHT
                     91: macro returns the height of the given font.
                     92: .bp
                     93: .SH EXAMPLE
                     94: The following example demonstrates the use of
                     95: .I string.
                     96: The simple subroutine prints "hello world" using the resident font
                     97: called 
                     98: .I largefont .
                     99: .PP
                    100: .RS 3
                    101: .nf
                    102: .ft CM
                    103: #include <dmd.h>
                    104: #include <font.h>
                    105: 
                    106: Point add();
                    107: Point string();
                    108: 
                    109: hello_world()
                    110: {
                    111:        Font *f;
                    112:        Point p;
                    113: 
                    114:        f = &largefont;
                    115:        p = add (Drect.origin, Pt(4,4));
                    116:        string (f, "hello world", &display, p, F_XOR);
                    117: }
                    118: \fR
                    119: .fi
                    120: .RE
                    121: .SH SEE ALSO
                    122: loadfont(1), jstring(3R), structures(3R).

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