Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Restrictions in BMP to RLE Conversion

 


The dimensions of the image should be within that supported by the device. Otherwise there is no restriction on the BMP; any BMP can be converted to RLE, but possibly with some loss according to the limits of the RLE format and the device. Two things to keep in mind when creating a BMP for overlay are transparency and number of unique colors.

...

The number of unique colors supported in an RLE image is very limited, for example 16 on AP0100. Most drawing applications will blend the edges of objects creating many more unique colors than that. Makeover will average similar colors to reduce the number of unique colors to the allowed limit, but this slightly shifts prominent colors, and is somewhat unpredictable around edges of objects. To avoid that ensure that the number of unique colors in the original image is within the limits of the RLE. Note that a pixel's transparency counts as part of the color of the pixel. For example red with 75% transparency and red with 50% transparency are considered two different colors by the RLE format.

Command line parameters

-inbmp <filename>
Specify the filename of an image file to load. Supported file formats include BMP, PNG, JPEG and TIFF. If the image contains too many unique colors, it will be quantized down to eight colors.

-transparency <rule>
Specify the transparency rule to apply when reading the file given by -inbmp. The transparency rule defines how to generate the image transparency (alpha plane).
The rules are:

  • fromfile; Use the transparency information from the input file unaltered. If the input file had no transparency data then the whole image will be opaque. This is the default.
  • none; The output image will be completely opaque. If the input file had any transparency information it will be ignored.
  • brightest; Make the brightest color (after quantization) transparent, all other colors opaque. If the input file had any transparency information it will be ignored.
  • white; Make any pixels that were exactly white in the original input image transparent, all others opaque. If the input file had any transparency information it will be ignored.
  • first; Make upper left corner pixel transparent as well as any other pixels of the same color, all others opaque. If the input file had any transparency information it will be ignored.

Command Line Parameters are;

 Note that a checksum is not generated by the makeover tool; the user will need to generate a checksum required by the target product.

Command line parameters

-inbmp <filename>
Specify the filename of an image file to load. Supported file formats include BMP, PNG, JPEG and TIFF. If the image contains too many unique colors, it will be quantized down to eight colors.

...

-rev <n>
Specify the revision of the RLE overlay bitmap file format directly.
AP0100 series uses rev 3.
AP0102/AP0200 series uses rev 4.
AP0300 uses rev 5.
Only MT9V126 REV1 uses rev 1.
All others use rev 2.
By default the revision is set to 2.
When -inrle is used, the revision is determined automatically from the  file itself.

...

-noshapes
Do not use shape instructions when encoding RLE.

-faderenable <n>
Specify the fader enable mode, use 1 to enable, 0 to disable.

-faderstartline <n>
Specify line number for the starting point of the fader.

-fadersatrt <n>
Specify start alpha value of the fader.

-fadermax <n>
Specify the max alpha value of the fader.

-faderstep <n>
Specify the step value of the fader.

-parampool <address>
Specify the register address of the sensor command parameter pool. Defaults to 0x0990. If you set this to 0 then the tool will address the command pool by symbol name rather than by numerical address.
(Normally you don't need to use this  parameter.)

...