-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME.txt
95 lines (71 loc) · 2.6 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
Overview
========
MLAtor is an environment for using the Microchip Libraries for Applications
(MLA, formerly MAL) with desktop operating systems. Normally MLA is used in
conjunction with Microchip microcontrollers. This port allows you to work on
your project without having to deal with hardware setup, e.g. when on journey.
Dependencies:
- Legacy MLA (http://www.microchip.com/MLA), v2013-06-15 has been used;
Current MLA (MLA >= v2013-12-20) does not work
- SDL 2.0 (http://libsdl.org/) for display output and user input
Optional dependencies:
- S-Record (http://srecord.sourceforge.net/) for demo projects using external
memory
Currently working:
- Graphics Library display output for GOL objects, primitives, bitmaps and
fonts, but not feature complete regarding the configuration, see below
- touch screen input simulated via mouse
Compiling the example or demo projects
======================================
$ cd example/ (or cd demoprojects/)
$ make MLA_INSTALL_PATH=custom_dir prepare
$ make MLA_INSTALL_PATH=custom_dir
Hints for using MLA with MLAtor
===============================
- set Compiler Type to C32/XC32 when generating resources with Graphics
Resource Converter in "Internal Flash" format, for "External Flash" or
"Binary" format there is no difference and C30/XC16 works as well
- external memory can be emulated by writing the content of the .hex or .bin
resource file into the array "const unsigned char externalMemoryData[]"
- external memory resources have to be generated with start address set to 0
- only 1 external memory device is allowed, the device ID is ignored
Features
========
Implemented:
- DISP_ORIENTATION 0, 90, 180, 270
- COLOR_DEPTH 1, 4, 8, 16, 24
- USE_PALETTE
- USE_TRANSPARENT_COLOR
- USE_ANTIALIASED_FONTS
- USE_ALPHABLEND_LITE
- Clipping
- USE_PALETTE_EXTERNAL
- USE_FONT_EXTERNAL
- USE_BITMAP_EXTERNAL
- USE_DOUBLE_BUFFERING
- USE_TRANSITION_EFFECTS
- USE_TOUCHSCREEN
Planned:
- USE_ALPHABLEND
- USE_KEYBOARD
- USE_MOUSE
Supported out of the box:
- USE_NONBLOCKING_CONFIG
- USE_FOCUS
- USE_MULTIBYTECHAR
- USE_BITMAP_FLASH
- USE_COMP_RLE
- USE_FONT_FLASH
- USE_FONT_RAM
- USE_GRADIENT
Extras
======
If MLATOR_EXTRAS is defined (default for the example and demo projects):
- press <F1> for a help dialog
- press <F2> to take a screenshot
It is directly saved to a file, the filename contains the timestamp and is
of the format <prefix>_yyyymmddThhmmss.bmp. Due to the time resolution, only
1 screenshot per second is possible. An existing file will not be
overwritten.
- scaling of display output supported by changing the compile switch
MLATOR_SCALE_FACTOR_DEFAULT