Return to newrect.3r CVS log

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

Annotation of researchv10dc/630/man/src/p_man/man3/newrect.3r, revision 1.1

1.1     ! root        1: .ds ZZ DEVELOPMENT PACKAGE
        !             2: .TH NEWRECT 3R "630 MTG"
        !             3: .XE "newrect()"
        !             4: .SH NAME
        !             5: newrect \- get swept or default rectangle
        !             6: .SH SYNOPSIS
        !             7: .B #include <dmd.h>
        !             8: .sp
        !             9: .B Rectangle newrect (btn, rect)
        !            10: .br
        !            11: .B int btn;
        !            12: .br
        !            13: .B Rectangle rect;
        !            14: .SH DESCRIPTION
        !            15: The
        !            16: .I newrect
        !            17: function
        !            18: prompts the user with a sweep cursor and an outline of the
        !            19: specified Rectangle \f2rect\f1, which then moves with the mouse.
        !            20: The function then busy waits for a
        !            21: Rectangle to be swept out with the specified 
        !            22: .I btn
        !            23: button,
        !            24: or for the outline to be chosen by a click of 
        !            25: .I btn.
        !            26: The function then returns the screen coordinates of the created Rectangle.
        !            27: If any button other than 
        !            28: .I btn
        !            29: is depressed at any stage of the operation, 
        !            30: .I newrect
        !            31: returns a null size Rectangle (i.e., the lower right corner is equal
        !            32: to the upper left origin). If \f2rect\f1 is a null size
        !            33: Rectangle, no outline will be presented; only a sweep cursor
        !            34: will appear.
        !            35: 
        !            36: .SH EXAMPLE
        !            37: The following routine will permit the user to sweep out a Rectangle.
        !            38: As long as the Rectangle swept out does not have any points in common with
        !            39: .IR Drect ,
        !            40: the user will be prompted to sweep out another Rectangle.
        !            41: Once the swept out Rectangle has points within
        !            42: .IR Drect ,
        !            43: the Rectangle will be clipped to \fIDrect\fR and returned.
        !            44: .PP
        !            45: .RS 3
        !            46: .ft CM
        !            47: .nf
        !            48: #include <dmd.h>
        !            49: 
        !            50: Rectangle
        !            51: sweep_rect( )
        !            52: {
        !            53:        Rectangle r;
        !            54: 
        !            55:        do
        !            56:                r = newrect(2, Drect);
        !            57:        while (!rectclip(&r, Drect));
        !            58:        return r;
        !            59: }
        !            60: .fi
        !            61: .ft R
        !            62: .RE
        !            63: 
        !            64: .SH SEE ALSO
        !            65: box(3R), rectclip(3R).
        !            66: 
        !            67: .SH DIAGNOSTICS
        !            68: A mouse click is detected by the amount of mouse movement, not by the
        !            69: time between a button depression and release. The function \fInewrect\fR
        !            70: will see as a click any sweeping action whose result is a Rectangle less than 20 by 20
        !            71: pixels. 

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