MOUSE.DOC

(22 KB) Pobierz
ÿWPCD
ûÿ2BVPZ¦Courier 10cpiøÿÿ‰?xxx,*ôxþ6X@É“8Ç;X@þþþþþþþÿþÿÿÿþÿÿþÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿHP LaserJet IIIHPLASIII.PRSÛxŒ
@ɇÏ,\,ð5 HX@#|xûÿ2B




ÁÁÁ`	`	ÁProgrammer'S Reference  Manual


1. Introduction

The MITSUMI mouse driver enables you to use mouse hardware to move
cursor on screen and control its movement through software program.
The following manual provides information to programmers who want
to include support for MOUSE.COM  in their application
programs.  This document includes descriptions of the graphics
cursor
and text cursor, and  the mouse functions.
All functions supported by MOUSE driver including:
    *. All functions supported by the Microsoft mouse driver.
    *. Some new function supported to MOUSE working in different
       modes.
All the function call interface is compatible with Microsoft
Corp.  As it is documented in the installation and operation
manual published by Microsoft Corp.  Entitled Microsoft (r) Mouse
User's Guide for IBM Personal Computers.

2. Screen Coordinated System

The MOUSE driver is compatible with the IBM Color Graphics
Adapter, the IBM Monochrome Display Adapter, the IBM Enhanced
Graphics Adapter, and the Hercules Monochrome Graphics Adapter.

The MOUSE driver works with all of the BIOS supported screen
modes for both the IBM Color/Graphics Monitor Adapter and the IBM
Monochrome Display Adapter, these modes are:
    *. High-resolution graphics mode (640 * 200, 2 colors).
    *. Medium-resolution color mode (320 * 200, 4 colors).
    *. Text mode -
       (1) 80 column by 25 row.
       (2) 40 column by 25 row.
The Hercules graphics Card is supported in monochrome graphics
mode:
    *. Monochrome Graphics (720 * 348, 2 colors).
       When you want to use MOUSE with the hercules high
       resolution modes, follow these steps:
     (1) If you are using the page at B000H, poke a 6 into the
ÁÁ memory location 40:49.
     (2) If you are using the page at B800H, poke a 5 into 40:49.


In medium-resolution mode --
    The physical coordinate is 320 pixels across by 200 pixels.
    All horizontal coordinates are mapped to even coordinates in
    logical coordinate system.  On the upper left-corner of theÔh)0*0*0*°°ÔŒ™




    screen is (0,0), on the bottommost right-corner of the screen
    is (638,0).

In 80 column by 25 row text mode --
    The logical coordinates is 640 * 200 are used.  A logical
    character size of 8 * 8 pixels is assumed.  All logical
    horizontal coordinates are multiples of eight, and all
    logical vertical coordinate are multiples of eight.

In 40 column by 25 row text mode --
    The logical coordinates is 640 * 200 are used.  A logical
    character size of 16 * 8 pixels is assumed.  All logical
    horizontal coordinates are multiples of sixteen, and all
    logical vertical coordinates are multiples of eight.


In Hercules monochrome graphics mode --
    The logical coordinates match the physical pixels.  The
    pixels on the top row have coordinates of (0,0), (1,0), etc.
    The pixels at the bottommost right of the screen is
    (719,347).

Logical coordinates are used as both input and output to mouse
function calls.  User should be careful to provide the
correct values for the current screen mode.

3. Text Cursor and Graphics Cursor

MOUSE driver supports a hardware text cursor, a software text
curosr
, and a graphics cursor.A hardware test cursor is a blinking cursor
which moves from one character to another on screen. This blinking
cursor may take the form of a block or underscore. A software text
cursor makes use of display attributes to change the visual
appearance
of a character on screen. Movment is from character to character.
A
graphics cursor is a shape that movess over on screen images. You
can
choose any of these three cursor to use on screen, howere, only one
cursor can be displayed at a given timme. Allso, within your
application
program, you can switch back and forth between cursors.


The characteristics of the cursor are determined by Functions 9
and 10.
 1). Graphics Cursor
    The cursor appears on screen or disppears from the screenÔh)0*0*0*°°ÔŒ™




    through the calling program. The graphics cursor is an array
    of pixels (normally 16 by 16).  It is defined by two arrays
    of bits called the screen mask and the cursor mask.
    The screen mask has two parts to determine the shape or the
    background of cursor pixels.  Cursor pixels are part of the
    shape (0) or of the background (1) (it is ANDed with the
    screen contents).  The cursor mask is used to determine the
    shape color  and background color of the cursor pixels (it is
    XORed with the result of the previous operation).

    The operational behavior of these bit arrays are summarized
    in the following table:

     À
ÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀ
     À	À screen mask    À	À  cursor mask  À	À resulting screen bit    À	À
     ÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀ
     À	À      0         À	À       0       À	À           0             À	À
     ÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀ
     À	À      0         À	À       1       À	À           1             À	À
     ÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀ
     À	À      1         À	À       0       À	À      unchanged          À	À
     ÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀ
     À	À      1         À	À       1       À	À        inverted         À	À
     À
ÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀ

    Note that when a mouse function refers to the graphics cursor
    location is referring to the point on the screen that lies
    directly under the cursor's target area.  The target area is
    the point in the cursor block that the mouse software uses to
    determine the cursor coordinates.  This point is called the
    hot spot of the cursor.  The upper left corner of the cursor
    block is the hot spot for the default graphic cursor.

2).  Text Cursor
    The text cursor is a cursor that can be used when the video
    is in one of the text modes.  Tow kind of text cursor are
    supported: a hardware text cursor and a software text cursor.

    a. The hardware text cursor is the cursor actually placed on
       the screen by the video controller itself.  It is defined
       in terms of the scan lines of the character cell numbered
       from 0, starting from the top scan line.  The numbers of
       scan lines on a character cell depend on the actual video
       controller and monitor (see the controller documentation
       for details).
    b. You can use this text cursor when your computer is in one
       of the text modes. By changing the character attributes
       beneath the curssor, the appearance of the character is
       influenced on screen. The software text cursor is aÔh)0*0*0*°°Ôcharacter
       code and a character attribute that replaces and/or modifies
       the character cell on the screen where it is positioned.
       The behaviors of this cursor is defined by 2 16-bit
       values.  he format of the two values is the following:
       Bit               Description
       15                blinking (1) or
ÁÁÁ`	`	ÁÁ¸¸Á non blinking (0)
       14-12             background color
       11                high intensity (1) or
ÁÁÁ`	`	ÁÁ¸¸Á medium intensity (0)
       10-8              foreground color
       7-0               character code

       The tow values are called the screen mask and the cursor
       mask.  The screen mask is used to determine which of the
       character attributes are preserved (it is ANDed with the
       screen character and attribute).  The cursor mask is used
       to determine which of the characteristics are changed by
       the cursor (it is XORed with the result of the previous
       operation).
3). Hardware text cursor
ÁÁThe cursor is available when the computer is in one of the
ÁÁtext modes. It consists of 8 pixels wide and 8 to 14 pixels
ÁÁtall. Software allows you to use this cursor when you need.
ÁÁRefer to function 10.

4. The Mouse Button

The mouse function calls can return the current state of the
mouse buttons and the number of times of a given button has been
pressed or released.  The button state is returned as a integer
value in the low order three bits are one or zero.  The following
table describes the bit status:

Bit 0: Left button state    ...
Zgłoś jeśli naruszono regulamin