public final class BitMatrix extends Object implements Cloneable
Represents a 2D matrix of bits. In function arguments below, and throughout the common module, x is the column position, and y is the row position. The ordering is always x, y. The origin is at the top-left.
Internally the bits are represented in a 1-D array of 32-bit ints. However, each row begins with a new int. This is done intentionally so that we can copy out a row into a BitArray very efficiently.
The ordering of bits is row-major. Within each int, the least significant bits are used first, meaning they represent lower x values. This is compatible with BitArray's implementation.
限定符和类型 | 方法和说明 |
---|---|
void |
clear()
Clears all bits (sets to false).
|
BitMatrix |
clone() |
boolean |
equals(Object o) |
void |
flip(int x,
int y)
Flips the given bit.
|
boolean |
get(int x,
int y)
Gets the requested bit, where true means black.
|
int[] |
getBottomRightOnBit() |
int[] |
getEnclosingRectangle()
This is useful in detecting the enclosing rectangle of a 'pure' barcode.
|
int |
getHeight() |
BitArray |
getRow(int y,
BitArray row)
A fast method to retrieve one row of data from the matrix as a BitArray.
|
int[] |
getTopLeftOnBit()
This is useful in detecting a corner of a 'pure' barcode.
|
int |
getWidth() |
int |
hashCode() |
void |
rotate180()
Modifies this
BitMatrix to represent the same but rotated 180 degrees |
void |
set(int x,
int y)
Sets the given bit to true.
|
void |
setRegion(int left,
int top,
int width,
int height)
Sets a square region of the bit matrix to true.
|
void |
setRow(int y,
BitArray row) |
String |
toString() |
public boolean get(int x, int y)
Gets the requested bit, where true means black.
x
- The horizontal component (i.e. which column)y
- The vertical component (i.e. which row)public void set(int x, int y)
Sets the given bit to true.
x
- The horizontal component (i.e. which column)y
- The vertical component (i.e. which row)public void flip(int x, int y)
Flips the given bit.
x
- The horizontal component (i.e. which column)y
- The vertical component (i.e. which row)public void clear()
public void setRegion(int left, int top, int width, int height)
Sets a square region of the bit matrix to true.
left
- The horizontal position to begin at (inclusive)top
- The vertical position to begin at (inclusive)width
- The width of the regionheight
- The height of the regionpublic BitArray getRow(int y, BitArray row)
y
- The row to retrieverow
- An optional caller-allocated BitArray, will be allocated if null or too smallpublic void rotate180()
BitMatrix
to represent the same but rotated 180 degreespublic int[] getEnclosingRectangle()
left,top,width,height
enclosing rectangle of all 1 bits, or null if it is all whitepublic int[] getTopLeftOnBit()
x,y
coordinate of top-left-most 1 bit, or null if it is all whitepublic int[] getBottomRightOnBit()
public int getWidth()
public int getHeight()
Copyright © 2007–2014. All rights reserved.