2013-05-12 15:47:16 +02:00
|
|
|
NxWidgets/tools README File
|
|
|
|
|
===========================
|
|
|
|
|
|
|
|
|
|
addobjs.sh
|
|
|
|
|
----------
|
|
|
|
|
|
|
|
|
|
$0 will add all object (.o) files in directory to an archive.
|
|
|
|
|
|
|
|
|
|
Usage: tools/addobjs.sh [OPTIONS] <lib-path> <obj-dir>
|
|
|
|
|
|
|
|
|
|
Where:
|
|
|
|
|
<lib-path> is the full, absolute path to the library to use
|
|
|
|
|
<obj-dir> is full path to the directory containing the object files to be added
|
|
|
|
|
OPTIONS include:
|
|
|
|
|
-p Prefix to use. For example, to use arm-elf-ar, add '-p arm-elf-'
|
|
|
|
|
-w Use Windows style paths instead of POSIX paths
|
|
|
|
|
-d Enable script debug
|
|
|
|
|
-h Show this usage information
|
|
|
|
|
|
|
|
|
|
bitmap_converter.py
|
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
|
|
This script converts from any image type supported by Python imaging library to
|
|
|
|
|
the RLE-encoded format used by NxWidgets.
|
|
|
|
|
|
|
|
|
|
RLE (Run Length Length) is a very simply encoding that compress quite well
|
|
|
|
|
with certain kinds of images: Images that that have many pixels of the
|
|
|
|
|
same color adjacent on a row (like simple graphics). It does not work well
|
|
|
|
|
with photographic images.
|
|
|
|
|
|
|
|
|
|
But even simple graphics may not encode compactly if, for example, they have
|
|
|
|
|
been resized. Resizing an image can create hundreds of unique colors that
|
|
|
|
|
may differ by only a bit or two in the RGB representation. This "color
|
|
|
|
|
smear" is the result of pixel interpolation (and might be eliminated if
|
|
|
|
|
your graphics software supports resizing via pixel replication instead of
|
|
|
|
|
interpolation).
|
|
|
|
|
|
|
|
|
|
When a simple graphics image does not encode well, the symptom is that
|
|
|
|
|
the resulting RLE data structures are quite large. The pallette structure,
|
|
|
|
|
in particular, may have hundreds of colors in it. There is a way to fix
|
|
|
|
|
the graphic image in this case. Here is what I do (in fact, I do this
|
|
|
|
|
on all images prior to conversion just to be certain):
|
|
|
|
|
|
|
|
|
|
- Open the original image in GIMP.
|
|
|
|
|
- Select the option to select the number of colors in the image.
|
|
|
|
|
- Pick the smallest number of colors that will represent the image
|
|
|
|
|
faithfully. For most simple graphic images this might be as few as 6
|
|
|
|
|
or 8 colors.
|
|
|
|
|
- Save the image as PNG or other lossless format (NOT jpeg).
|
|
|
|
|
- Then generate the image.
|
|
|
|
|
|
|
|
|
|
indent.sh
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
This script uses the Linux 'indent' utility to re-format C source files
|
|
|
|
|
to match the coding style that I use. It differs from my coding style in that
|
|
|
|
|
|
|
|
|
|
- I normally put the trailing */ of a multi-line comment on a separate line,
|
|
|
|
|
- I usually align things vertically (like '='in assignments.
|
|
|
|
|
|
|
|
|
|
install.sh
|
|
|
|
|
----------
|
|
|
|
|
|
|
|
|
|
Install a unit test in the NuttX source tree"
|
|
|
|
|
|
|
|
|
|
USAGE: tools/install.sh <apps-directory-path> <test-sub-directory>
|
|
|
|
|
|
|
|
|
|
Where:
|
|
|
|
|
<apps-directory-path> is the full, absolute path to the NuttX apps/ directory
|
|
|
|
|
<test-sub-directory> is the name of a sub-directory in the UnitTests directory
|
|
|
|
|
|
|
|
|
|
zipme.sh
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
Pack up the NxWidgets tarball for release.
|
|
|
|
|
|
|
|
|
|
USAGE: tools/zipme.sh <version>
|
