SHOW Colour SHOW Framework

net.rim.device.api.system
Class PNGEncodedImage

java.lang.Object
  |
  +--net.rim.device.api.system.EncodedImage
        |
        +--net.rim.device.api.system.PNGEncodedImage

public final class PNGEncodedImage
extends EncodedImage

Represents an image encoded in the PNG format.

To create a PNGEncodedImage instance, use the EncodedImage.createEncodedImage(byte[],int,int) method. The createEncodedImage method accepts a java byte array containing the encoding of an image.

An image encoding can be obtained by either of the following methods:

First, when an image is added to a project in the IDE, the image resource becomes available to the developer.

Second, the image encoding can be obtained manually by converting the binary image file to a java byte array. This is accomplished using the following procedure:

  1. Using a binary file converter, such as xxd, convert the image to a C-style byte array.
  2. Open the target file and search for the string "0x".
  3. Replace the string with the following "(byte)0x".
  4. Adjust the array declaration at the top of the file to conform to Java standards.
  5. Remove the following string from the bottom of the file "unsigned int input_file_name_len = XXXX".

If done correctly, the file will contain a valid Java byte array containing the image encoding.

Since:
JDE 3.6.0
See Also:
JPEGEncodedImage

Fields inherited from class net.rim.device.api.system.EncodedImage
DECODE_ALPHA, DECODE_NATIVE, DECODE_NO_DITHER, DECODE_READONLY, IMAGE_TYPE_BMP, IMAGE_TYPE_JPEG, IMAGE_TYPE_PNG, IMAGE_TYPE_TIFF, IMAGE_TYPE_WBMP
 
Method Summary
   int getAlphaBitDepth()
          Queries the bit depth of the alpha channel.
   int getAlphaType(int frameIndex)
          Returns the alpha channel type.
   int getBitDepth()
          Queries the PNG bit depth.
   int getBitmapType(int frameIndex)
          Returns the bitmap type.
   int getColorType()
          Queries the PNG color type.
   boolean hasAlpha()
          Queries whether the PNG has an alpha channel.
 
Methods inherited from class net.rim.device.api.system.EncodedImage
createEncodedImage, createEncodedImage, getBitmap, getBitmap, getData, getDecodeMode, getFrameCount, getFrameHeight, getFrameMonochrome, getFrameTransparency, getFrameWidth, getHeight, getImageType, getLength, getOffset, getScale, getScaledFrameHeight, getScaledFrameWidth, getScaledHeight, getScaledWidth, getSupportedMIMETypes, getWidth, hasTransparency, isMonochrome, setDecodeMode, setScale
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getColorType

public int getColorType()
Queries the PNG color type.

Returns:
The PNG color type of the image.
Since:
JDE 3.6.0

getBitDepth

public int getBitDepth()
Queries the PNG bit depth.

Returns:
The PNG bit depth of the image.
Since:
JDE 3.6.0

hasAlpha

public boolean hasAlpha()
Queries whether the PNG has an alpha channel.

Returns:
True if the PNG has an alpha channel, false otherwise.
Since:
JDE 3.6.0

getAlphaBitDepth

public int getAlphaBitDepth()
Queries the bit depth of the alpha channel.

Returns:
The bit depth of the alpha channel, 0 if the image does not have an alpha channel.
Since:
JDE 3.6.0

getBitmapType

public int getBitmapType(int frameIndex)
Returns the bitmap type.

Overrides:
getBitmapType in class EncodedImage
Parameters:
frameIndex - The index of the frame.
Since:
JDE 4.0.2

getAlphaType

public int getAlphaType(int frameIndex)
Returns the alpha channel type.

Overrides:
getAlphaType in class EncodedImage
Parameters:
frameIndex - The index of the frame. This method calls the parent method.
Since:
JDE 4.0.2


Copyright 1999-2004 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.