JavaTM Platform
Standard Ed. 6

java.awt.image
クラス AreaAveragingScaleFilter

java.lang.Object
  上位を拡張 java.awt.image.ImageFilter
      上位を拡張 java.awt.image.ReplicateScaleFilter
          上位を拡張 java.awt.image.AreaAveragingScaleFilter
すべての実装されたインタフェース:
ImageConsumer, Cloneable

public class AreaAveragingScaleFilter
extends ReplicateScaleFilter

最近接点アルゴリズムよりもなめらかな結果が得られる、簡単な領域平均化アルゴリズムを使用してイメージをスケーリングする ImageFilter クラスです。  

このクラスでは基底の ImageFilter クラスを拡張して、既存のイメージのサイズを変更し、類似のイメージを新しく作成するときの転送元を提供します。転送元イメージのピクセルは合成されて、指定されたサイズのイメージ用ピクセルを作成します。合成処理は、ピクセル複製により転送先イメージの数倍のサイズに拡大された転送元イメージについて、拡大イメージの中で、転送先イメージの各ピクセルとなるすべてのピクセルの平均をとることにより、転送先イメージのサイズに再び縮小する処理に似ています。転送元からのデータが TopDownLeftRight (上下左右) 順に送られない場合は、単純なピクセル複製動作に戻り、requestTopDownLeftRightResend() メソッドを利用して、最終的により良い方法でピクセルを再びフィルタリングします。  

これは、既存のイメージからスケーリングされたバージョンを作成するために FilteredImageSource とともに使用することを意図しています。実装の依存関係のため、プラットフォームによってフィルタされるイメージのピクセル値が異なることがあります。

関連項目:
FilteredImageSource, ReplicateScaleFilter, ImageFilter

フィールドの概要
 
クラス java.awt.image.ReplicateScaleFilter から継承されたフィールド
destHeight, destWidth, outpixbuf, srccols, srcHeight, srcrows, srcWidth
 
クラス java.awt.image.ImageFilter から継承されたフィールド
consumer
 
インタフェース java.awt.image.ImageConsumer から継承されたフィールド
COMPLETESCANLINES, IMAGEABORTED, IMAGEERROR, RANDOMPIXELORDER, SINGLEFRAME, SINGLEFRAMEDONE, SINGLEPASS, STATICIMAGEDONE, TOPDOWNLEFTRIGHT
 
コンストラクタの概要
AreaAveragingScaleFilter(int width, int height)
          幅と高さのパラメータの指定に従って、転送元イメージのピクセルをスケーリングする AreaAveragingScaleFilter を構築します。
 
メソッドの概要
 void setHints(int hints)
          渡されるデータに、平均化アルゴリズムの動作に必要なヒントが設定されているかどうかを検出します。
 void setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)
          このメソッドを直接呼び出すと、フィルタ操作を妨げる可能性があります。
 void setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)
          渡された int ピクセル用のコンポーネントすべてを蓄積配列にまとめて、完全なピクセル行のための平均化されたデータをすべて送出します。
 
クラス java.awt.image.ReplicateScaleFilter から継承されたメソッド
setDimensions, setProperties
 
クラス java.awt.image.ImageFilter から継承されたメソッド
clone, getFilterInstance, imageComplete, resendTopDownLeftRight, setColorModel
 
クラス java.lang.Object から継承されたメソッド
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

AreaAveragingScaleFilter

public AreaAveragingScaleFilter(int width,
                                int height)
幅と高さのパラメータの指定に従って、転送元イメージのピクセルをスケーリングする AreaAveragingScaleFilter を構築します。

パラメータ:
width - イメージをスケーリングするターゲットの幅
height - イメージをスケーリングするターゲットの高さ
メソッドの詳細

setHints

public void setHints(int hints)
渡されるデータに、平均化アルゴリズムの動作に必要なヒントが設定されているかどうかを検出します。  

注:このメソッドは、フィルタ処理の対象となるピクセルで構成される ImageImageProducer によって呼び出されることを想定して実装されています。このクラスを使用してイメージのピクセルをフィルタ処理する開発者は、このメソッドを直接呼び出さないでください。 このメソッドを直接呼び出すと、フィルタ操作を妨げる可能性があります。

定義:
インタフェース ImageConsumer 内の setHints
オーバーライド:
クラス ImageFilter 内の setHints
パラメータ:
hints - ImageConsumer がピクセル処理に使用する ヒントのセット
関連項目:
ImageConsumer.setHints(int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      byte[] pixels,
                      int off,
                      int scansize)
このメソッドを直接呼び出すと、フィルタ操作を妨げる可能性があります。 渡されたバイトピクセル用のコンポーネントすべてを蓄積配列にまとめて、完全なピクセル行のための平均化データをすべて送出します。setHints の呼び出しで正しいヒントが指定されなかった場合は、送るヒントにかかわらずピクセルをスケーリングできるスーパークラスに作業を引き継ぎます。  

注:このメソッドは、フィルタ処理の対象となるピクセルで構成される ImageImageProducer によって呼び出されることを想定して実装されています。このクラスを使用してイメージのピクセルをフィルタ処理する開発者は、このメソッドを直接呼び出さないでください。 このメソッドを直接呼び出すと、フィルタ操作を妨げる可能性があります。

定義:
インタフェース ImageConsumer 内の setPixels
オーバーライド:
クラス ReplicateScaleFilter 内の setPixels
パラメータ:
x - 設定されるピクセル領域の 左上隅の X 座標
y - 設定されるピクセル領域の 左上隅の Y 座標
w - ピクセル領域の幅
h - ピクセル領域の高さ
model - 指定された ColorModel
pixels - ピクセルの配列
off - pixels 配列のオフセット
scansize - pixels 配列内の あるピクセル行から次のピクセル行までの距離
関連項目:
ReplicateScaleFilter

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      int[] pixels,
                      int off,
                      int scansize)
渡された int ピクセル用のコンポーネントすべてを蓄積配列にまとめて、完全なピクセル行のための平均化されたデータをすべて送出します。setHints の呼び出しで正しいヒントが指定されなかった場合は、送るヒントにかかわらずピクセルをスケーリングできるスーパークラスに作業を引き継ぎます。  

注:このメソッドは、フィルタ処理の対象となるピクセルで構成される ImageImageProducer によって呼び出されることを想定して実装されています。このクラスを使用してイメージのピクセルをフィルタ処理する開発者は、このメソッドを直接呼び出さないでください。 このメソッドを直接呼び出すと、フィルタ操作を妨げる可能性があります。

定義:
インタフェース ImageConsumer 内の setPixels
オーバーライド:
クラス ReplicateScaleFilter 内の setPixels
パラメータ:
x - 設定されるピクセル領域の 左上隅の X 座標
y - 設定されるピクセル領域の 左上隅の Y 座標
w - ピクセル領域の幅
h - ピクセル領域の高さ
model - 指定された ColorModel
pixels - ピクセルの配列
off - pixels 配列のオフセット
scansize - pixels 配列内の あるピクセル行から次のピクセル行までの距離
関連項目:
ReplicateScaleFilter

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。