Getting Started: Running the “Graphics Primitive Layer” demo
This demo and the accompanying application note serves as a useful guide in creating customized Widgets. The essential components of a Widget are enumerated and described in the application note as well as the process of integrating the new Widget into the Graphics Library.
The Primitive Layer demo exhibits how basic rendering functions can be utilized to draw shapes. The demo project is created to run on supported Microchip Demo Boards and development hardware.
Pre-generated hex files are available on the "Precompiled Hex" sub-directory found in the demo directory. These hex files are generated using the alternative hardware profiles found in the sub-directory named "Configs". Use the "Demo Compatibility Matrix" when running pre-generated hex files appropriate for your hardware.
Demo Procedure:
Connect the necessary hardware and program with the correct pre-generated hex. Demo will loop through different screens showing composite shapes and bitmaps.
1) Show the edge of the screen in four different colors. This test can be very useful to verify if the synchronization signals of the display is lined up properly.
2) Diagonal lines and concentric circles and filled concentric circles.
3) Beveled shapes and rings.
4) Rectangles and bars.
5) Polygon.
6) Use of small fonts.
7) Use of larger fonts.
8) Displaying different font types
a. Non anti-aliased font
b. Anti-aliased (opaque)
c. Anti-aliased (translucent)
9) Displaying 1bpp format images.
10) Displaying 4bpp format images.
11) Displaying 8bpp format images.
12) Displaying 16bpp format images.
13) Displaying RLE compressed images
a. 8 BPP images
b. 4 BPP images
The “Resources” folder also contains the xml project used to generate the images stored in the internal flash memory. Open the file in "Graphics Resource Converter" utility to see which files are loaded from internal flash memory.
· InternalResourcePrimitiveLayer.xml
To run the demo in the supported Development Board combination, set the proper hardware profile in the project HardwareProfile.h file:
· To run the demo on selected Development Boards using QVGA display use:
#include "Configs/HWP_XXX_QVGAv1.h”
· To run the demo on selected Development Boards using WQVGA display use:
#include "Configs/HWP_XXX_WQVGAv1.h”
· To run the demo on selected Development Boards using VGA display use:
#include "Configs/HWP_XXX_VGAv1.h”
· To run the demo on Multimedia Expansion Board use:
#include "Configs/HWP_MEB_XXX.h”
Where: XXX represents any of the selected Development Boards.
The hardware profile file name refers to the combination of Development Boards that are used to run the demo. Refer to the abbreviations summary (link) for details.
The table below shows the hardware set up for the selected Development Boards attached to different Display Boards:
Required Hardware/Configuring the Hardware
|
Selected Development Boards |
Graphics PICtail Board |
3.2″ QVGA Truly TFT Display Board (AC164127-4) |
4.3″ WQVGA Powertip TFT Display Board (AC164127-6) |
5.7″ VGA Truly TFT Display Board (AC164127-8) |
|
PIC24FJ256DA210 Development Board (DM240312) |
none |
✓ (see note 1) |
✓ (see note 1) |
☒ (see note 4) |
|
Multimedia Expansion Board (DM320005) + PIC32 USB Starter Kit II (DM320003-2) OR PIC32 Ethernet Starter Kit (DM320004) OR PIC32 Starter Kit (DM320001) |
☑ (see note 2) |
✗ |
✗ |
|
|
Explorer 16 (DM240001) + PIC24FJ128GA010 Plug-In-Module (PIM) (MA240011) OR PIC24FJ256GA110 Plug-In-Module (PIM) (MA240015) OR PIC24FJ256GB110 Plug-In-Module (PIM) (MA240014) OR PIC24FJ256GB210 Plug-In-Module (PIM) (MA240021) OR PIC24HJ128GP504 Graphics Plug-In-Module (PIM) (MA240016-2) OR dsPIC33FJ128GP804 Graphics Plug-In-Module (PIM) (MA330019-2) OR PIC32MX 100P QFP TO 100P Plug-In-Module (PIM) (MA320001) OR PIC32MX USB Plug-In-Module (PIM) (MA320002) OR PIC32MX CAN-USB Plug-In-Module (PIM) (MA320003) |
Graphics LCD Controller PICtail™ Plus SSD1926 Board (AC164127-5) (see note 3) |
✓ |
✓ |
✗ |
|
Explorer 16 (DM240001) + PIC24EP512GU810 Plug-In-Module (PIM) (MA240025-1) OR dsPIC33EP512MU810 Plug-In-Module(PIM) (MA330024-1) |
☒ |
☒ |
✗ |
|
|
PIC32 USB Starter Kit II (DM320003-2) OR PIC32 Ethernet Starter Kit (DM320004) OR PIC32 Starter Kit (DM320001) |
✓ |
✓ |
✗ |
|
|
Note: 1. When using PIC24FJ256DA210 Development Board set the jumpers to: - JP8 – don’t care (color depth is 16BPP, byte access is not performed) - JP9, JP10, JP11, JP12, JP13, JP14, JP15, JP23 – don’t care 2. The Multimedia Expansion Board and the 3.2″ QVGA Truly TFT Display Board (AC164127-4) uses the same TFT display. 3. When using Graphics LCD Controller PICtail™ Plus SSD1926 Board set the jumpers to: - JP1 – open - JP2 – depending on the PMP interface setting - set to 1-2 (for 8-bit PMP) - set to 2-3 (for 16-bit PMP) - JP3 – set to 1-2 (use RD1) 4. To run this demo on the 5.7″ VGA Truly TFT Display Board (AC164127-8) with the PIC24FJ256DA210 Development Board at 16 bpp color depth, the refresh rate of the display must be set to 32 Hz instead of 60 Hz. 5. The demo is not limited to the selected display boards used here. Other display boards can be used with the appropriate hardware profiles.
|
||||
|
Legend: |
|||
|
✓ |
Supported out of the box |
☒ |
Hardware compatible, will need firmware modification |
|
☑ |
Supported, see limitations |
✗ |
Not supported, hardware not compatible |
Trademarks:
The Microchip name and logo, the Microchip logo, MPLAB, and PIC are registered trademarks of Microchip Technology Incorporated in the U.S.A. and other countries.
PICDEM and PICTail are trademarks of Microchip Technology Incorporated in the U.S.A. and other countries.
SD is a trademark of the SD Association in the U.S.A and other countries
Microsoft, Windows, Excel, and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.