NXC  Version 1.2.1 r5
 All Data Structures Files Functions Variables Groups Pages
Modules | Macros
Drawing option constants
Display module constants

Constants that are for specifying drawing options in several display module API functions. More...

Modules

 Font drawing option constants
 These addition drawing option constants are only for use when drawing text and numbers on the LCD using an RIC-based font.
 

Macros

#define DRAW_OPT_NORMAL   (0x0000)
 
#define DRAW_OPT_CLEAR_WHOLE_SCREEN   (0x0001)
 
#define DRAW_OPT_CLEAR_EXCEPT_STATUS_SCREEN   (0x0002)
 
#define DRAW_OPT_CLEAR_PIXELS   (0x0004)
 
#define DRAW_OPT_CLEAR   (0x0004)
 
#define DRAW_OPT_INVERT   (0x0004)
 
#define DRAW_OPT_LOGICAL_COPY   (0x0000)
 
#define DRAW_OPT_LOGICAL_AND   (0x0008)
 
#define DRAW_OPT_LOGICAL_OR   (0x0010)
 
#define DRAW_OPT_LOGICAL_XOR   (0x0018)
 
#define DRAW_OPT_FILL_SHAPE   (0x0020)
 
#define DRAW_OPT_CLEAR_SCREEN_MODES   (0x0003)
 
#define DRAW_OPT_LOGICAL_OPERATIONS   (0x0018)
 
#define DRAW_OPT_POLYGON_POLYLINE   (0x0400)
 
#define DRAW_OPT_CLEAR_LINE   (0x0800)
 
#define DRAW_OPT_CLEAR_EOL   (0x1000)
 

Detailed Description

Constants that are for specifying drawing options in several display module API functions.

Bits 0 & 1 (values 0,1,2,3) control screen clearing behaviour (Not within RIC files). Bit 2 (value 4) controls the NOT operation, i.e. draw in white or invert text/graphics. Bits 3 & 4 (values 0,8,16,24) control pixel logical combinations (COPY/AND/OR/XOR). Bit 5 (value 32) controls shape filling, or overrides text/graphic bitmaps with set pixels. These may be ORed together for the full instruction (e.g., DRAW_OPT_NORMAL|DRAW_OPT_LOGICAL_XOR) These operations are resolved into the separate, common parameters defined in 'c_display.iom' before any drawing function is called. Note that when drawing a RIC file, the initial 'DrawingOptions' parameter supplied in the drawing instruction controls screen clearing, but nothing else. The 'CopyOptions' parameter from each instruction in the RIC file then controls graphic operations, but the screen-clearing bits are ignored.

See Also
TextOut(), NumOut(), PointOut(), LineOut(), CircleOut(), RectOut(), PolyOut(), EllipseOut(), FontTextOut(), FontNumOut(), GraphicOut(), GraphicArrayOut()
Warning
These options require the enhanced NBC/NXC firmware