AN1368
CONFIGURATION
The configuration of the Microchip Graphics Library is
done through two files:
? GraphicsConfig.h
? HardwareProfile.h
GraphicsConfig.h
The software library related configurations are done in
GraphicsConfig.h . The available options are:
4.
5.
6.
USE_FOCUS: If this option is defined, a dashed
outline (focus line) is displayed on the selected
widget. This focus line is especially useful for
navigation and selection of widgets if push
buttons are used as user input.
USE_TOUCHSCREEN: This option enables the
touch screen support for the application by
enabling the touch message processing part of
the GOL.
USE_KEYBOARD: This option enables the
physical keys support for the application by
1.
USE_NONBLOCKING_CONFIG: If this option is
defined, then the Non-Blocking mode of the API
enabling the hard key message processing part
of the GOL.
calls is used; that is, the APIs with return status
values can return without completing their task.
The task may complete some time after
returning. This is especially useful if 2D-
Acceleration is supported by the display driver.
In that case, the application can regain control
7.
USE_GOL: This option enables the Graphic Object
Layer (GOL). Initially, GOLInit() must be called.
GOLDraw() and GOLMsg() must be called
repeatedly in a loop and GOLDrawCallback()
and GOLMsgCallback() functions must be
implemented by the application.
2.
3.
while rendering is being processed in parallel.
This reduces Idle time for the microcontroller
waiting for the rendering of a primitive command
(such as line() , bar() ). If this define is
disabled (commented out), then all API calls
return only after the completion of their task. For
non-blocking configuration, the user must check
the return value of the API to know if its
execution got completed or not.
USE_DOUBLE_BUFFERING: If this option is
defined, two buffers will be used. One buffer will
be used as a draw buffer, where the next screen
is rendered, and the other as a frame buffer,
which holds the visible pixels of the screen. This
mode is used to avoid visible slow drawing on
the screen, like rendering of a large area or
decoding and displaying of an image. This mode
uses twice the amount of the frame buffer and
the library currently supports this feature only for
certain graphics controllers (refer to the
documentation of the Microchip Graphics
Library). If this option is commented out, then
only one buffer is used as the frame buffer and
the changes to the screen are visible at the
same time.
USE_PALETTE: If this option is defined, Palette
mode is enabled and the colors are taken from
the palette table. This option is available only to
controllers that have a built-in, programmable,
color look-up table (example: PIC24FJ256DA210
has a graphics module with a color look-up table).
The table is required to initialize the palette
engine and set a valid palette table before
displaying anything on the screen. The library
supports this feature only for PIC microcontrollers
with a built-in display controller. The
8.
9.
10.
11.
12.
13.
USE_BUTTON , USE_CHECKBOX , USE_WINDOW ,
… , USE_CUSTOM: These options are valid only
if USE_GOL is defined. They enable the support
of each widget in the application and each
enabled widget will use its share of RAM, ROM
and heap.
USE_MULTIBYTECHAR: This will make the
XCHAR, 2 bytes long so that Unicode (UTF16)
is supported. Languages other than English
characters can be supported by the usage of
Unicode. Enable this option if multiple language
support is needed in the application and disable
(comment out) this option if only ASCII is used.
If this option is disabled, XCHAR takes one byte
per character.
USE_FONT_FLASH: Supports fonts stored in
the internal Flash of the microcontroller to be
used in the application.
USE_FONT_RAM: Supports fonts stored in the
RAM of the microcontroller to be used in the
application. This is used as font accelerations in
PIC microcontrollers with a built-in display
controller.
USE_FONT_EXTERNAL: Supports fonts
stored in the external memory (serial or paral-
lel Flash) to be used in the application. The
application needs to implement a function,
WORD ExternalMemoryCallback(EXTDATA
*memory, LONG offset, WORD nCount,
void *buffer) , to get data from the external
memory.
COLOR_DEPTH: Specifies the color depth used
in the demo in bits-per-pixel and it can take
values, such as 1, 2, 4, 8, 16 or 24 (limited by the
hardware capabilities).
COLOR_DEPTH setting can be 1, 2, 4 or 8 with the
palettes enabled. If disabled, Normal Color mode
will be used.
DS01368A-page 26
? 2011 Microchip Technology Inc.
相关PDF资料
AC164130 BOARD DAUGHT PICTL PLUS ECAN/LIN
AC164131 BOARD DAUGHTER USB PICTAIL PLUS
AC164132 BOARD DAUGHTER PICTAIL ETHERNET
AC164141 BOARD SMART CARD / SIM CARD
AC164142 BOARD DAUGHTER PWR LINE MODEM
AC164144 LLC PICTAIL PLUS DAUGHTR BRD
AC164145 BOARD DAUGHTER PWR LINE MODEM
AC243005-1 KIT MEMORY SERIAL SUPERFLASH 1
相关代理商/技术参数
AC164128 功能描述:子卡和OEM板 dsPICDEM Motor Cntrl PICtail Plus RoHS:否 制造商:BeagleBoard by CircuitCo 产品:BeagleBone LCD4 Boards 用于:BeagleBone - BB-Bone - Open Source Development Kit
AC164129 功能描述:子卡和OEM板 Audio PICtail Plus Daughter Board RoHS:否 制造商:BeagleBoard by CircuitCo 产品:BeagleBone LCD4 Boards 用于:BeagleBone - BB-Bone - Open Source Development Kit
AC164130 功能描述:网络开发工具 ECAN/LIN PICtail Plus Daughter Board RoHS:否 制造商:Rabbit Semiconductor 产品:Development Kits 类型:Ethernet to Wi-Fi Bridges 工具用于评估:RCM6600W 数据速率:20 Mbps, 40 Mbps 接口类型:802.11 b/g, Ethernet 工作电源电压:3.3 V
AC164130-2 功能描述:子卡和OEM板 CAN/LIN PICtail Plus Daughter Board RoHS:否 制造商:BeagleBoard by CircuitCo 产品:BeagleBone LCD4 Boards 用于:BeagleBone - BB-Bone - Open Source Development Kit
AC164131 功能描述:子卡和OEM板 USB PICtail Plus Daughter Board RoHS:否 制造商:BeagleBoard by CircuitCo 产品:BeagleBone LCD4 Boards 用于:BeagleBone - BB-Bone - Open Source Development Kit
AC164132 功能描述:以太网开发工具 100Mbps Ethernet PICtail Plus DB RoHS:否 制造商:Micrel 产品:Evaluation Boards 类型:Ethernet Transceivers 工具用于评估:KSZ8873RLL 接口类型:RMII 工作电源电压:
AC164133 功能描述:电源管理IC开发工具 dsPIC BuckBoost PICtail Daughtr Brd RoHS:否 制造商:Maxim Integrated 产品:Evaluation Kits 类型:Battery Management 工具用于评估:MAX17710GB 输入电压: 输出电压:1.8 V
AC164133 制造商:Microchip Technology Inc 功能描述:Buck/Boost Converter PICtail P