public interface PixelWriter
WritableImage
または書込み可能なピクセルを含むその他の面のピクセル・データを書き込むためのメソッドを定義します。修飾子と型 | メソッドと説明 |
---|---|
PixelFormat |
getPixelFormat()
このメソッドは、面がそのピクセルを格納する
PixelFormat 、またはこのメソッドがそれを元にピクセルを簡単に変換できる、おおよそ同等の、書込みを目的としたピクセル・フォーマットを返します。 |
void |
setArgb(int x, int y, int argb)
色のピクセル・データを面の指定された座標に格納します。
|
void |
setColor(int x, int y, Color c)
Color のピクセル・データを面の指定された座標に格納します。 |
void |
setPixels(int x, int y, int w, int h, PixelFormat<ByteBuffer> pixelformat, byte[] buffer, int offset, int scanlineStride)
バイト配列から面の矩形リージョンにピクセル・データを格納します。
|
void |
setPixels(int x, int y, int w, int h, PixelFormat<IntBuffer> pixelformat, int[] buffer, int offset, int scanlineStride)
int配列から面の矩形リージョンにピクセル・データを格納します。
|
<T extends Buffer> |
setPixels(int x, int y, int w, int h, PixelFormat<T> pixelformat, T buffer, int scanlineStride)
バッファから面の矩形リージョンにピクセル・データを格納します。
|
void |
setPixels(int dstx, int dsty, int w, int h, PixelReader reader, int srcx, int srcy)
PixelReader インスタンスから取得されたピクセル・データを面の矩形リージョンに格納します。 |
PixelFormat getPixelFormat()
PixelFormat
、またはこのメソッドがそれを元にピクセルを簡単に変換できる、おおよそ同等の、書込みを目的としたピクセル・フォーマットを返します。PixelFormat
void setArgb(int x, int y, int argb)
argb
パラメータには、ARGBの最上位バイトから最下位バイトへの順序で、個別の8ビット・フィールドに4つの色成分が含まれる必要があります。x
- 書き込むピクセルの色のX座標y
- 書き込むピクセルの色のY座標argb
- INT_ARGB
のPixelFormatタイプで記述されたフォーマットで指定された、書き込む色の情報。void setColor(int x, int y, Color c)
Color
のピクセル・データを面の指定された座標に格納します。x
- 書き込むピクセルの色のX座標y
- 書き込むピクセルの色のY座標c
- 書き込むかnullに設定する色NullPointerException
- color
がnull
の場合<T extends Buffer> void setPixels(int x, int y, int w, int h, PixelFormat<T> pixelformat, T buffer, int scanlineStride)
PixelFormat
オブジェクトによって定義され、面にデータを格納するために、必要に応じてピクセル・フォーマットの変換が実行されます。バッファの位置は、(x, y)
の位置にある面のピクセルに格納される、最初のピクセル・データがある位置にあると想定されます。行のピクセル・データは、X座標の増加に対応するようにできるかぎり近接してまとめられたバッファ内の隣接する場所から読み取られます。隣接する行のピクセル・データは、scanlineStride
で定義されたバッファ・データ要素の数によって互いにオフセットされて読み取られます。x
- 書き込む矩形リージョンのX座標y
- 書き込む矩形リージョンのY座標w
- 書き込む矩形リージョンの幅h
- 書き込む矩形リージョンの高さpixelformat
- バッファからピクセルを書き込むためのフォーマットを定義するPixelFormat
オブジェクトbuffer
- 指定されたPixelFormat
オブジェクトに適切なタイプのバッファscanlineStride
- バッファ内のデータのある行の先頭のピクセル・データから、データの次の行の先頭までの距離。NullPointerException
- @{code pixelformat}またはbuffer
がnull
の場合void setPixels(int x, int y, int w, int h, PixelFormat<ByteBuffer> pixelformat, byte[] buffer, int offset, int scanlineStride)
PixelFormat
オブジェクトによって定義され、面にデータを格納するために、必要に応じてピクセル・フォーマットの変換が実行されます。pixelformat
は、適合するPixelFormat<ByteBuffer>
タイプにする必要があります。(x, y)
の位置にある最初のピクセルのデータは、offset
パラメータで指定された配列インデックスから読み取られます。行のピクセル・データは、X座標の増加に対応するようにできるかぎり近接してまとめられた配列内の隣接する場所から読み取られます。隣接する行のピクセル・データは、scanlineStride
で定義されたバイト配列要素の数によって互いにオフセットされて読み取られます。x
- 書き込む矩形リージョンのX座標y
- 書き込む矩形リージョンのY座標w
- 書き込む矩形リージョンの幅h
- 書き込む矩形リージョンの高さpixelformat
- バッファからピクセルを読み取るためのバイト・フォーマットを定義するPixelFormat<ByteBuffer>
オブジェクトbuffer
- 格納するピクセル・データを含むバイト配列offset
- 最初のピクセル・データを読み取るためのbuffer
へのオフセットscanlineStride
- バッファ内のデータのある行の先頭のピクセル・データから、データの次の行の先頭までの距離NullPointerException
- @{code pixelformat}またはbuffer
がnull
の場合void setPixels(int x, int y, int w, int h, PixelFormat<IntBuffer> pixelformat, int[] buffer, int offset, int scanlineStride)
PixelFormat
オブジェクトによって定義され、面にデータを格納するために、必要に応じてピクセル・フォーマットの変換が実行されます。pixelformat
は、適合するPixelFormat<IntBuffer>
タイプにする必要があります。(x, y)
の位置にある最初のピクセルのデータは、offset
パラメータで指定された配列インデックスから読み取られます。行のピクセル・データは、X座標の増加に対応するようにできるかぎり近接してまとめられた配列内の隣接する場所から読み取られます。隣接する行のピクセル・データは、scanlineStride
で定義されたint配列要素の数によって互いにオフセットされて読み取られます。x
- 書き込む矩形リージョンのX座標y
- 書き込む矩形リージョンのY座標w
- 書き込む矩形リージョンの幅h
- 書き込む矩形リージョンの高さpixelformat
- バッファからピクセルを読み取るためのintフォーマットを定義するPixelFormat<IntBuffer>
オブジェクトbuffer
- 格納するピクセル・データを含むint配列offset
- 最初のピクセル・データを読み取るためのbuffer
へのオフセットscanlineStride
- バッファ内のデータのある行の先頭のピクセル・データから、データの次の行の先頭までの距離NullPointerException
- @{code pixelformat}またはbuffer
がnull
の場合void setPixels(int dstx, int dsty, int w, int h, PixelReader reader, int srcx, int srcy)
PixelReader
インスタンスから取得されたピクセル・データを面の矩形リージョンに格納します。(dstx, dsty)
の面のピクセルのデータは、(srcx, srcy)
の位置のreader
から取得されます。このメソッドにより、この擬似コードと意味的に等しい(ただし、それより大幅に速い可能性がある)操作が実行されます。
for (int y = 0; y < h, y++) { for (int x = 0; x < w; x++) { setArgb(dstx + x, dsty + y, reader.getArgb(srcx + x, srcy + y)); } }
dstx
- 書き込む矩形リージョンのX座標dsty
- 書き込む矩形リージョンのY座標w
- 書き込む矩形リージョンの幅h
- 書き込む矩形リージョンの高さreader
- 書き込むピクセル・データの取得に使用されるPixelReader
srcx
- reader
から読み取られるデータのX座標srcy
- reader
から読み取られるデータのY座標NullPointerException
- @{code reader}がnull
である場合Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.