Tag Archives: RAT_ON()

SP_RAT_ROWL

Posted on by vivaclipper 
RAT_ROWL() Returns mouse row at the last left button press

 Returns
 <nRow> => mouse row at last left button press

 Syntax
 RAT_ROWL()

 Description
 Returns mouse row at the last left button press (as
 recorded by a call to rat_leftb() )

 Examples
  if rat_leftb()

    ?"While you were out:"

    ?"Left button was depressed at"

    ??rat_rowl(),rat_coll()

  endif

 Notes:
 This is different from RAT_ROW() in that RAT_ROW()
 tells the mouse row NOW wherease RAT_ROWL() tells where the
 mouse was at the last recorded left button press (as recorded by
 a call to rat_leftb() )

 Source: S_MOUSE.ASM

 

SP_RAT_ROW

Posted on by vivaclipper 
RAT_ROW() Current mouse row

 Returns
 <nRow> => mouse row right now

 Syntax
 RAT_ROW()

 Description
 This gives the CURRENT mouse row

 Examples
  ?"Mouse is at row :",rat_row()

 Notes:
 This is different from RAT_ROWL() or RAT_ROWR() in
 that these two functions return the recorded row when the mouse
 button was last pressed, RAT_ROWL() for left or RAT_ROWR() for
 right.

 This function tells where the mouse is right now.

 Source: S_MOUSE.ASM

 

SP_RAT_POSIT

Posted on by vivaclipper 
RAT_POSIT() Positions the mouse cursor at row,column
 coordinates

 Returns
 None

 Syntax
 RAT_POSIT(nRow,nColumn)

 Description
 Move the mouse cursor to nRow,nColumn.

 Examples
  RAT_OFF()

  RAT_POSIT(0,0)  // upper left hand corner

  RAT_ON()

 Notes:
 Be sure to RAT_OFF() before doing this.

 Source: S_MOUSE.ASM

SP_RAT_ON

Posted on by vivaclipper 
RAT_ON() Sets the mouse cursor on

 Returns
 None

 Syntax
 RAT_ON()

 Description
 Turns the mouse cursor on

 Examples
  if rat_exist()
    rat_on()
    * do something, or wait for something...
    rat_off()

  endif

 Notes:
 There must be a rat_on() call for each rat_off() call
 in succession.

 In other words, if you do:
          rat_off()
          rat_off()

 you must then do:
          rat_on()
          rat_on()

 to turn on the mouse cursor, as it is stacked.

 e.g.

        if rat_exist()
          rat_on()
          * do something, or wait for something...
          rat_off()
        endif

 RAT_EVENT() takes care of the mouse on/off settings,
 so if you use RAT_EVENT(), you need not use RAT_ON()/RAT_OFF()

 Source: S_MOUSE.ASM

 

SP_RAT_OFF

Posted on by vivaclipper 
RAT_OFF() Sets the mouse cursor off

 Returns
 None

 Syntax
 RAT_OFF()

 Description
 Turns the mouse cursor off

 Examples
  if rat_exist()
    rat_on()
    * do something, or wait for something...
    rat_off()
  endif

 Notes:
 There must be a rat_on() call for each rat_off() call
 in succession.

 In other words, if you do:
          rat_off()
          rat_off()

 you must then do:
          rat_on()
          rat_on()

 to turn on the mouse cursor, as it is stacked.

 e.g.

        if rat_exist()
          rat_on()
          * do something, or wait for something...
          rat_off()
        endif

 RAT_EVENT() takes care of the mouse on/off settings,
 so if you use RAT_EVENT(), you need not use RAT_ON()/RAT_OFF()

 Source: S_MOUSE.ASM

 

SP_RAT_LEFTB

Posted on by vivaclipper

 RAT_LEFTB() Determines if the left mouse button has been

 pressed

 Returns
 <lHasBeenPressed> => left mouse button has been
 pressed

 Syntax
 RAT_LEFTB()

 Description
 This returns .t. if the left button has been pressed
 since last call to this function. Row and column are recorded
 for reference by rat_rowl() and rat_coll().

 Examples
  if rat_leftb()

    ?"While you were out:"

    ?"Left button was depressed at"

    ??rat_rowl(),rat_coll()

  endif

 Notes:
 This is different from RAT_LBHD() in that RAT_LBHD()
 is a 'right now' function - determining if the button IS
 depressed, whereas this function determines if the button HAS
 been depressed.

 Source: S_MOUSE.ASM

 

SP_RAT_EXIST

Posted on by vivaclipper 
RAT_EXIST() Determines if a mouse is available

 Returns
 <lExists> => mouse is available

 Syntax
 RAT_EXIST()

 Description
 This tells if a mouse is present, and mouse driver
 software is loaded. The mouse state is not changed.

 Examples
  if rat_exist()
    * do some mouse stuff
  else
    * don't do some mouse stuff
  endif

 Notes:
 Many mouse libraries use a call to Interrupt 33,
 service 0 to determine if a mouse is present. This has the
 unpleasant effect of  resetting the mouse to its defaults. This blows away
 mouse position,  cursor and other nifty things that may have been set.

 This function uses another means to determine if a
 mouse is present,  and does not reset the mouse or damage any mouse
 settings, thus you can use it with other mouse-oriented libraries
 without dire consequences.

 Source: S_MOUSE.ASM