nuttx-apps/graphics/traveler/tools/tcledit
2016-11-11 14:17:05 -06:00
..
.gitignore tcledit: Fix some more compile issues 2016-11-11 07:52:32 -06:00
colors.html Traveler: First dirty conversion of the TCL/X11 world editor 2016-11-09 11:14:35 -06:00
Imakefile tcledit: Fix some more compile issues 2016-11-11 07:52:32 -06:00
README.txt tcledit/libwld: Add support for building debug versions. 2016-11-11 10:05:12 -06:00
tcl_colors.h Traveler: First dirty conversion of the TCL/X11 world editor 2016-11-09 11:14:35 -06:00
tcl_edit.c tcledit: Fix some initialization issues 2016-11-11 14:17:05 -06:00
tcl_edit.tk tcledit: Fix some compile issues. Still undefined things at link time. 2016-11-10 14:04:05 -06:00
tcl_paint.c Fix some header comment block widths 2016-11-11 08:51:41 -06:00
tcl_x11graphics.c tcledit: Fix some initialization issues 2016-11-11 14:17:05 -06:00
tcl_x11graphics.h tcledit/libwld: Should not depend on configured trv_pixel_t or dev_pixel_t. Assume always uint8_t and uint32_t TrueColor. 2016-11-11 08:43:48 -06:00

Build instuctions
=================

  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).

    1. cd nuttx/tools
       ./configure.sh sim/traveler (for example)
    2. cd ..
       tools/sethost.sh -w or -l
       make context

  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).

    3. cd apps/graphics/traveler/tools/nuttx
    4. make TOPDIR=<nuttx directory>

  Build the world library:

    5. cd apps/graphics/traveler/tools/libwld
    6a. make

  If you want to create a debug-able version of the library, do:

    6b. make DEBUG_LEVEL=1

  Then you can use xmfmk to create the Makefile and build the tool:

    7. cd apps/graphics/traveler/tools/tcledit
    8. Review Imakefile.  You will probabaly to to change the APPDIR and TOPDIR paths
       a minimum.  These are the paths to where you have clones the apps/ repository
       and the nuttx/ repositories, respectively.
    9. xmfmk
   10a. make tcledit

  If you want to create a debug-able version of tcledit, do:

   10b. make tcledit DEBUG_LEVEL=1

Usage
=====

  .  /tcledit [-D <directory>] [-o <outfilename>] <infilename>

  Where <infilename> is the original world file name which will be overwritten
  unless <outfilename> is provided.  Optionally, switch to <directory> before
  opening <infilenamea>.

  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:

    ./tcledit -D ../../world transfrm.wld