Smalled CMediaPlayer image from Ken Pettit

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