モジュール javafx.graphics
パッケージ javafx.scene.image

インタフェースPixelReader


  • public interface PixelReader
    このインタフェースでは、Imageまたはピクセルを含むその他の面からピクセル・データを取得するためのメソッドを定義します。
    導入されたバージョン:
    JavaFX 2.2
    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 抽象メソッド 
      修飾子と型 メソッド 説明
      int getArgb​(int x, int y)
      面の指定された座標から、ピクセルの色の32ビット整数表現を読み取ります。
      Color getColor​(int x, int y)
      面の指定された座標のピクセルの色を読み取り、値をColorとして返します。
      PixelFormat getPixelFormat()
      このメソッドは、面がそのピクセルを格納するPixelFormat、またはこのメソッドがそのピクセルを簡単に変換して出力できる、おおよそ同等の、読取りを目的としたピクセル・フォーマットを返します。
      void getPixels​(int x, int y, int w, int h, WritablePixelFormat<ByteBuffer> pixelformat, byte[] buffer, int offset, int scanlineStride)
      面の矩形リージョンから、指定されたバイト配列にピクセル・データを読み込みます。
      void getPixels​(int x, int y, int w, int h, WritablePixelFormat<IntBuffer> pixelformat, int[] buffer, int offset, int scanlineStride)
      面の矩形リージョンから、指定されたint配列にピクセル・データを読み込みます。
      <T extends Buffer>
      void
      getPixels​(int x, int y, int w, int h, WritablePixelFormat<T> pixelformat, T buffer, int scanlineStride)
      面の矩形リージョンから、指定されたバッファにピクセル・データを読み込みます。
    • メソッドの詳細

      • getPixelFormat

        PixelFormat getPixelFormat()
        このメソッドは、面がそのピクセルを格納するPixelFormat、またはこのメソッドがそのピクセルを簡単に変換して出力できる、おおよそ同等の、読取りを目的としたピクセル・フォーマットを返します。
        戻り値:
        基礎となるピクセルを最も適切に表すPixelFormat
      • getArgb

        int getArgb​(int x,
                    int y)
        面の指定された座標から、ピクセルの色の32ビット整数表現を読み取ります。 32ビット整数は、ARGBの最上位バイトから最下位バイトへの順序で、個別の8ビット・フィールドに4つの色成分を含みます。
        パラメータ:
        x - 読み取るピクセルの色のX座標
        y - 読み取るピクセルの色のY座標
        戻り値:
        INT_ARGBのPixelFormatタイプで記述されたフォーマットを使用した、色の32ビット表現。
      • getColor

        Color getColor​(int x,
                       int y)
        面の指定された座標のピクセルの色を読み取り、値をColorとして返します。
        パラメータ:
        x - 読み取るピクセルの色のX座標
        y - 読み取るピクセルの色のY座標
        戻り値:
        示されたピクセルの色を表すColorオブジェクト
      • getPixels

        <T extends Buffer> void getPixels​(int x,
                                          int y,
                                          int w,
                                          int h,
                                          WritablePixelFormat<T> pixelformat,
                                          T buffer,
                                          int scanlineStride)
        面の矩形リージョンから、指定されたバッファにピクセル・データを読み込みます。 バッファ内のピクセルに使用されるフォーマットはPixelFormatオブジェクトによって定義され、指定されたフォーマットでデータを格納するために、必要に応じてピクセル・フォーマットの変換が実行されます。 バッファの位置は、(x, y)の位置にあるイメージ・ピクセルからの最初のピクセル・データが格納される位置にあると想定されます。 行のピクセル・データは、X座標の増加に対応するようにできるかぎり近接してまとめられたバッファ内の隣接する場所に格納されます。 隣接する行のピクセル・データは、scanlineStrideで定義されたバッファ・データ要素の数によって互いにオフセットされて格納されます。
        型パラメータ:
        T - バッファの型
        パラメータ:
        x - 読み取る矩形リージョンのX座標
        y - 読み取る矩形リージョンのY座標
        w - 読み取る矩形リージョンの幅
        h - 読み取る矩形リージョンの高さ
        pixelformat - ピクセルをバッファに格納するためのフォーマットを定義するPixelFormatオブジェクト
        buffer - 指定されたPixelFormatオブジェクトに適切なタイプのバッファ
        scanlineStride - バッファ内のデータのある行の先頭のピクセル・データから、データの次の行の先頭までの距離。
      • getPixels

        void getPixels​(int x,
                       int y,
                       int w,
                       int h,
                       WritablePixelFormat<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 - バッファ内のデータのある行の先頭のピクセル・データから、データの次の行の先頭までの距離
      • getPixels

        void getPixels​(int x,
                       int y,
                       int w,
                       int h,
                       WritablePixelFormat<IntBuffer> pixelformat,
                       int[] buffer,
                       int offset,
                       int scanlineStride)
        面の矩形リージョンから、指定されたint配列にピクセル・データを読み込みます。 バッファ内のピクセルに使用されるフォーマットは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 - バッファ内のデータのある行の先頭のピクセル・データから、データの次の行の先頭までの距離