source: rtems-graphics-toolkit/README @ 64130b9

Last change on this file since 64130b9 was 64130b9, checked in by Alexandru-Sever Horin <alex.sever.h@…>, on 08/20/12 at 13:21:12

Updated readmes and such

  • Property mode set to 100644
File size: 2.9 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.
19Also, to work with current version of Microwindows/nano-X,
20the framebuffer driver must be initialized in packed pixel mode
21
22The ./do_it script has the following parameters:
23
24    do_one [options]
25       -A - build and install all libraries
26       -j - build JPEG support (default=no)
27       -p - build PNG support (default=no)
28       -t - build TIFF support (default=no)
29       -1 - build Adobe Type 1 font support (default=no)
30       -T - build Truetype font support (default=no)
31       -n - build Microwindows/Nano-X support (default=no)
32       -x - build Microwindows/Nano-X NXLib support (default=no)
33       -f - build FLTK support (default=no)
34       -c - clean after building (default=no)
35       -s - use sudo for make install (default=no)
36       -v - verbose
37
38    NOTES:
39      + Use of each option toggles the setting.  For example, \"-v -v -A -1\"
40        results in verbose=no and all steps done except Type 1 fonts.
41      + RTEMS_MAKEFILE_PATH must be set
42      + By default, nothing is built.
43
44Below is an invocation for the pc386 BSP which should build all of the
45supported libraries and install them for the pc386 BSP which is installed
46into your ${HOME}.  RTEMS was configured with --prefix set to:
47${HOME}/rtems-4.10-work/bsp-install/
48
49RTEMS_MAKEFILE_PATH=${HOME}/rtems-4.10-work/bsp-install/i386-rtems4.10/pc386/ \
50    ./do_it -A -v
51
52The CFLAGS and target information are automatically gathered from the
53install Makefile information.  This is used to properly configure
54and install the desired graphics support libraries.
55This command also builds Microwin/Nano-X and NXLib which must be fetched from
56external repository.
57
58To be able tu build tests for FLTK package, users must not clean microwindows,
59as it uses for initializations the object files from the aformentioned package.
60
61After installing this, you can proceed to building Microwin/Nano-X.
62It is expected that this will be integrated into a future revision of the
63Graphics Toolkit.  We hope to add other libraries like SVGAlib in the future. 
64This is definitely an area in which users can contribute.
65
66--joel
67
68Usage Notes:
69
70Adobe Type 1 Library
71====================
72+ This needs .t1librc and an override on the location of t1 fonts.
73  Then we need to put some T1 fonts in the rootfs filesystem.
74  This works now by setting the environment variable.  See rtems_init.c
75  in the microwin source.
76
Note: See TracBrowser for help on using the repository browser.