.TH POINTER 3.SH NAMEpointer \- mouse and stylus interface.SH SYNOPSIS.B "bind -a #m /dev".PP.B /dev/cursor.br.B /dev/pointer.SH DESCRIPTIONThe.I pointerdevice is the interface to input from a mouse, stylus, or some other devicefor pointing at positions on a display.On some platforms, the pointer is associated with a cursoron the display, that is displayed at the current pointer position.There often are buttons associated with the pointer, whether onthe pointing device or elsewhere.For instance, some of the buttons on a PDA might be associatedwith the stylus not a keypad, to allow modification of stylus actionswhen there are are no buttons on the stylus itself.In the hosted environment of.IR emu (1),the pointer is associated with the host system's own pointing device..PPReading the.B pointerfile returns the current pointer position and the state of any buttons associated with the pointer.The read blocks until the state has changed since the last read.Each read returns a 49 byte record:.IP.BI m "x y buttons msec".PPEach record has the letter.B mimmedlately followed by four 11-character decimal numbers, each number ended by a blank..I Xand.I ygive the coordinates of the pointer in display coordinates;the value.I buttonshas bit.RI "(1<<" b )set when button.I bis down; and.I msecis a time stamp in milliseconds..PPWriting a record of the above form to.B pointermoves the displayed cursor to the given.I xand.I yposition;.I buttonsand.I msecare ignored..PPWriting an.IR image (6)file to the.B cursorfile sets the image of the cursor on the display.Reading.B cursorreturns the current cursor image, again in.IR image (6)format..SH SOURCE.B /emu/port/devpointer.c.br.B /os/port/devpointer.c.SH SEE ALSO.IR wm (1),.IR draw-intro (2),.IR image (6)