Intermec ck1 Reference Guide

Page of 390
Chapter 5 — Nano-X APIs 
280 
CK1 SDK Programmer’s Reference Manual 
GrEmptyRegion () 
 
Purpose:  Determine if the specified region is empty. 
 
Syntax: 
GR_BOOL     GrEmptyRegion          (GR_REGION_ID region);
 
 
Parameter:  region  Identification of the region to examine  
 
Return:  GR_TRUE  If the region is empty 
GR_FALSE  If the region contains something  
GrEqualRegion () 
 
Purpose:  Determine whether the specified regions are identical. 
 
Syntax: 
GR_BOOL     GrEqualRegion             (GR_REGION_ID rgn1,
 
                                      GR_REGION_ID rgn2); 
 
Parameters:  rgn1  Identification of the first region to examine  
rgn2  Identification of the second region to examine  
 
Return:  GR_TRUE  If the regions are equal 
GR_FALSE   If the regions are different  
GrOffsetRegion () 
 
Purpose:  Offset the specified region by the specified distance. 
 
Syntax: 
void        GrOffsetRegion          (GR_REGION_ID region,
 
                                             GR_SIZE dx
                                             GR_SIZE dy); 
 
Parameters:  region 
Identification of the region to offset  
dx 
Distance to offset the region by in the X axis  
dy 
Distance to offset the region by in the Y axis  
GrGetRegionBox () 
 
Purpose:  Fill in the specified rectangle structure with a bounding box that would 
completely enclose the specified region, and also returns the type of the 
specified region. 
 
Syntax: 
int         GrGetRegionBox          (GR_REGION_ID region,
 
                                          GR_RECT *rect); 
 
Parameters:  region  Identification of the region to get the bounding box of  
rect 
Pointer to a rectangle structure  
 
Return:  The region type