java.awt.image: public final class: DataBufferFloat

java.awt.image
public final class: DataBufferFloat [javadoc | source]

java.lang.Object
   java.awt.image.DataBuffer
      java.awt.image.DataBufferFloat

This class extends DataBuffer and stores data internally in float form.

Note that some implementations may function more efficiently if they can maintain control over how the data for an image is stored. For example, optimizations such as caching an image in video memory require that the implementation track all modifications to that data. Other implementations may operate better if they can store the data in locations other than a Java array. To maintain optimum compatibility with various optimizations it is best to avoid constructors and methods which expose the underlying storage as a Java array as noted below in the documentation for those methods.

since: 1.4 -

Field Summary
float[][]	bankdata	The array of data banks.
float[]	data	A reference to the default data bank.

Fields inherited from java.awt.image.DataBuffer:
TYPE_BYTE, TYPE_USHORT, TYPE_SHORT, TYPE_INT, TYPE_FLOAT, TYPE_DOUBLE, TYPE_UNDEFINED, dataType, banks, offset, size, offsets, theTrackable

Constructor:

Constructor:
public DataBufferFloat(int size) { super(STABLE, TYPE_FLOAT, size); data = new float[size]; bankdata = new float[1][]; bankdata[0] = data; } Constructs a `float`-based `DataBuffer` with a specified size. Parameters: `size` - The number of elements in the DataBuffer.
public DataBufferFloat(int size, int numBanks) { super(STABLE, TYPE_FLOAT, size, numBanks); bankdata = new float[numBanks][]; for (int i= 0; i < numBanks; i++) { bankdata[i] = new float[size]; } data = bankdata[0]; } Constructs a `float`-based `DataBuffer` with a specified number of banks, all of which are of a specified size. Parameters: `size` - The number of elements in each bank of the `DataBuffer`. `numBanks` - The number of banks in the `DataBuffer`.
public DataBufferFloat(float[] dataArray, int size) { super(UNTRACKABLE, TYPE_FLOAT, size); data = dataArray; bankdata = new float[1][]; bankdata[0] = data; } Constructs a `float`-based `DataBuffer` with the specified data array. Only the first `size` elements are available for use by this `DataBuffer`. The array must be large enough to hold `size` elements. Note that {@code DataBuffer} objects created by this constructor may be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory). Parameters: `dataArray` - An array of `float`s to be used as the first and only bank of this `DataBuffer`. `size` - The number of elements of the array to be used.
public DataBufferFloat(float[][] dataArray, int size) { super(UNTRACKABLE, TYPE_FLOAT, size, dataArray.length); bankdata = (float[][]) dataArray.clone(); data = bankdata[0]; } Constructs a `float`-based `DataBuffer` with the specified data arrays. Only the first `size` elements of each array are available for use by this `DataBuffer`. The number of banks will be equal to `dataArray.length`. Note that {@code DataBuffer} objects created by this constructor may be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory). Parameters: `dataArray` - An array of arrays of `float`s to be used as the banks of this `DataBuffer`. `size` - The number of elements of each array to be used.
public DataBufferFloat(float[] dataArray, int size, int offset) { super(UNTRACKABLE, TYPE_FLOAT, size, 1, offset); data = dataArray; bankdata = new float[1][]; bankdata[0] = data; } Constructs a `float`-based `DataBuffer` with the specified data array. Only the elements between `offset` and `offset + size - 1` are available for use by this `DataBuffer`. The array must be large enough to hold `offset + size` elements. Note that {@code DataBuffer} objects created by this constructor may be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory). Parameters: `dataArray` - An array of `float`s to be used as the first and only bank of this `DataBuffer`. `size` - The number of elements of the array to be used. `offset` - The offset of the first element of the array that will be used.
public DataBufferFloat(float[][] dataArray, int size, int[] offsets) { super(UNTRACKABLE, TYPE_FLOAT, size,dataArray.length, offsets); bankdata = (float[][]) dataArray.clone(); data = bankdata[0]; } Constructs a `float`-based `DataBuffer` with the specified data arrays, size, and per-bank offsets. The number of banks is equal to `dataArray.length`. Each array must be at least as large as `size` plus the corresponding offset. There must be an entry in the offsets array for each data array. Note that {@code DataBuffer} objects created by this constructor may be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory). Parameters: `dataArray` - An array of arrays of `float`s to be used as the banks of this `DataBuffer`. `size` - The number of elements of each array to be used. `offsets` - An array of integer offsets, one for each bank.

 public DataBufferFloat(int size) {
        super(STABLE, TYPE_FLOAT, size);
        data = new float[size];
        bankdata = new float[1][];
        bankdata[0] = data;
}

Constructs a float-based DataBuffer with a specified size.

Parameters:

size - The number of elements in the DataBuffer.

 public DataBufferFloat(int size,
    int numBanks) {
        super(STABLE, TYPE_FLOAT, size, numBanks);
        bankdata = new float[numBanks][];
        for (int i= 0; i <  numBanks; i++) {
            bankdata[i] = new float[size];
        }
        data = bankdata[0];
}

Constructs a float-based DataBuffer with a specified number of banks, all of which are of a specified size.

Parameters:

size - The number of elements in each bank of the DataBuffer.

numBanks - The number of banks in the DataBuffer.

 public DataBufferFloat(float[] dataArray,
    int size) {
        super(UNTRACKABLE, TYPE_FLOAT, size);
        data = dataArray;
        bankdata = new float[1][];
        bankdata[0] = data;
}

Constructs a float-based DataBuffer with the specified data array. Only the first size elements are available for use by this DataBuffer. The array must be large enough to hold size elements.

Note that {@code DataBuffer} objects created by this constructor may be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory).

Parameters:

dataArray - An array of floats to be used as the first and only bank of this DataBuffer.

size - The number of elements of the array to be used.

 public DataBufferFloat(float[][] dataArray,
    int size) {
        super(UNTRACKABLE, TYPE_FLOAT, size, dataArray.length);
        bankdata = (float[][]) dataArray.clone();
        data = bankdata[0];
}

Constructs a float-based DataBuffer with the specified data arrays. Only the first size elements of each array are available for use by this DataBuffer. The number of banks will be equal to dataArray.length.

Note that {@code DataBuffer} objects created by this constructor may be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory).

Parameters:

dataArray - An array of arrays of floats to be used as the banks of this DataBuffer.

size - The number of elements of each array to be used.

 public DataBufferFloat(float[] dataArray,
    int size,
    int offset) {
        super(UNTRACKABLE, TYPE_FLOAT, size, 1, offset);
        data = dataArray;
        bankdata = new float[1][];
        bankdata[0] = data;
}

Constructs a float-based DataBuffer with the specified data array. Only the elements between offset and offset + size - 1 are available for use by this DataBuffer. The array must be large enough to hold offset + size elements.

Note that {@code DataBuffer} objects created by this constructor may be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory).

Parameters:

dataArray - An array of floats to be used as the first and only bank of this DataBuffer.

size - The number of elements of the array to be used.

offset - The offset of the first element of the array that will be used.

 public DataBufferFloat(float[][] dataArray,
    int size,
    int[] offsets) {
        super(UNTRACKABLE, TYPE_FLOAT, size,dataArray.length, offsets);
        bankdata = (float[][]) dataArray.clone();
        data = bankdata[0];
}

Constructs a float-based DataBuffer with the specified data arrays, size, and per-bank offsets. The number of banks is equal to dataArray.length. Each array must be at least as large as size plus the corresponding offset. There must be an entry in the offsets array for each data array.

Note that {@code DataBuffer} objects created by this constructor may be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory).

Parameters:

dataArray - An array of arrays of floats to be used as the banks of this DataBuffer.

size - The number of elements of each array to be used.

offsets - An array of integer offsets, one for each bank.

Method from java.awt.image.DataBufferFloat Summary:
getBankData, getData, getData, getElem, getElem, getElemDouble, getElemDouble, getElemFloat, getElemFloat, setElem, setElem, setElemDouble, setElemDouble, setElemFloat, setElemFloat

Methods from java.awt.image.DataBuffer:
getDataType, getDataTypeSize, getElem, getElem, getElemDouble, getElemDouble, getElemFloat, getElemFloat, getNumBanks, getOffset, getOffsets, getSize, setElem, setElem, setElemDouble, setElemDouble, setElemFloat, setElemFloat, toIntArray

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from java.awt.image.DataBufferFloat Detail:
public float[][] getBankData() { theTrackable.setUntrackable(); return (float[][]) bankdata.clone(); } Returns the data array for all banks. Note that calling this method may cause this {@code DataBuffer} object to be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory).
public float[] getData() { theTrackable.setUntrackable(); return data; } Returns the default (first) `float` data array. Note that calling this method may cause this {@code DataBuffer} object to be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory).
public float[] getData(int bank) { theTrackable.setUntrackable(); return bankdata[bank]; } Returns the data array for the specified bank. Note that calling this method may cause this {@code DataBuffer} object to be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory).
public int getElem(int i) { return (int)(data[i+offset]); } Returns the requested data array element from the first (default) bank as an `int`.
public int getElem(int bank, int i) { return (int)(bankdata[bank][i+offsets[bank]]); } Returns the requested data array element from the specified bank as an `int`.
public double getElemDouble(int i) { return (double)data[i+offset]; } Returns the requested data array element from the first (default) bank as a `double`.
public double getElemDouble(int bank, int i) { return (double)bankdata[bank][i+offsets[bank]]; } Returns the requested data array element from the specified bank as a `double`.
public float getElemFloat(int i) { return data[i+offset]; } Returns the requested data array element from the first (default) bank as a `float`.
public float getElemFloat(int bank, int i) { return bankdata[bank][i+offsets[bank]]; } Returns the requested data array element from the specified bank as a `float`.
public void setElem(int i, int val) { data[i+offset] = (float)val; theTrackable.markDirty(); } Sets the requested data array element in the first (default) bank to the given `int`.
public void setElem(int bank, int i, int val) { bankdata[bank][i+offsets[bank]] = (float)val; theTrackable.markDirty(); } Sets the requested data array element in the specified bank to the given `int`.
public void setElemDouble(int i, double val) { data[i+offset] = (float)val; theTrackable.markDirty(); } Sets the requested data array element in the first (default) bank to the given `double`.
public void setElemDouble(int bank, int i, double val) { bankdata[bank][i+offsets[bank]] = (float)val; theTrackable.markDirty(); } Sets the requested data array element in the specified bank to the given `double`.
public void setElemFloat(int i, float val) { data[i+offset] = val; theTrackable.markDirty(); } Sets the requested data array element in the first (default) bank to the given `float`.
public void setElemFloat(int bank, int i, float val) { bankdata[bank][i+offsets[bank]] = val; theTrackable.markDirty(); } Sets the requested data array element in the specified bank to the given `float`.

Method from java.awt.image.DataBufferFloat Detail:

 public float[][] getBankData() {
        theTrackable.setUntrackable();
        return (float[][]) bankdata.clone();
}

Note that calling this method may cause this {@code DataBuffer} object to be incompatible with performance optimizations used by some implementations (such as caching an associated image in video memory).

 public float[] getData() {
        theTrackable.setUntrackable();
        return data;
}

float

 public float[] getData(int bank) {
        theTrackable.setUntrackable();
        return bankdata[bank];
}

 public int getElem(int i) {
        return (int)(data[i+offset]);
}

int

 public int getElem(int bank,
    int i) {
        return (int)(bankdata[bank][i+offsets[bank]]);
}

int

 public double getElemDouble(int i) {
        return (double)data[i+offset];
}

double

 public double getElemDouble(int bank,
    int i) {
        return (double)bankdata[bank][i+offsets[bank]];
}

double

 public float getElemFloat(int i) {
        return data[i+offset];
}

float

 public float getElemFloat(int bank,
    int i) {
        return bankdata[bank][i+offsets[bank]];
}

float

 public  void setElem(int i,
    int val) {
        data[i+offset] = (float)val;
        theTrackable.markDirty();
}

int

 public  void setElem(int bank,
    int i,
    int val) {
        bankdata[bank][i+offsets[bank]] = (float)val;
        theTrackable.markDirty();
}

int

 public  void setElemDouble(int i,
    double val) {
        data[i+offset] = (float)val;
        theTrackable.markDirty();
}

double

 public  void setElemDouble(int bank,
    int i,
    double val) {
        bankdata[bank][i+offsets[bank]] = (float)val;
        theTrackable.markDirty();
}

double

 public  void setElemFloat(int i,
    float val) {
        data[i+offset] = val;
        theTrackable.markDirty();
}

float

 public  void setElemFloat(int bank,
    int i,
    float val) {
        bankdata[bank][i+offsets[bank]] = val;
        theTrackable.markDirty();
}

float