1 | # |
---|
2 | # $Id$ |
---|
3 | # |
---|
4 | |
---|
5 | This is the RTEMS Graphics Toolkit. It is a collection of free software |
---|
6 | packages that are suitable for use in building graphical interfaces for |
---|
7 | RTEMS-based embedded systems. |
---|
8 | |
---|
9 | You should have RTEMS installed and configured for your BSP. The |
---|
10 | RTEMS configuration should meet the following requirements: |
---|
11 | |
---|
12 | + TCP/IP enabled |
---|
13 | - not required at run-time but has endian swapping routines |
---|
14 | + POSIX enabled |
---|
15 | |
---|
16 | Additionally, your BSP should have a framebuffer and pointing device |
---|
17 | (e.g. mouse, touch screen, etc). This is an area where RTEMS and |
---|
18 | this kit needs improvement on configuration but the basics are in place. |
---|
19 | |
---|
20 | The ./do_it script has the following parameters: |
---|
21 | |
---|
22 | do_one [options] |
---|
23 | -A - build and install all libraries |
---|
24 | -j - build JPEG support (default=no) |
---|
25 | -p - build PNG support (default=no) |
---|
26 | -t - build TIFF support (default=no) |
---|
27 | -1 - build Adobe Type 1 font support (default=no) |
---|
28 | -T - build Truetype font support (default=no) |
---|
29 | -c - clean after building (default=no) |
---|
30 | -v - verbose |
---|
31 | |
---|
32 | NOTES: |
---|
33 | + Use of each option toggles the setting. For example, \"-v -v -A -1\" |
---|
34 | results in verbose=no and all steps done except Type 1 fonts. |
---|
35 | + RTEMS_MAKEFILE_PATH must be set |
---|
36 | + By default, nothing is built. |
---|
37 | |
---|
38 | Below is an invocation for the pc386 BSP which should build all of the |
---|
39 | supported libraries and install them for the pc386 BSP which is installed |
---|
40 | into your ${HOME}. RTEMS was configured with --prefix set to: |
---|
41 | ${HOME}/rtems-4.10-work/bsp-install/ |
---|
42 | |
---|
43 | RTEMS_MAKEFILE_PATH=${HOME}/rtems-4.10-work/bsp-install/i386-rtems4.10/pc386/ \ |
---|
44 | ./do_it -A -v |
---|
45 | |
---|
46 | The CFLAGS and target information are automatically gathered from the |
---|
47 | install Makefile information. This is used to properly configure |
---|
48 | and install the desired graphics support libraries. |
---|
49 | |
---|
50 | After installing this, you can proceed to building Microwin/Nano-X. It |
---|
51 | is expected that this will be integrated into a future revision of the |
---|
52 | Graphics Toolkit. We hope to add other libraries like SVGAlib and |
---|
53 | FLTK in the future. This is definitely an area in which users can |
---|
54 | contribute. |
---|
55 | |
---|
56 | --joel |
---|
57 | |
---|
58 | Usage Notes: |
---|
59 | |
---|
60 | Adobe Type 1 Library |
---|
61 | ==================== |
---|
62 | + This needs .t1librc and an override on the location of t1 fonts. |
---|
63 | Then we need to put some T1 fonts in the rootfs filesystem. |
---|
64 | This works now by setting the environment variable. See rtems_init.c |
---|
65 | in the microwin source. |
---|
66 | |
---|