Previous

Next

Function RTInitTextMouse

Function RTInitTextMouse installs and initializes RTTarget-32's mouse driver. Unlike RTInitMouse, this driver also displays a text mode mouse cursor if the program uses console I/O functions to write to the screen:

void RTInitTextMouse(int PortIOBase, int PortIRQ, 
                     int DoubleClickSpeed, 
                     int ScaleX, int ScaleY, 
                     char PointerChar, 
                     unsigned char PointerColor);

Parameters

PortIOBase

The port I/O address of the serial port used by the mouse. For standard ports, you should use 3F8h (COM1), 2F8h (COM2), 3E8h (COM3), or 2E8h (COM4). For a PS/2 mouse or PS/2 compatible touch screen, this parameter must be -1.

PortIRQ

The interrupt request line of the serial port. Typical values are 4, 3, 4, and 3 for the ports COM 1, 2, 3, and 4, respectively. PS/2 mice always use IRQ 12; thus, RTInitTextMouse ignores this value for PS/2 mice.

DoubleClickSpeed

Maximum number of milliseconds between left button clicks to form a double click. This value may be zero. In this case, a default value of 300 is used.

ScaleX

The factor by which raw horizontal mouse motion is divided. Large values cause slow mouse motion. If set to zero, the default of 3 is used.

ScaleY

The factor by which raw vertical mouse motion is divided. Large values cause slow mouse motion. If set to zero, the default of 8 is used.

PointerChar

The character value to represent the mouse pointer. Zero will produce a blank pointer.

PointerColor

The screen attribute of the mouse pointer. Zero will produce a black mouse pointer.

Please see section Win32 Console I/O for information on how mouse and keyboard events are processed by RTTarget-32.

The Turbo Vision TVDemo example included with RTTarget-32 demonstrates how to use this text mode mouse driver.

Function RTInitMouse

Function RTSetMousePos