Project Home
Project Home
Documents
Documents
Wiki
Wiki
Discussion Forums
Discussions
Project Information
Project Info
Forum Topic - Uploading a splash screen to an iPod : (1 Item)
   
Uploading a splash screen to an iPod  
Splash screens

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 
like this:

# io-fs-media -dipod,transport=usb,acp=i2c,splash=path/greysplash.qnxlogo:path/colorsplash.qnxlogo:path/bigcolorsplash.
qnxlogo

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 
header” below.
   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.