Return to button.9 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man9

Annotation of researchv10dc/man/adm/man9/button.9, revision 1.1.1.1

1.1       root        1: .TH BUTTON 9.2
                      2: .CT 2 comm_term
                      3: .SH NAME
                      4: button123, mouse, cursallow, cursinhibit, cursset, cursswitch, getrect123 \- mouse control
                      5: .SH SYNOPSIS
                      6: .B #include <jerq.h>
                      7: .PP
                      8: .B extern struct Mouse {
                      9: .br
                     10: .B "    Point xy;
                     11: .br
                     12: .B "    short buttons;
                     13: .br
                     14: .B } mouse;
                     15: .PP
                     16: .B int button(n)
                     17: .B int n;
                     18: .br
                     19: .B int button1(), button2(), button3();
                     20: .br
                     21: .B int button12(), button23(), button123();
                     22: .PP
                     23: .B void cursinhibit();
                     24: .br
                     25: .B void cursallow();
                     26: .PP
                     27: .B void cursset(p);
                     28: .B Point p;
                     29: .PP
                     30: .B Texture *cursswitch(t);
                     31: .B Texture *t;
                     32: .PP
                     33: .B Rectangle getrect(n)
                     34: .B int n;
                     35: .br
                     36: .B Rectangle getrect1(), getrect2(), getrect3();
                     37: .br
                     38: .B Rectangle getrect12(), getrect23(), getrect123();
                     39: .SH DESCRIPTION
                     40: When the mouse is requested
                     41: (see
                     42: .IR request (9.2)),
                     43: the mouse state is updated asynchronously in the structure
                     44: .BR mouse .
                     45: The coordinates of the mouse are held in
                     46: .BR mouse.xy ,
                     47: and the state of the buttons in
                     48: .BR mouse.buttons .
                     49: Each process's
                     50: .B mouse
                     51: structure is independent of the others, so that
                     52: (except for
                     53: .IR cursset )
                     54: actions such as
                     55: changing the tracking cursor do not affect the mouse in
                     56: other processes.
                     57: .PP
                     58: The macro
                     59: .I button
                     60: and its counterparts return the state of the associated mouse button:
                     61: non-zero if the button is depressed, 0 otherwise.
                     62: The buttons are numbered 1 to 3 from left to right.
                     63: .I Button12
                     64: and the other multi-button functions return the
                     65: OR
                     66: of their states: true if either button 1 or
                     67: button 2 is depressed.
                     68: .PP
                     69: .I Cursinhibit
                     70: turns off interrupt-time cursor tracking
                     71: (the drawing of the cursor on the screen),
                     72: although the mouse coordinates are still kept current
                     73: and available.
                     74: .I Cursallow
                     75: enables interrupt-time cursor tracking.
                     76: .I Cursallow
                     77: and
                     78: .I cursinhibit
                     79: stack: to enable cursor tracking after two calls to
                     80: .IR cursinhibit ,
                     81: two calls to
                     82: .I cursallow
                     83: are required.
                     84: .PP
                     85: .I Cursset
                     86: moves the mouse cursor to the Point
                     87: .I p.
                     88: .PP
                     89: .I Cursswitch
                     90: changes the mouse cursor (a 16\(mu16 pixel image) to that specified by the
                     91: Texture
                     92: .BI * t.
                     93: If the argument is
                     94: .BR (Texture*)0 ,
                     95: the cursor is restored to the default arrow.
                     96: .I Cursswitch
                     97: returns the previous value of the cursor: the argument of the previous
                     98: call to
                     99: .I cursswitch.
                    100: .PP
                    101: .I Getrect
                    102: prompts the user with a box cursor and waits for a
                    103: rectangle to be swept out with the named button,
                    104: identified as with the
                    105: .I button
                    106: primitives.
                    107: It returns the screen coordinates of the box swept.
                    108: The box may be partly or wholly outside the process's layer.

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