java.awt.image

クラス DataBufferUShort

java.lang.Object

java.awt.image.DataBuffer

java.awt.image.DataBufferUShort

public final class DataBufferUShort
extends DataBuffer

このクラスは DataBuffer を拡張し、データを short として内部的に格納します。この DataBuffer 配列に格納された値は、符号を持たない値として扱われます。

イメージのデータの格納方法の制御を維持できる場合、より効率的に機能できる実装もあります。たとえば、ビデオメモリーにイメージをキャッシュするなどの最適化では、実装でそのデータへのすべての変更を追跡する必要があります。ほかに、Java 配列以外の場所にデータを格納できる場合、より適切に動作できる実装もあります。さまざまな最適化によって最適な互換性を維持するには、基礎のストレージを Java 配列として公開するコンストラクタやメソッドを避けることをお勧めします。これについては、それらのメソッドの説明で後述しています。

フィールドのサマリー

クラス java.awt.image.DataBuffer から継承されたフィールド

banks, dataType, offset, offsets, size, TYPE_BYTE, TYPE_DOUBLE, TYPE_FLOAT, TYPE_INT, TYPE_SHORT, TYPE_UNDEFINED, TYPE_USHORT

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
DataBufferUShort(int size) 1 つのバンクを持ち、サイズが指定された、unsigned-short ベースの DataBuffer を構築します。
DataBufferUShort(int size, int numBanks) 指定されたサイズのバンクを指定された数だけ持つ、unsigned-short ベースの DataBuffer を構築します。
DataBufferUShort(short[][] dataArray, int size) unsigned-short ベースの DataBuffer を、指定された配列を使用して構築します。
DataBufferUShort(short[][] dataArray, int size, int[] offsets) unsigned-short ベースの DataBuffer を、指定された配列、サイズ、オフセットを使用して構築します。
DataBufferUShort(short[] dataArray, int size) 1 つのバンクを持つ、unsigned-short ベースの DataBuffer を、指定された配列を使用して構築します。
DataBufferUShort(short[] dataArray, int size, int offset) 指定された配列、サイズ、およびオフセットを使用して単一のバンクを持つ unsigned-short ベースの DataBuffer を構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
short[][]	getBankData() すべてのバンクについて、データ配列を返します。
short[]	getData() デフォルト (最初) の unsigned-short データ配列を返します。
short[]	getData(int bank) 指定されたバンクのデータ配列を返します。
int	getElem(int i) 要求されたデータ配列要素を、最初の (デフォルトの) バンクから返します。
int	getElem(int bank, int i) 要求されたデータ配列要素を、指定されたバンクから返します。
void	setElem(int i, int val) 最初の (デフォルトの) バンクにある要求されたデータ配列要素を、指定された値に設定します。
void	setElem(int bank, int i, int val) 指定されたバンク内の要求されたデータ配列要素を、指定された int 値で設定します。

クラス java.awt.image.DataBuffer から継承されたメソッド

getDataType, getDataTypeSize, getElemDouble, getElemDouble, getElemFloat, getElemFloat, getNumBanks, getOffset, getOffsets, getSize, setElemDouble, setElemDouble, setElemFloat, setElemFloat

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

DataBufferUShort

public DataBufferUShort(int size)

1 つのバンクを持ち、サイズが指定された、unsigned-short ベースの DataBuffer を構築します。

パラメータ:

size - DataBuffer のサイズ。

DataBufferUShort

public DataBufferUShort(int size,
                int numBanks)

指定されたサイズのバンクを指定された数だけ持つ、unsigned-short ベースの DataBuffer を構築します。

パラメータ:

size - DataBuffer 内のバンクのサイズ。

numBanks - DataBuffer 内のバンク数。

DataBufferUShort

public DataBufferUShort(short[] dataArray,
                int size)

1 つのバンクを持つ、unsigned-short ベースの DataBuffer を、指定された配列を使用して構築します。最初の size 要素だけを、この DataBuffer にアクセスするために使用します。dataArray は、size 要素を格納するために十分な大きさを持つ必要があります。

このコンストラクタによって作成された DataBuffer オブジェクトが一部の実装 (ビデオメモリーに関連イメージをキャッシュするなど) で使われているパフォーマンス最適化と互換性がないことがあるので注意してください。

パラメータ:

dataArray - DataBuffer の unsigned-short 配列。

size - DataBuffer バンクのサイズ。

DataBufferUShort

public DataBufferUShort(short[] dataArray,
                int size,
                int offset)

1 つのバンクを持つ、unsigned-short ベースの DataBuffer を、指定された配列、サイズ、オフセットを使用して構築します。dataArray は少なくとも、offset + size 要素の長さを持つ必要があります。offset から offset + size - 1 の要素だけをこの DataBuffer にアクセスするために使用します。

このコンストラクタによって作成された DataBuffer オブジェクトが一部の実装 (ビデオメモリーに関連イメージをキャッシュするなど) で使われているパフォーマンス最適化と互換性がないことがあるので注意してください。

パラメータ:

dataArray - DataBuffer の unsigned-short 配列。

size - DataBuffer バンクのサイズ。

offset - dataArray へのオフセット。

DataBufferUShort

public DataBufferUShort(short[][] dataArray,
                int size)

unsigned-short ベースの DataBuffer を、指定された配列を使用して構築します。バンク数は dataArray.length の値と一致します。各配列の最初の size 要素だけを、この DataBuffer へのアクセスに使用します。

このコンストラクタによって作成された DataBuffer オブジェクトが一部の実装 (ビデオメモリーに関連イメージをキャッシュするなど) で使われているパフォーマンス最適化と互換性がないことがあるので注意してください。

パラメータ:

dataArray - DataBuffer の unsigned-short 配列。

size - DataBuffer 内のバンクのサイズ。

DataBufferUShort

public DataBufferUShort(short[][] dataArray,
                int size,
                int[] offsets)

unsigned-short ベースの DataBuffer を、指定された配列、サイズ、オフセットを使用して構築します。バンク数は dataArray.length の値と一致します。各配列は、size + 対応する offset 以上の大きさである必要があります。各 dataArray エントリの offset 配列内にエントリが必要です。バンクごとに、offset から offset + size - 1 の要素だけをこの DataBuffer にアクセスするために使用します。

このコンストラクタによって作成された DataBuffer オブジェクトが一部の実装 (ビデオメモリーに関連イメージをキャッシュするなど) で使われているパフォーマンス最適化と互換性がないことがあるので注意してください。

パラメータ:

dataArray - DataBuffer の unsigned-short 配列。

size - DataBuffer 内のバンクのサイズ。

offsets - 各配列へのオフセット。

メソッドの詳細

getData

public short[] getData()

デフォルト (最初) の unsigned-short データ配列を返します。

このメソッドを呼び出すと、この DataBuffer オブジェクトが、一部の実装 (ビデオメモリーに関連イメージをキャッシュするなど) で使われているパフォーマンス最適化と互換性がなくなることがあるので注意してください。

戻り値:

最初の unsigned-short データ配列

getData

public short[] getData(int bank)

指定されたバンクのデータ配列を返します。

このメソッドを呼び出すと、この DataBuffer オブジェクトが、一部の実装 (ビデオメモリーに関連イメージをキャッシュするなど) で使われているパフォーマンス最適化と互換性がなくなることがあるので注意してください。

パラメータ:

bank - データ配列を取得するバンク。

戻り値:

指定されたバンクのデータ配列

getBankData

public short[][] getBankData()

すべてのバンクについて、データ配列を返します。

このメソッドを呼び出すと、この DataBuffer オブジェクトが、一部の実装 (ビデオメモリーに関連イメージをキャッシュするなど) で使われているパフォーマンス最適化と互換性がなくなることがあるので注意してください。

戻り値:

すべてのデータ配列

getElem

public int getElem(int i)

要求されたデータ配列要素を、最初の (デフォルトの) バンクから返します。

オーバーライド:

getElem、クラス: DataBuffer

パラメータ:

i - 取得するデータ配列要素。

戻り値:

要求された整数型のデータ配列要素

関連項目:

setElem(int, int), setElem(int, int, int)

getElem

public int getElem(int bank,
          int i)

要求されたデータ配列要素を、指定されたバンクから返します。

定義:

getElem、クラス: DataBuffer

パラメータ:

bank - データ配列要素を取得するバンク。

i - 取得するデータ配列要素。

戻り値:

要求された整数型のデータ配列要素

関連項目:

setElem(int, int), setElem(int, int, int)

setElem

public void setElem(int i,
           int val)

最初の (デフォルトの) バンクにある要求されたデータ配列要素を、指定された値に設定します。

オーバーライド:

setElem、クラス: DataBuffer

パラメータ:

i - 設定するデータ配列要素。

val - データ配列要素を設定する整数値。

関連項目:

getElem(int), getElem(int, int)

setElem

public void setElem(int bank,
           int i,
           int val)

指定されたバンク内の要求されたデータ配列要素を、指定された int 値で設定します。

定義:

setElem、クラス: DataBuffer

パラメータ:

bank - データ配列要素を設定するバンク。

i - 設定するデータ配列要素。

val - 指定されたデータ配列要素を設定する整数値。

関連項目:

getElem(int), getElem(int, int)