01/29/2009 12:12 PM
Uploading a splash screen to an iPod
You can use the iofs-ipod.so splash option to specify one or more of the following for the iPod splash screen, using
colons to separate the different image paths, in this order:
* a greyscale image (for older greyscale iPod devices)
* a color image
* a big color image
The order of the image paths is fixed; that is, the first path is always the path to the greyscale image file, the
second path is always the path to the small color image file, and the third path is always the path to the big color
image file. Thus, for example, to load all three image files, you would start the iPod driver with the splash option
# io-fs-media -dipod,transport=usb,acp=i2c,splash=path/greysplash.qnxlogo:path/colorsplash.qnxlogo:path/bigcolorsplash.
However, to load only a large image file, you would start the iPod driver with the splash option like this, leaving the
unused image paths empty:
# io-fs-media -dipod,transport=usb,acp=i2c,splash=::path/bigcolorsplash.qnxlogo
Finally, if you do not want a big color image, simply omit the path; you do not need to add a colon to the end of your
list. For example, to load only a small color image:
# io-fs-media -dipod,transport=usb,acp=i2c,splash=:path/colorsplash.qnxlogo
To upload a splash screen to an iPod:
1. Save the image you will use for the splash screen in the required format:
* color - RGB-565 LE
* greyscale - monochrome 2 bits per pixel
2. Add to the beginning of the image file, an 8-byte header with the information described in “Splash image file
3. Start the iPod driver with the splash specifying the path(s) to the splash screen image file(s).
Splash image file header
iPods expect splash image files to have an 8-byte header, as described in table below.
Bytes Format Description
0-1 16 bits, little endian Width of the image, in bits.
2-3 16 bits, little endian Height of the image, in bits.
4-7 32 bits, little endian Stride of the image, in bytes
Note: The stride of an image is the number of bytes used for each row in the image's file. For example, if an image is
15 bits wide, then its stride will probably (but not necessarily) be two bytes; that is 15 bits of image information,
plus 1 bit of padding to byte-align the information.
For more information about iPod splash screen image formats, please refer to the Apple specifications.