http://www.wavecom.com/forum Open AT ®  Release version: 3.13

Sample - Draw Library

• Changes
• Dependencies
• Library Description
• Library API

• V2.10 : Initial revision
• V3.00 : New drw_DeleteAllSprites API

This sample depends on the following libraries :

• Drivers
  This Drivers sample ADL Library allows applications to use directly some specefic devices, plugged on SPI, I2C or Parallel bus.
   

This Draw sample ADL Library provides to ADL applications APIs to draw and move sprites on a graphical LCD.

The used SPI LCD in this sample is the Samsung KS 0719.

All constants and APIs are defined by the draw.h header file, which must be included by any application to allows it to use the Draw Library.

The library will need the global variable bellow on link operation, to define the trace level on which will be displayed the Draw traces :

extern u8 drw_TraceLevel;

Any application which links with the Draw Library must also use the Drivers Library. The application must subscribe to the KS0719 driver before creating the first sprite.

The Draw APIs are defined bellow :

u8  drw_CreateSprite ( ascii *  sSprite, u8  iXInit, u8  iYInit );  
 


Parameter	Description
sSprite	Sprite template.
iXInit	X init position.
iYInit	Y init position.

bool  drw_MoveSprite ( u8  iSpriteID, s8  XOffset, s8  YOffset );  
 


Parameter	Description
iSpriteID	The sprite to process.
XOffset	X Offset.
YOffset	Y Offset.

bool  drw_MoveSpriteTo ( u8  iSpriteID, u8  iXInit, u8  iYInit );  
 


Parameter	Description
iSpriteID	The sprite to process.
iXInit	X new position.
iYInit	Y new position.

void  drw_GetSpritePos ( u8  iSpriteID, u8 *  iCurrentX, u8 *  iCurrentY );  
 


Parameter	Description
iSpriteID	The sprite to process.
iCurrentX	X position.
iCurrentY	Y position.

void  drw_GetSpriteDim ( u8  iSpriteID, u8 *  iWidth, u8 *  iHeight );  
 


Parameter	Description
iSpriteID	The sprite to process.
iWidth	Sprite width.
iHeight	Sprite height.

void  drw_HideSprite ( u8  iSpriteID );  
 


Parameter	Description
iSpriteID	The sprite to process.

void  drw_RefreshSprite ( u8  iSpriteID );  
 


Parameter	Description
iSpriteID	The sprite to process.

void  drw_DeleteAllSprites ( void );  
 

Updated: Wed Apr 4 13:14:19 CEST 2007;