org.esa.beam.framework.datamodel
Class ProductData.Byte

java.lang.Object
  org.esa.beam.framework.datamodel.ProductData
      org.esa.beam.framework.datamodel.ProductData.Byte

All Implemented Interfaces:

Cloneable

Direct Known Subclasses:

ProductData.ASCII, ProductData.UByte

Enclosing class:

ProductData

public static class ProductData.Byte
extends ProductData

The Byte class is a ProductData specialisation for signed 8-bit integer fields.

Internally, data is stored in an array of the type byte[].

Nested Class Summary

Nested classes/interfaces inherited from class org.esa.beam.framework.datamodel.ProductData

ProductData.ASCII, ProductData.Byte, ProductData.Double, ProductData.Float, ProductData.Int, ProductData.Short, ProductData.UByte, ProductData.UInt, ProductData.UShort, ProductData.UTC

Field Summary

protected byte[]

_array The internal data array holding this value's data elements.

Fields inherited from class org.esa.beam.framework.datamodel.ProductData

TYPE_ASCII, TYPE_FLOAT32, TYPE_FLOAT64, TYPE_INT16, TYPE_INT32, TYPE_INT8, TYPE_UINT16, TYPE_UINT32, TYPE_UINT8, TYPE_UNDEFINED, TYPE_UTC, TYPESTRING_ASCII, TYPESTRING_FLOAT32, TYPESTRING_FLOAT64, TYPESTRING_INT16, TYPESTRING_INT32, TYPESTRING_INT8, TYPESTRING_UINT16, TYPESTRING_UINT32, TYPESTRING_UINT8, TYPESTRING_UTC

Constructor Summary

	ProductData.Byte(byte[] array) Constructs a new signed byte value.
protected	ProductData.Byte(byte[] array, boolean unsigned) Constructs a new signed byte value.
	ProductData.Byte(int numElems) Constructs a new signed byte value.
protected	ProductData.Byte(int numElems, boolean unsigned) Constructs a new signed byte value.

Method Summary

Object	clone()
protected ProductData	createDeepClone() Retuns a "deep" copy of this product data.
void	dispose() Releases all of the resources used by this object instance and all of its owned children.
byte[]	getArray() Returns the internal data array holding this value's data elements.
double	getElemDoubleAt(int index) Please refer to ProductData.getElemDoubleAt(int).
float	getElemFloatAt(int index) Please refer to ProductData.getElemFloatAt(int).
int	getElemIntAt(int index) Please refer to ProductData.getElemIntAt(int).
Object	getElems() Gets the actual value value(s).
String	getElemStringAt(int index) Please refer to ProductData.getElemStringAt(int).
long	getElemUIntAt(int index) Please refer to ProductData.getElemUIntAt(int).
int	getNumElems() Returns the number of data elements this value has.
void	readFrom(int startPos, int numElems, ImageInputStream source) Please refer to ProductData.readFrom(int, int, ImageInputStream).
void	setElemDoubleAt(int index, double value) Please refer to ProductData.setElemDoubleAt(int, double).
void	setElemFloatAt(int index, float value) Please refer to ProductData.setElemFloatAt(int, float).
void	setElemIntAt(int index, int value) Please refer to ProductData.setElemIntAt(int, int).
void	setElems(Object data) Sets the data of this value.
void	setElemUIntAt(int index, long value) Please refer to ProductData.setElemUIntAt(int, long).
void	writeTo(int sourceStartPos, int numSourceElems, ImageOutputStream destination) Please refer to ProductData.writeTo(int, int, ImageOutputStream).

Methods inherited from class org.esa.beam.framework.datamodel.ProductData

createInstance, createInstance, createInstance, createInstance, createInstance, createInstance, createInstance, createInstance, createInstance, createInstance, createUnsignedInstance, createUnsignedInstance, createUnsignedInstance, equalElems, equals, getElemBoolean, getElemBooleanAt, getElemDouble, getElemFloat, getElemInt, getElemSize, getElemSize, getElemString, getElemUInt, getType, getType, getTypeString, getTypeString, hashCode, isFloatingPointType, isInt, isIntType, isScalar, isSigned, isUIntType, isUnsigned, readFrom, readFrom, readFrom, setElemBoolean, setElemBooleanAt, setElemDouble, setElemFloat, setElemInt, setElemString, setElemStringAt, setElemUInt, toString, writeTo, writeTo, writeTo

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

_array

protected byte[] _array

The internal data array holding this value's data elements.

Constructor Detail

ProductData.Byte

public ProductData.Byte(int numElems)

Constructs a new signed byte value.

Parameters:

numElems - the number of elements, must not be less than one

ProductData.Byte

protected ProductData.Byte(int numElems,
                           boolean unsigned)

Constructs a new signed byte value.

Parameters:

numElems - the number of elements, must not be less than one

unsigned - if true an unsigned value type is constructed

ProductData.Byte

public ProductData.Byte(byte[] array)

Constructs a new signed byte value.

Parameters:

array - the elements

ProductData.Byte

protected ProductData.Byte(byte[] array,
                           boolean unsigned)

Constructs a new signed byte value.

Parameters:

array - the elements

unsigned - if true an unsigned value type is constructed

Method Detail

createDeepClone

protected ProductData createDeepClone()

Retuns a "deep" copy of this product data.

Specified by:

createDeepClone in class ProductData

Returns:

a copy of this product data

getNumElems

public int getNumElems()

Returns the number of data elements this value has.

Specified by:

getNumElems in class ProductData

getElemIntAt

public int getElemIntAt(int index)

Please refer to ProductData.getElemIntAt(int).

Specified by:

getElemIntAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

getElemUIntAt

public long getElemUIntAt(int index)

Please refer to ProductData.getElemUIntAt(int).

Specified by:

getElemUIntAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

getElemFloatAt

public float getElemFloatAt(int index)

Please refer to ProductData.getElemFloatAt(int).

Specified by:

getElemFloatAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

getElemDoubleAt

public double getElemDoubleAt(int index)

Please refer to ProductData.getElemDoubleAt(int).

Specified by:

getElemDoubleAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

getElemStringAt

public String getElemStringAt(int index)

Please refer to ProductData.getElemStringAt(int).

Specified by:

getElemStringAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

setElemIntAt

public void setElemIntAt(int index,
                         int value)

Please refer to ProductData.setElemIntAt(int, int).

Specified by:

setElemIntAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

value - the value to be set

setElemUIntAt

public void setElemUIntAt(int index,
                          long value)

Please refer to ProductData.setElemUIntAt(int, long).

Specified by:

setElemUIntAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

value - the value to be set

setElemFloatAt

public void setElemFloatAt(int index,
                           float value)

Please refer to ProductData.setElemFloatAt(int, float).

Specified by:

setElemFloatAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

value - the value to be set

setElemDoubleAt

public void setElemDoubleAt(int index,
                            double value)

Please refer to ProductData.setElemDoubleAt(int, double).

Specified by:

setElemDoubleAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

value - the value to be set

getArray

public final byte[] getArray()

Returns the internal data array holding this value's data elements.

Returns:

the internal data array, never null

getElems

public Object getElems()

Gets the actual value value(s). The value returned can safely been casted to an array object of the type byte[].

Specified by:

getElems in class ProductData

Returns:

this value's value, always a byte[], never null

setElems

public void setElems(Object data)

Sets the data of this value. The data must be an array of the type byte[] or String[] and have a length that is equal to the value returned by the getNumDataElems method.

Specified by:

setElems in class ProductData

Parameters:

data - the data array

Throws:

IllegalArgumentException - if data is null or it is not an array of the required type or does not have the required array length.

readFrom

public void readFrom(int startPos,
                     int numElems,
                     ImageInputStream source)
              throws IOException

Please refer to ProductData.readFrom(int, int, ImageInputStream).

Specified by:

readFrom in class ProductData

Parameters:

startPos - the destination start position (zero-based)

numElems - the number of elements to read

source - a seekable data input stream

Throws:

IOException - if an I/O error occurs

writeTo

public void writeTo(int sourceStartPos,
                    int numSourceElems,
                    ImageOutputStream destination)
             throws IOException

Please refer to ProductData.writeTo(int, int, ImageOutputStream).

Specified by:

writeTo in class ProductData

Parameters:

sourceStartPos - the source start position (zero-based)

numSourceElems - the number of elements to be written

destination - a seekable data output stream

Throws:

IOException - if an I/O error occurs

clone

public Object clone()

Overrides:

clone in class Object

dispose

public void dispose()

Releases all of the resources used by this object instance and all of its owned children. Its primary use is to allow the garbage collector to perform a vanilla job.

This method should be called only if it is for sure that this object instance will never be used again. The results of referencing an instance of this class after a call to dispose() are undefined.

Overrides of this method should always call super.dispose(); after disposing this instance.

Specified by:

dispose in class ProductData