Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileBMOVE source,destination,length

source, destination, length: iexp

BMOVE copies a block of memory from one area to another. 'source' is the
address of the first byte of the block to be copied, 'destination' is the
address of the first byte of the area to which the block is to be copied, and
'length' is the length of the block.

The instruction works noticeably faster with even parameters than with odd.  It
also works if the source and destination areas overlap.

Example:

    DIM screen2%(64000/4)
    adr%=VARPTR(screen2%(0))
    FOR i%=0 TO 300 STEP 100
      PBOX 0,i%,639,i%+50
    NEXT i%
    PRINT "hi there!"
    ' XBIOS(2) = the start-of-screen address
    BMOVE XBIOS(2),adr%,32000
    BMOVE XBIOS(2),adr%+32000,32000
    REPEAT
      IF MOUSEY<>my%
        BMOVE adr%+my%*80,XBIOS(2),32000
        my%=MOUSEY
      ENDIF
    UNTIL MOUSEK=2

--> Vertical movement of the mouse scroll the screen up and down.