byte primitives
* to represent each of its banks.
*
* @author Rolf W. Rasmussen (rolfwr@ii.uib.no)
*/
public final class DataBufferByte extends DataBuffer
{
private byte[] data;
private byte[][] bankData;
/**
* Creates a new data buffer with a single data bank containing the
* specified number of byte elements.
*
* @param size the number of elements in the data bank.
*/
public DataBufferByte(int size)
{
super(TYPE_BYTE, size, 1, 0);
bankData = new byte[1][];
data = new byte[size];
bankData[0] = data;
}
/**
* Creates a new data buffer with the specified number of data banks,
* each containing the specified number of byte elements.
*
* @param size the number of elements in the data bank.
* @param numBanks the number of data banks.
*/
public DataBufferByte(int size, int numBanks)
{
super(TYPE_BYTE, size, numBanks);
bankData = new byte[numBanks][size];
data = bankData[0];
}
/**
* Creates a new data buffer backed by the specified data bank.
*
* Note: there is no exception when dataArray is
* null, but in that case an exception will be thrown
* later if you attempt to access the data buffer.
*
* @param dataArray the data bank.
* @param size the number of elements in the data bank.
*/
public DataBufferByte(byte[] dataArray, int size)
{
super(TYPE_BYTE, size, 1, 0);
bankData = new byte[1][];
data = dataArray;
bankData[0] = data;
}
/**
* Creates a new data buffer backed by the specified data bank, with
* the specified offset to the first element.
*
* Note: there is no exception when dataArray is
* null, but in that case an exception will be thrown
* later if you attempt to access the data buffer.
*
* @param dataArray the data bank.
* @param size the number of elements in the data bank.
* @param offset the offset to the first element in the array.
*/
public DataBufferByte(byte[] dataArray, int size, int offset)
{
super(TYPE_BYTE, size, 1, offset);
bankData = new byte[1][];
data = dataArray;
bankData[0] = data;
}
/**
* Creates a new data buffer backed by the specified data banks.
*
* @param dataArray the data banks.
* @param size the number of elements in the data bank.
*
* @throws NullPointerException if dataArray is
* null.
*/
public DataBufferByte(byte[][] dataArray, int size)
{
super(TYPE_BYTE, size, dataArray.length);
bankData = dataArray;
data = bankData[0];
}
/**
* Creates a new data buffer backed by the specified data banks, with
* the specified offsets to the first element in each bank.
*
* @param dataArray the data banks.
* @param size the number of elements in the data bank.
* @param offsets the offsets to the first element in each data bank.
*
* @throws NullPointerException if dataArray is
* null.
*/
public DataBufferByte(byte[][] dataArray, int size, int[] offsets)
{
super(TYPE_BYTE, size, dataArray.length, offsets);
bankData = dataArray;
data = bankData[0];
}
/**
* Returns the first data bank.
*
* @return The first data bank.
*/
public byte[] getData()
{
return data;
}
/**
* Returns a data bank.
*
* @param bank the bank index.
* @return A data bank.
*/
public byte[] getData(int bank)
{
return bankData[bank];
}
/**
* Returns the array underlying this DataBuffer.
*
* @return The data banks.
*/
public byte[][] getBankData()
{
return bankData;
}
/**
* Returns an element from the first data bank. The offset (specified in
* the constructor) is added to i before accessing the
* underlying data array.
*
* @param i the element index.
* @return The element.
*/
public int getElem(int i)
{
return data[i+offset] & 0xff; // get unsigned byte as int
}
/**
* Returns an element from a particular data bank. The offset (specified in
* the constructor) is added to i before accessing the
* underlying data array.
*
* @param bank the bank index.
* @param i the element index.
* @return The element.
*/
public int getElem(int bank, int i)
{
// get unsigned byte as int
return bankData[bank][i+offsets[bank]] & 0xff;
}
/**
* Sets an element in the first data bank. The offset (specified in the
* constructor) is added to i before updating the underlying
* data array.
*
* @param i the element index.
* @param val the new element value.
*/
public void setElem(int i, int val)
{
data[i+offset] = (byte) val;
}
/**
* Sets an element in a particular data bank. The offset (specified in the
* constructor) is added to i before updating the underlying
* data array.
*
* @param bank the data bank index.
* @param i the element index.
* @param val the new element value.
*/
public void setElem(int bank, int i, int val)
{
bankData[bank][i+offsets[bank]] = (byte) val;
}
}