source: rtems-graphics-toolkit/README @ 532c019

Last change on this file since 532c019 was 2102179, checked in by Joel Sherrill <joel.sherrill@…>, on 01/08/10 at 19:48:52

2010-01-08 Joel Sherrill <joel.sherrill@…>

  • README, TODO, do_it: Serious update.
  • Property mode set to 100644
File size: 2.3 KB
Line 
1#
2# $Id$
3#
4
5This is the RTEMS Graphics Toolkit. It is a collection of free software
6packages that are suitable for use in building graphical interfaces for
7RTEMS-based embedded systems.
8
9You should have RTEMS installed and configured for your BSP.  The
10RTEMS 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
16Additionally, your BSP should have a framebuffer and pointing device
17(e.g. mouse, touch screen, etc).  This is an area where RTEMS and
18this kit needs improvement on configuration but the basics are in place.
19
20The ./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
38Below is an invocation for the pc386 BSP which should build all of the
39supported libraries and install them for the pc386 BSP which is installed
40into your ${HOME}.  RTEMS was configured with --prefix set to:
41${HOME}/rtems-4.10-work/bsp-install/
42
43RTEMS_MAKEFILE_PATH=${HOME}/rtems-4.10-work/bsp-install/i386-rtems4.10/pc386/ \
44    ./do_it -A -v
45
46The CFLAGS and target information are automatically gathered from the
47install Makefile information.  This is used to properly configure
48and install the desired graphics support libraries.
49
50After installing this, you can proceed to building Microwin/Nano-X.  It
51is expected that this will be integrated into a future revision of the
52Graphics Toolkit.  We hope to add other libraries like SVGAlib and
53FLTK in the future.  This is definitely an area in which users can
54contribute.
55
56--joel
57
58Usage Notes:
59
60Adobe 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
Note: See TracBrowser for help on using the repository browser.