ref: f8ddcb23b9dd969875dd4e961591700c79b7d5f7
dir: /sys/man/2/addpt/
.TH ADDPT 2 .SH NAME addpt, subpt, mulpt, divpt, rectaddpt, rectsubpt, insetrect, canonrect, eqpt, eqrect, ptinrect, rectinrect, rectXrect, rectclip, combinerect, badrect, Dx, Dy, Pt, Rect, Rpt \- arithmetic on points and rectangles .SH SYNOPSIS .B #include <u.h> .br .B #include <libc.h> .br .B #include <draw.h> .PP .B Point addpt(Point p, Point q) .PP .B Point subpt(Point p, Point q) .PP .B Point mulpt(Point p, int a) .PP .B Point divpt(Point p, int a) .PP .B Rectangle rectaddpt(Rectangle r, Point p) .PP .B Rectangle rectsubpt(Rectangle r, Point p) .PP .B Rectangle insetrect(Rectangle r, int n) .PP .B Rectangle canonrect(Rectangle r) .PP .B int eqpt(Point p, Point q) .PP .B int eqrect(Rectangle r, Rectangle s) .PP .B int ptinrect(Point p, Rectangle r) .PP .B int rectinrect(Rectangle r, Rectangle s) .PP .B int rectXrect(Rectangle r, Rectangle s) .PP .B int rectclip(Rectangle *rp, Rectangle b) .PP .B void combinerect(Rectangle *rp, Rectangle b) .PP .B int badrect(Rectangle r) .PP .B int Dx(Rectangle r) .PP .B int Dy(Rectangle r) .PP .B Point Pt(int x, int y) .PP .B Rectangle Rect(int x0, int y0, int x1, int y1) .PP .B Rectangle Rpt(Point p, Point q) .SH DESCRIPTION The functions .IR Pt , .I Rect and .I Rpt construct geometrical data types from their components. .PP .I Addpt returns the Point sum of its arguments: .BI Pt( p .x+ q .x, .IB p .y+ q .y) \f1. .I Subpt returns the Point difference of its arguments: .BI Pt( p .x- q .x, .IB p .y- q .y) \f1. .I Mulpt returns the Point .BI Pt( p .x* a , .IB p .y* a ) \f1. .I Divpt returns the Point .BI Pt( p .x/ a , .IB p .y/ a ) \f1. .PP .I Rectaddpt returns the Rectangle .BI Rpt(addpt( r .min, .IB p ) \f1, .BI addpt( r .max, .IB p )) \f1; .I rectsubpt returns the Rectangle .BI Rpt(subpt( r .min, .IB p ), .BI subpt( r .max, .IB p ))\fR. .PP .I Insetrect returns the Rectangle .BI Rect( r .min.x+ n \f1, .IB r .min.y+ n \f1, .IB r .max.x- n \f1, .IB r .max.y- n ) \f1. .PP .I Canonrect returns a rectangle with the same extent as .IR r , canonicalized so that .B min.x ≤ .BR max.x , and .B min.y ≤ .BR max.y . .PP .I Eqpt compares its argument Points and returns 0 if unequal, 1 if equal. .I Eqrect does the same for its argument Rectangles. .PP .I Ptinrect returns 1 if .I p is a point within .IR r , and 0 otherwise. .PP .I Rectinrect returns 1 if all the pixels in .I r are also in .IR s , and 0 otherwise. .PP .I RectXrect returns 1 if .I r and .I s share any point, and 0 otherwise. .PP .I Rectclip clips in place the Rectangle pointed to by .I rp so that it is completely contained within .IR b . The return value is 1 if any part of .RI * rp is within .IR b . Otherwise, the return value is 0 and .RI * rp is unchanged. .PP .I Combinerect overwrites .B *rp with the smallest rectangle sufficient to cover all the pixels of .B *rp and .BR b . .PP .I Badrect returns 1 if .I r is zero, negative size or insanely huge rectangle. It returns 0 otherwise. .PP The functions .I Dx and .I Dy give the width (Δx) and height (Δy) of a Rectangle. They are implemented as macros. .SH SOURCE .B /sys/src/libdraw .SH SEE ALSO .IR graphics (2)