diff options
author | Gregory Nutt <gnutt@nuttx.org> | 2013-05-12 07:47:16 -0600 |
---|---|---|
committer | Gregory Nutt <gnutt@nuttx.org> | 2013-05-12 07:47:16 -0600 |
commit | 9cbcaf0b572ee505767e47fcc41cfe660c8e3ae3 (patch) | |
tree | 642610f7d0c272472c6c9305544fbc84f01a8145 /NxWidgets/tools | |
parent | 9170f5ac5117c9239e9fb9265a9d74725b089d16 (diff) | |
download | px4-nuttx-9cbcaf0b572ee505767e47fcc41cfe660c8e3ae3.tar.gz px4-nuttx-9cbcaf0b572ee505767e47fcc41cfe660c8e3ae3.tar.bz2 px4-nuttx-9cbcaf0b572ee505767e47fcc41cfe660c8e3ae3.zip |
Smalled CMediaPlayer image from Ken Pettit
Diffstat (limited to 'NxWidgets/tools')
-rwxr-xr-x | NxWidgets/tools/README.txt | 128 | ||||
-rwxr-xr-x | NxWidgets/tools/addobjs.sh | 4 |
2 files changed, 79 insertions, 53 deletions
diff --git a/NxWidgets/tools/README.txt b/NxWidgets/tools/README.txt index 22b2bf2a9..b38a7892f 100755 --- a/NxWidgets/tools/README.txt +++ b/NxWidgets/tools/README.txt @@ -1,51 +1,77 @@ -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 insted 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.
-
-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 traiing */ 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>
+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> diff --git a/NxWidgets/tools/addobjs.sh b/NxWidgets/tools/addobjs.sh index 5ccb289c5..b618efd34 100755 --- a/NxWidgets/tools/addobjs.sh +++ b/NxWidgets/tools/addobjs.sh @@ -66,7 +66,7 @@ while [ ! -z "$1" ]; do echo " <obj-dir> is full path to the directory containing the object files to be added" echo "OPTIONS include:" echo " -p Prefix to use. For example, to use arm-elf-ar, add '-p arm-elf-'" - echo " -w Use Windows style paths insted of POSIX paths" + echo " -w Use Windows style paths instead of POSIX paths" echo " -d Enable script debug" echo " -h Show this usage information" exit 0 @@ -138,4 +138,4 @@ for obj in `ls "${objdir}"/*.o`; do echo " Object: ${obj}"; \ exit 1; \ } -done
\ No newline at end of file +done |