net.rim.device.api.barcodelib
Class PlanarYUVLuminanceSource

java.lang.Object
  com.google.zxing.LuminanceSource
      net.rim.device.api.barcodelib.PlanarYUVLuminanceSource

public final class PlanarYUVLuminanceSource
extends LuminanceSource

Implementation of LuminanceSource with support for planarized YUV data (where the Y channel comes first).

Since:

BlackBerry API 7.0.0

Constructor Summary

PlanarYUVLuminanceSource(byte[] yuv, int dataWidth, int dataHeight)
Creates a LuminanceSource for planar yuv data.

PlanarYUVLuminanceSource(byte[] yuv, int dataWidth, int dataHeight, int left, int top, int width, int height)
Creates a LuminanceSource for planar yuv data that supports cropping a section of the data.

Method Summary
byte[]	getMatrix() Fetches luminance data for the underlying bitmap.
byte[]	getRow(int y, byte[] row) Fetches one row of luminance data from the underlying platform's bitmap.

Methods inherited from class com.google.zxing.LuminanceSource

crop, getHeight, getWidth, isCropSupported, isRotateSupported, rotateCounterClockwise

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PlanarYUVLuminanceSource

public PlanarYUVLuminanceSource(byte[] yuv,
                                int dataWidth,
                                int dataHeight)

Creates a LuminanceSource for planar yuv data.

Parameters:

yuv - The planar yuv image data (where the Y channel comes first).

dataWidth - The width of the image.

dataHeight - The height of the image.

Throws:

NullPointerException - if yuv is null.

Since:

BlackBerry API 7.0.0

PlanarYUVLuminanceSource

public PlanarYUVLuminanceSource(byte[] yuv,
                                int dataWidth,
                                int dataHeight,
                                int left,
                                int top,
                                int width,
                                int height)

Creates a LuminanceSource for planar yuv data that supports cropping a section of the data.

Parameters:

yuv - The planar yuv image data where the Y channel comes first.

dataWidth - The width of the image.

dataHeight - The height of the image.

left - The left edge of rectangle to copy from.

top - The top edge of the rectangle to copy from.

width - The width of the rectangle to copy from.

height - The height of the rectangle to copy from.

Throws:

NullPointerException - if yuv is null.

IllegalArgumentException - if yuv length is 0.

IllegalArgumentException - if dataWidth, dataHeight, left, top, width, height is less than 0.

IllegalArgumentException - if left + width > dataWidth || top + height > dataHeight

Since:

BlackBerry API 7.0.0

Method Detail

getRow

public byte[] getRow(int y,
                     byte[] row)

Description copied from class: LuminanceSource

Fetches one row of luminance data from the underlying platform's bitmap. Values range from 0 (black) to 255 (white). Because Java does not have an unsigned byte type, callers will have to bitwise and with 0xff for each value. It is preferable for implementations of this method to only fetch this row rather than the whole image, since no 2D Readers may be installed and getMatrix() may never be called.

Specified by:

getRow in class LuminanceSource

Parameters:

y - The row to fetch, 0 <= y < getHeight().

row - An optional preallocated array. If null or too small, it will be ignored. Always use the returned object, and ignore the .length of the array.

Returns:

An array containing the luminance data.

Throws:

IllegalArgumentException - if y < 0 || y >= getHeight()

See Also:

LuminanceSource

Since:

BlackBerry API 7.0.0

getMatrix

public byte[] getMatrix()

Description copied from class: LuminanceSource

Fetches luminance data for the underlying bitmap. Values should be fetched using: int luminance = array[y * width + x] & 0xff;

Specified by:

getMatrix in class LuminanceSource

Returns:

A row-major 2D array of luminance values. Do not use result.length as it may be larger than width * height bytes on some platforms. Do not modify the contents of the result.

See Also:

LuminanceSource

Since:

BlackBerry API 7.0.0