|
|
1.1 root 1: .TH CANON 3R "630 MTG"
2: .XE "canon()"
3: .SH NAME
4: canon \- return canonical Rectangle format from two corner Points
5: .SH SYNOPSIS
6: .B #include <dmd.h>
7: .sp
8: .B Rectangle canon (p1, p2)
9: .br
10: .B Point p1, p2;
11: .SH DESCRIPTION
12: The
13: .I canon
14: function
15: returns a Rectangle created from two Points \fIp1\fR and \fIp2\fR such that:
16: .PP
17: .RS
18: \fIr.origin.x\fR equals the minimum of \fIp1.x\fR and \fIp2.x\fR
19: .br
20: \fIr.origin.y\fR equals the minimum of \fIp1.y\fR and \fIp2.y\fR
21: .br
22: \fIr.corner.x\fR equals the maximum of \fIp1.x\fR and \fIp2.x\fR
23: .br
24: \fIr.corner.y\fR equals the maximum of \fIp1.y\fR and \fIp2.y\fR
25: .RE
26: .PP
27: In other words,
28: the rectangle defined by the two corner points,
29: p1 and p2, is returned in the standard format of
30: (upper left, lower right).
31: .SH EXAMPLE
32: Each of the following cases will yield the Rectangle.
33: .PP
34: .RS 3
35: .ft CM
36: .nf
37: { 0, 0, 32, 32}
38:
39: canon( Pt(0, 32), Pt(32, 0) )
40:
41: canon( Pt(32, 32), Pt(0, 0) )
42:
43: canon( Pt(32, 0), Pt(0, 32) )
44: .fi
45: .ft R
46: .RE
47: .SH SEE ALSO
48: structures(3R).
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.