RescaleOp (Java Platform SE 8)

java.lang.Object
- java.awt.image.RescaleOp

すべての実装されたインタフェース:

BufferedImageOp, RasterOp
```
public class RescaleOp
extends Object
implements BufferedImageOp, RasterOp
```
このクラスでは、転送元イメージのデータのピクセル単位の再スケーリングを行います。各ピクセルのサンプル値とスケーリング係数の積を求め、オフセットを加算します。スケールされたサンプル値は、転送先のイメージで表示できる最小、最大値でクリップされます。
再スケーリング演算の仮想コードを次に示します。
```
for each pixel from Source object {
    for each band/component of the pixel {
        dstElement = (srcElement*scaleFactor) + offset
    }
}
 
```
Rasterの場合、再スケーリングはバンドを演算します。スケーリング定数セットが1つの場合は同じ定数がすべてのバンドに適用されます。スケーリング定数セットが複数の場合、その数は転送元Rasterのバンド数と一致しなければいけません。
BufferedImageの場合、再スケーリングは色とアルファ成分を演算します。スケーリング定数セットが1つの場合は同じ定数がすべての色成分に適用されますが、アルファ成分には適用されません。スケーリング定数セットが複数あり、その数が転送元の色成分数と一致する場合、アルファ成分が存在してもその再スケーリングは実行されません。スケーリング定数セットが複数あり、その数が転送元の色成分数とアルファ成分数の合計と一致する場合、ルックアップはすべての色成分およびアルファ成分に対して実行されます。
再スケーリングでは、あらかじめ乗算されたアルファ・データを持つBufferedImageソースは、あらかじめ乗算されていないアルファ・データ・イメージと同様に扱われます。つまり、データがあらかじめ乗算されていることを考慮せずに、BufferedImageソースのrawデータについて、バンドごとに再スケーリングが実行されます。転送先のColorModelで色の変換が必要な場合、このステップでは、あらかじめ乗算されていることが転送元と転送先の両方で考慮されます。
IndexColorModelを持つイメージは再スケーリングできません。
コンストラクタでRenderingHintsオブジェクトが指定された場合、色変換が必要なときに、カラー描画ヒントおよびディザリング・ヒントを使用できます。
インプレース操作(転送元と転送先に同じオブジェクトを指定すること)が許可されます。
関連項目:

RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

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

コンストラクタ
コンストラクタ	説明
`RescaleOp(float[] scaleFactors, float[] offsets, RenderingHints hints)`	必要なスケーリング係数とオフセットを持つ、新しいRescaleOpを構築します。
`RescaleOp(float scaleFactor, float offset, RenderingHints hints)`	必要なスケーリング係数とオフセットを持つ、新しいRescaleOpを構築します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`BufferedImage`	`createCompatibleDestImage(BufferedImage src, ColorModel destCM)`	適切なサイズおよびバンド数で、ゼロ化された転送先イメージを生成します。
`WritableRaster`	`createCompatibleDestRaster(Raster src)`	指定されたソースで、適切なサイズ、適切な数のバンドを持つゼロ化された転送先`Raster`を生成します。
`BufferedImage`	`filter(BufferedImage src, BufferedImage dst)`	転送元BufferedImageの再スケーリングを行います。
`WritableRaster`	`filter(Raster src, WritableRaster dst)`	転送元Rasterのピクセル・データの再スケーリングを行います。
`Rectangle2D`	`getBounds2D(BufferedImage src)`	再スケーリングされた転送先イメージのバウンディング・ボックスを返します。
`Rectangle2D`	`getBounds2D(Raster src)`	再スケーリングされた転送先Rasterのバウンディング・ボックスを返します。
`int`	`getNumFactors()`	このRescaleOpのスケーリング係数とオフセットを返します。
`float[]`	`getOffsets(float[] offsets)`	指定された配列のオフセットを返します。
`Point2D`	`getPoint2D(Point2D srcPt, Point2D dstPt)`	指定された転送元のポイントに対応する、転送先のポイントの位置を返します。
`RenderingHints`	`getRenderingHints()`	この操作の描画ヒントを返します。
`float[]`	`getScaleFactors(float[] scaleFactors)`	指定された配列のスケーリング係数を返します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - RescaleOp
```
public RescaleOp(float[] scaleFactors,
                 float[] offsets,
                 RenderingHints hints)
```
    必要なスケーリング係数とオフセットを持つ、新しいRescaleOpを構築します。 scaleFactorとoffset配列の長さは、上記のクラス・コメントの要件を満たすものである必要があります。 RenderingHints引数はnullでも構いません。
    
    パラメータ:
    
    scaleFactors - 指定されたスケーリング係数
    
    offsets - 指定されたオフセット
    
    hints - 指定されたRenderingHints、またはnull
  - RescaleOp
```
public RescaleOp(float scaleFactor,
                 float offset,
                 RenderingHints hints)
```
    必要なスケーリング係数とオフセットを持つ、新しいRescaleOpを構築します。 scaleFactorとoffsetは、転送元Rasterのすべてのバンド、BufferedImageのすべての色成分(アルファ成分は除く)に適用されます。 RenderingHints引数はnullでも構いません。
    
    パラメータ:
    
    scaleFactor - 指定されたスケーリング係数
    
    offset - 指定されたオフセット
    
    hints - 指定されたRenderingHints、またはnull
- メソッドの詳細
  - getScaleFactors
```
public final float[] getScaleFactors(float[] scaleFactors)
```
    指定された配列のスケーリング係数を返します。使いやすくするために配列も返すようになっています。 scaleFactorsがnullの場合、新しい配列が割り当てられます。
    
    パラメータ:
    
    scaleFactorsこのRescaleOpのスケーリング係数を含む配列
    
    戻り値:
    
    このRescaleOpのスケーリング係数。
  - getOffsets
```
public final float[] getOffsets(float[] offsets)
```
    指定された配列のオフセットを返します。使いやすくするために配列も返すようになっています。 offsetsがnullの場合、新しい配列が割り当てられます。
    
    パラメータ:
    
    offsetsこのRescaleOpのオフセットを含む配列
    
    戻り値:
    
    このRescaleOpのオフセット。
  - getNumFactors
```
public final int getNumFactors()
```
    このRescaleOpのスケーリング係数とオフセットを返します。
    
    戻り値:
    
    このRescaleOpのスケーリング係数とオフセットの数。
  - filter
```
public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dst)
```
    転送元BufferedImageの再スケーリングを行います。転送元イメージのカラー・モデルが転送先イメージのカラー・モデルと異なる場合、転送先でピクセルが変換されます。転送先のイメージがnullの場合、転送元のColorModelを使用してBufferedImageが生成されます。このオブジェクトのスケーリング係数およびオフセットの数が、上記のクラス・コメントの要件を満たさない場合、または転送元イメージがIndexColorModelを持つ場合、IllegalArgumentExceptionがスローされます。
    
    定義:
    
    filter、インタフェースBufferedImageOp
    
    パラメータ:
    
    src - フィルタ処理されるBufferedImage。
    
    dst - フィルタ処理対象の転送先またはnull
    
    戻り値:
    
    フィルタ処理されたBufferedImage。
    
    例外:
    
    IllegalArgumentException - srcのColorModelがIndexColorModelの場合、またはこのRescaleOpのスケーリング係数およびオフセットの数がクラス・コメントの要件を満たさない場合。
  - filter
```
public final WritableRaster filter(Raster src,
                                   WritableRaster dst)
```
    転送元Rasterのピクセル・データの再スケーリングを行います。転送先Rasterがnullの場合、新しいRasterが生成されます。転送元と転送先のバンドの数は一致しなければいけません。この要件を満たさない場合はIllegalArgumentExceptionがスローされます。このオブジェクトのスケーリング係数およびオフセットの数は、上記のクラス・コメントの要件を満たさなければいけません。この要件を満たさない場合はIllegalArgumentExceptionがスローされます。
    
    定義:
    
    filter、インタフェースRasterOp
    
    パラメータ:
    
    src - フィルタ処理されるRaster。
    
    dst - フィルタ処理対象の転送先またはnull
    
    戻り値:
    
    フィルタ処理されたWritableRaster。
    
    例外:
    
    IllegalArgumentException - srcとdstが同じバンド数を持っていない場合またはこのRescaleOpのスケーリング係数およびオフセットの数がクラス・コメントの要件を満たさない場合。
  - getBounds2D
```
public final Rectangle2D getBounds2D(BufferedImage src)
```
    再スケーリングされた転送先イメージのバウンディング・ボックスを返します。これは幾何学的な操作ではないので、バウンディング・ボックスは変化しません。
    
    定義:
    
    getBounds2D、インタフェースBufferedImageOp
    
    パラメータ:
    
    src - フィルタ処理されるBufferedImage。
    
    戻り値:
    
    転送先のイメージのバウンディング・ボックスを表すRectangle2D。
  - getBounds2D
```
public final Rectangle2D getBounds2D(Raster src)
```
    再スケーリングされた転送先Rasterのバウンディング・ボックスを返します。これは幾何学的な操作ではないので、バウンディング・ボックスは変化しません。
    
    定義:
    
    getBounds2D、インタフェースRasterOp
    
    パラメータ:
    
    src - 再スケーリングされた転送先のRaster
    
    戻り値:
    
    指定されたRasterの境界。
  - createCompatibleDestImage
```
public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)
```
    適切なサイズおよびバンド数で、ゼロ化された転送先イメージを生成します。
    
    定義:
    
    createCompatibleDestImage、インタフェースBufferedImageOp
    
    パラメータ:
    
    src - フィルタ・オペレーションのソース・イメージ。
    
    destCM - 転送先のColorModel。 nullの場合、ソースのColorModelを使用
    
    戻り値:
    
    ゼロ化された転送先イメージ。
  - createCompatibleDestRaster
```
public WritableRaster createCompatibleDestRaster(Raster src)
```
    指定されたソースで、適切なサイズ、適切な数のバンドを持つゼロ化された転送先Rasterを生成します。
    
    定義:
    
    createCompatibleDestRaster、インタフェースRasterOp
    
    パラメータ:
    
    src - 転送元Raster
    
    戻り値:
    
    ゼロ化された転送先Raster。
  - getPoint2D
```
public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)
```
    指定された転送元のポイントに対応する、転送先のポイントの位置を返します。 dstPtがnullでない場合は、戻り値の格納先として使用されます。幾何学的な操作ではないため、srcPtはdstPtと等しくなります。
    
    定義:
    
    getPoint2D、インタフェースBufferedImageOp
    
    定義:
    
    getPoint2D、インタフェースRasterOp
    
    パラメータ:
    
    srcPt - 転送元イメージのポイント
    
    dstPt - 転送先ポイント、またはnull
    
    戻り値:
    
    転送先ポイントの位置
  - getRenderingHints
```
public final RenderingHints getRenderingHints()
```
    この操作の描画ヒントを返します。
    
    定義:
    
    getRenderingHints、インタフェースBufferedImageOp
    
    定義:
    
    getRenderingHints、インタフェースRasterOp
    
    戻り値:
    
    このRescaleOpの描画ヒント。

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスRescaleOp

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

メソッドのサマリー

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

コンストラクタの詳細

RescaleOp

RescaleOp

メソッドの詳細

getScaleFactors

getOffsets

getNumFactors

filter

filter

getBounds2D

getBounds2D

createCompatibleDestImage

createCompatibleDestRaster

getPoint2D

getRenderingHints