2016-11-11 14:55:04 +01:00
|
|
|
Build instuctions
|
|
|
|
|
=================
|
2016-11-09 18:14:35 +01:00
|
|
|
|
2016-11-12 14:56:59 +01:00
|
|
|
tcledit is a world editor for the traveler. You should be able to build it
|
|
|
|
|
under Linux or Cygwin. It needs X11 and Tcl/Tk.
|
|
|
|
|
|
2016-11-09 18:37:17 +01:00
|
|
|
At the time of 'make', you must have a valid Traveler configuration instantiated
|
|
|
|
|
in the NuttX directory. This is because the build will depend on certain
|
|
|
|
|
configurations (such as color format).
|
|
|
|
|
|
2016-11-09 20:16:33 +01:00
|
|
|
1. cd nuttx/tools
|
|
|
|
|
./configure.sh sim/traveler (for example)
|
|
|
|
|
2. cd ..
|
|
|
|
|
tools/sethost.sh -w or -l
|
|
|
|
|
make context
|
2016-11-09 18:37:17 +01:00
|
|
|
|
2016-11-10 18:42:37 +01:00
|
|
|
Prepare some header files. This is necessary because we must use ALL of the
|
|
|
|
|
toolchain header files except for a few files from nuttx (for example,
|
|
|
|
|
config.h).
|
2016-11-09 21:12:21 +01:00
|
|
|
|
2016-11-10 18:42:37 +01:00
|
|
|
3. cd apps/graphics/traveler/tools/nuttx
|
2016-11-09 21:12:21 +01:00
|
|
|
4. make TOPDIR=<nuttx directory>
|
|
|
|
|
|
2016-11-10 18:42:37 +01:00
|
|
|
Build the world library:
|
|
|
|
|
|
|
|
|
|
5. cd apps/graphics/traveler/tools/libwld
|
2016-11-11 17:05:12 +01:00
|
|
|
6a. make
|
|
|
|
|
|
|
|
|
|
If you want to create a debug-able version of the library, do:
|
|
|
|
|
|
|
|
|
|
6b. make DEBUG_LEVEL=1
|
2016-11-10 18:42:37 +01:00
|
|
|
|
2016-11-09 18:37:17 +01:00
|
|
|
Then you can use xmfmk to create the Makefile and build the tool:
|
|
|
|
|
|
2016-11-10 18:42:37 +01:00
|
|
|
7. cd apps/graphics/traveler/tools/tcledit
|
|
|
|
|
8. Review Imakefile. You will probabaly to to change the APPDIR and TOPDIR paths
|
2016-11-09 20:16:33 +01:00
|
|
|
a minimum. These are the paths to where you have clones the apps/ repository
|
|
|
|
|
and the nuttx/ repositories, respectively.
|
2016-11-10 18:42:37 +01:00
|
|
|
9. xmfmk
|
2016-11-11 17:05:12 +01:00
|
|
|
10a. make tcledit
|
|
|
|
|
|
|
|
|
|
If you want to create a debug-able version of tcledit, do:
|
|
|
|
|
|
|
|
|
|
10b. make tcledit DEBUG_LEVEL=1
|
2016-11-09 20:16:33 +01:00
|
|
|
|
2016-11-12 14:56:59 +01:00
|
|
|
On Cygwin, the make target will be tcledit.exe, not tcledit.
|
|
|
|
|
|
2016-11-11 14:55:04 +01:00
|
|
|
Usage
|
|
|
|
|
=====
|
2016-11-09 18:37:17 +01:00
|
|
|
|
2016-11-11 17:05:12 +01:00
|
|
|
. /tcledit [-D <directory>] [-o <outfilename>] <infilename>
|
2016-11-09 18:14:35 +01:00
|
|
|
|
2016-11-11 15:11:36 +01:00
|
|
|
Where <infilename> is the original world file name which will be overwritten
|
2016-11-11 17:05:12 +01:00
|
|
|
unless <outfilename> is provided. Optionally, switch to <directory> before
|
|
|
|
|
opening <infilenamea>.
|
2016-11-11 15:11:36 +01:00
|
|
|
|
|
|
|
|
NOTE: The default traveler world file is apps/graphics/traverler/world/transfrm.wld.
|
|
|
|
|
The file contains relative paths so you may have to CD in to the directory first
|
|
|
|
|
like:
|
|
|
|
|
|
2016-11-11 17:05:12 +01:00
|
|
|
./tcledit -D ../../world transfrm.wld
|
2016-11-12 14:56:59 +01:00
|
|
|
|
|
|
|
|
On Cywgin, the correct name of the program will be tcledit.exe and must also
|
|
|
|
|
remember to start the X11 server before trying run the applications.
|
