ROPBlock Function

Microchip Graphics Library

Microchip Graphics Library
ROPBlock Function
C
WORD ROPBlock(
    DWORD srcAddr, 
    DWORD dstAddr, 
    DWORD srcOffset, 
    DWORD dstOffset, 
    WORD srcType, 
    WORD dstType, 
    WORD copyOp, 
    WORD rop, 
    WORD color, 
    WORD width, 
    WORD height
);
Overview

Performs a Raster Operation (ROP) on source and destination. The type of ROP is decided by the rop and the copyOp parameter.

Input Parameters
Input Parameters 
Description 
DWORD srcAddr 
the base address of the data to be moved 
DWORD dstAddr 
the base address of the new location of the moved data 
DWORD srcOffset 
offset of the data to be moved with respect to the source base address. 
DWORD dstOffset 
offset of the new location of the moved data respect to the source base address. 
WORD srcType 
sets the source type (GFX_DATA_CONTINUOUS or GFX_DATA_DISCONTINUOUS) 
WORD dstType 
sets the destination type (GFX_DATA_CONTINUOUS or GFX_DATA_DISCONTINUOUS) 
WORD copyOp 
sets the type of copy operation  
WORD rop 
sets the raster operation equation  
WORD color 
color value used when transparency operation is set or using solid color fill 
WORD width 
width of the block of data to be moved 
WORD height 
height of the block of data to be moved 
Returns

For NON-Blocking configuration:

  • Returns 0 when device is busy and operation is not completely performed.
  • Returns 1 when the operation is completely performed.
For Blocking configuration:
  • Always return 1.

Preconditions

none

Side Effects

none

Microchip Graphics Library Version 3.06.02 - October 15, 2012
Copyright © 2012 Microchip Technology, Inc.  All rights reserved