java.awt.image

クラス DataBufferByte

java.lang.Object

java.awt.image.DataBuffer

java.awt.image.DataBufferByte

public final class DataBufferByte
extends DataBuffer

このクラスは DataBuffer を拡張し、データをバイトとして内部的に格納します。この 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

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

コンストラクタ

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

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
byte[][]	getBankData() すべてのバンクについて、データ配列を返します。
byte[]	getData() デフォルト (最初の) バイトデータ配列を返します。
byte[]	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

コンストラクタの詳細

DataBufferByte

public DataBufferByte(int size)

単一のバンクと指定されたサイズを持つバイトベースの DataBuffer を構築します。

パラメータ:

size - DataBuffer のサイズ。

DataBufferByte

public DataBufferByte(int size,
              int numBanks)

指定された数のバンクを持つバイトベースの DataBuffer を構築します。すべてのバンクは指定されたサイズを持ちます。

パラメータ:

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

numBanks - DataBuffer 内のバンク数。

DataBufferByte

public DataBufferByte(byte[] dataArray,
              int size)

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

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

パラメータ:

dataArray - DataBuffer のバイト配列。

size - DataBuffer バンクのサイズ。

DataBufferByte

public DataBufferByte(byte[] dataArray,
              int size,
              int offset)

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

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

パラメータ:

dataArray - DataBuffer のバイト配列。

size - DataBuffer バンクのサイズ。

offset - dataArray へのオフセット。dataArray は、少なくとも offset + size 要素を持つ必要があります。

DataBufferByte

public DataBufferByte(byte[][] dataArray,
              int size)

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

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

パラメータ:

dataArray - DataBuffer のバイト配列。

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

DataBufferByte

public DataBufferByte(byte[][] dataArray,
              int size,
              int[] offsets)

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

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

パラメータ:

dataArray - DataBuffer のバイト配列。

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

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

メソッドの詳細

getData

public byte[] getData()

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

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

戻り値:

最初のバイトデータ配列

getData

public byte[] getData(int bank)

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

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

パラメータ:

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

戻り値:

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

getBankData

public byte[][] 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)