com.google.zxing.common
Class GlobalHistogramBinarizer

java.lang.Object
  extended by com.google.zxing.Binarizer
      extended by com.google.zxing.common.GlobalHistogramBinarizer

public final class GlobalHistogramBinarizer
extends Binarizer

This Binarizer implementation uses the old ZXing global histogram approach. It is suitable for low-end mobile devices which don't have enough CPU or memory to use a local thresholding algorithm. However, because it picks a global black point, it cannot handle difficult shadows and gradients.

Since:
BlackBerry API 6.0.0

Constructor Summary
GlobalHistogramBinarizer(LuminanceSource source)
           
 
Method Summary
 Binarizer createBinarizer(LuminanceSource source)
          Creates a new object with the same type as this Binarizer implementation, but with pristine state.
 BitMatrix getBlackMatrix()
          Converts a 2D array of luminance data to 1 bit data.
 BitArray getBlackRow(int y, BitArray row)
          Converts one row of luminance data to 1 bit data.
 
Methods inherited from class com.google.zxing.Binarizer
getLuminanceSource
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 



Constructor Detail

GlobalHistogramBinarizer

public GlobalHistogramBinarizer(LuminanceSource source)
Since:
BlackBerry API 6.0.0


Method Detail

getBlackRow

public BitArray getBlackRow(int y,
                            BitArray row)
                     throws ReaderException
Description copied from class: Binarizer
Converts one row of luminance data to 1 bit data. May actually do the conversion, or return cached data. Callers should assume this method is expensive and call it as seldom as possible. This method is intended for decoding 1D barcodes and may choose to apply sharpening. For callers which only examine one row of pixels at a time, the same BitArray should be reused and passed in with each call for performance. However it is legal to keep more than one row at a time if needed.

Specified by:
getBlackRow in class Binarizer
Parameters:
y - The row to fetch, 0 <= y < bitmap height.
row - An optional preallocated array. If null or too small, it will be ignored. If used, the Binarizer will call BitArray.clear(). Always use the returned object.
Returns:
The array of bits for this row (true means black).
Throws:
ReaderException
Since:
BlackBerry API 6.0.0

getBlackMatrix

public BitMatrix getBlackMatrix()
                         throws ReaderException
Description copied from class: Binarizer
Converts a 2D array of luminance data to 1 bit data. As above, assume this method is expensive and do not call it repeatedly. This method is intended for decoding 2D barcodes and may or may not apply sharpening. Therefore, a row from this matrix may not be identical to one fetched using getBlackRow(), so don't mix and match between them.

Specified by:
getBlackMatrix in class Binarizer
Returns:
The 2D array of bits for the image (true means black).
Throws:
ReaderException
Since:
BlackBerry API 6.0.0

createBinarizer

public Binarizer createBinarizer(LuminanceSource source)
Description copied from class: Binarizer
Creates a new object with the same type as this Binarizer implementation, but with pristine state. This is needed because Binarizer implementations may be stateful, e.g. keeping a cache of 1 bit data. See Effective Java for why we can't use Java's clone() method.

Specified by:
createBinarizer in class Binarizer
Parameters:
source - The LuminanceSource this Binarizer will operate on.
Returns:
A new concrete Binarizer implementation object.
Since:
BlackBerry API 6.0.0





Copyright 1999-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.