モジュール java.desktop

パッケージ 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)