java.awt.image
클래스 RGBImageFilter

java.lang.Object 
  java.awt.image.ImageFilter 
      java.awt.image.RGBImageFilter

모든 구현된 인터페이스:

ImageConsumer, Cloneable

알려진 직계 서브 클래스:

GrayFilter

public abstract class RGBImageFilter
extends ImageFilter 

이 클래스는 디폴트 RGB ColorModel 이미지의 픽셀을 수정하는 ImageFilter를 용이하게 작성하기 위한 방법을 제공합니다. 또, FilteredImageSource와 조합해, 기존 이미지의 필터 처리에 사용됩니다. 이 클래스는 1개의 메서드를 통해 모든 픽셀 데이터를 변환하기 위한 호출을 제공하는 추상 클래스입니다. 이 메서드는 ImageProducer 로 사용되고 있는 ColorModel에 관계없이, 디폴트의 RGB ColorModel 로 픽셀을 한 번으로 변환합니다. 사용할 수 있는 이미지 필터를 작성하기 위해서 정의할 필요가 있는 것은 filterRGB 메서드 뿐입니다. 이하에 이미지의 적색 성분과 청색 성분을 교환하는 필터 정의의 예를 나타냅니다.

        class RedBlueSwapFilter extends RGBImageFilter {
            public RedBlueSwapFilter() {
                // The filter's operation does not depend on the
                // pixel's location, so IndexColorModels can be
                // filtered directly.
                canFilterIndexColorModel = true;
            }

            public int filterRGB(int x, int y, int rgb) {
                return ((rgb & 0xff00ff00)
                        | ((rgb & 0xff0000) >> 16)
                        | ((rgb & 0xff) << 16));
            }
        }

 

관련 항목:

FilteredImageSource, ImageFilter, ColorModel.getRGBdefault()

필드 개요

protected boolean	canFilterIndexColorModel 이 boolean 형은 IndexColorModel 객체의 컬러 테이블 엔트리에 대해서 filterRGB 메서드의 컬러 필터 처리를, 픽셀 단위의 필터 처리 대신에 사용할 수 있을지 어떨지를 나타냅니다.
protected ColorModel	newmodel 사용자가 substituteColorModel을 호출했을 때에 origmodel를 옮겨놓는 ColorModel 입니다.
protected ColorModel	origmodel 사용자가 substituteColorModel를 호출했을 때에 newmodel에 의해 옮겨놓을 수 있는 ColorModel 입니다.

클래스 java.awt.image. ImageFilter 로부터 상속된 필드

consumer

인터페이스 java.awt.image. ImageConsumer 로부터 상속된 필드

COMPLETESCANLINES, IMAGEABORTED, IMAGEERROR, RANDOMPIXELORDER, SINGLEFRAME, SINGLEFRAMEDONE, SINGLEPASS, STATICIMAGEDONE, TOPDOWNLEFTRIGHT

생성자 개요

RGBImageFilter ()

메서드 개요

IndexColorModel	filterIndexColorModel (IndexColorModel icm) IndexColorModel 객체를 필터 처리합니다.
abstract int	filterRGB (int x, int y, int rgb) 서브 클래스는 디폴트의 RGB ColorModel 1개의 입력 픽셀을 1개의 출력 픽셀로 변환하는 메서드를 지정하지 않으면 안됩니다.
void	filterRGBPixels (int x, int y, int w, int h, int[] pixels, int off, int scansize) 디폴트의 RGB ColorModel 픽셀 버퍼를 필터 처리합니다.
void	setColorModel (ColorModel model) ColorModel가 IndexColorModel 로 서브 클래스가 canFilterIndexColorModel 플래그를 true 로 설정했을 경우는 원의 ColorModel 객체가 setPixels 메서드로 호출되는 곳은 어디에서라도, 필터 처리된 컬러 모델에 옮겨놓습니다.
void	setPixels (int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize) ColorModel 객체가 이미 변환된 객체와 같은 경우, 변환된 ColorModel를 사용해 단순하게 픽셀을 건네줍니다.
void	setPixels (int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize) ColorModel 객체가 이미 변환된 객체와 같은 경우, 변환된 ColorModel를 사용해 단순하게 픽셀을 건네줍니다.
void	substituteColorModel (ColorModel oldcm, ColorModel newcm) 치환용의 2개의 ColorModel 객체를 등록합니다.

클래스 java.awt.image. ImageFilter 로부터 상속된 메서드

clone, getFilterInstance, imageComplete, resendTopDownLeftRight, setDimensions, setHints, setProperties

클래스 java.lang. Object 로부터 상속된 메서드

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

origmodel

protected ColorModel  origmodel

사용자가 substituteColorModel를 호출했을 때에 newmodel에 의해 옮겨놓을 수 있는 ColorModel 입니다.

newmodel

protected ColorModel  newmodel

사용자가 substituteColorModel을 호출했을 때에 origmodel를 옮겨놓는 ColorModel 입니다.

canFilterIndexColorModel

protected boolean canFilterIndexColorModel

이 boolean 형은 IndexColorModel 객체의 컬러 테이블 엔트리에 대해서 filterRGB 메서드의 컬러 필터 처리를, 픽셀 단위의 필터 처리 대신에 사용할 수 있을지 어떨지를 나타냅니다. filterRGB 메서드가 필터 처리를 실시하는 픽셀의 좌표에 존하지 않는 경우, 서브 클래스는 이 변수를 생성자 으로 true 로 설정하지 않으면 안됩니다.

관련 항목:

substituteColorModel(java.awt.image.ColorModel, java.awt.image.ColorModel), filterRGB(int, int, int), IndexColorModel

생성자 상세

RGBImageFilter

public RGBImageFilter()

메서드의 상세

setColorModel

public void setColorModel(ColorModel  model)

ColorModel가 IndexColorModel 로 서브 클래스가 canFilterIndexColorModel 플래그를 true 로 설정했을 경우는 원의 ColorModel 객체가 setPixels 메서드로 호출되는 곳은 어디에서라도, 필터 처리된 컬러 모델에 옮겨놓습니다. ColorModel가 IndexColorModel 또는 null인 경우, 이 메서드는 ImageProducer가 사용하는 디폴트의 ColorModel를 오버라이드(override) 해, 디폴트의 RGB ColorModel를 대신에 지정합니다.

주: 이 메서드는 필터 처리의 대상이 되는 픽셀로 구성되는 Image ImageProducer에 의해 호출되는 것을 상정해 구현되고 있습니다. 이 클래스를 사용해 이미지의 픽셀을 필터 처리하는 개발자는 이 메서드를 직접 호출하지 말아 주세요. 이 메서드를 직접 호출하면, 필터 조작을 방해할 가능성이 있습니다.

정의:

인터페이스 ImageConsumer 내의 setColorModel

오버라이드(override):

클래스 ImageFilter 내의 setColorModel

파라미터:

model - 지정된 ColorModel

관련 항목:

ImageConsumer, ColorModel.getRGBdefault()

substituteColorModel

public void substituteColorModel(ColorModel  oldcm,
                                 ColorModel  newcm)

치환용의 2개의 ColorModel 객체를 등록합니다. setPixels 메서드로 oldcm가 검출되었을 경우는 newcm 로 옮겨져 픽셀은 새로운 ColorModel 객체를 사용해 그대로 건네받습니다.

파라미터:

oldcm - 처리중으로 옮겨지는 ColorModel 객체

newcm - 처리중에 oldcm를 옮겨놓는 ColorModel 객체

filterIndexColorModel

public IndexColorModel  filterIndexColorModel(IndexColorModel  icm)

IndexColorModel 객체를 필터 처리합니다. RGBImageFilter 서브 클래스가 제공하는 filterRGB 기능에의해 객체의 컬러 테이블의 각 엔트리를 처리합니다. -1 좌표는 컬러 테이블 엔트리가 필터 처리되고 있는 것을 나타냅니다만, 이것은 실제의 픽셀값이 아닙니다.

파라미터:

icm - 필터 처리되는 IndexColorModel 객체

반환값:

필터 처리된 색을 나타내는 새로운 IndexColorModel

예외:

NullPointerException - icm가 null인 경우

filterRGBPixels

public void filterRGBPixels(int x,
                            int y,
                            int w,
                            int h,
                            int[] pixels,
                            int off,
                            int scansize)

디폴트의 RGB ColorModel 픽셀 버퍼를 필터 처리합니다. filterRGB 메서드로 1개 씩 건네받아 처리됩니다.

파라미터:

x, y - 픽셀 영역의 좌상구석의 좌표

w - 픽셀 영역의 폭

h - 픽셀 영역의 높이

pixels - 픽셀의 배열

off - pixels 배열의 오프셋(offset)

scansize - 배열상에서의 픽셀의 1 열의 크기

관련 항목:

ColorModel.getRGBdefault(), filterRGB(int, int, int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel  model,
                      byte[] pixels,
                      int off,
                      int scansize)

ColorModel 객체가 이미 변환된 객체와 같은 경우, 변환된 ColorModel를 사용해 단순하게 픽셀을 건네줍니다. 그렇지 않은 경우, byte 픽셀의 버퍼를 디폴트의 RGB ColorModel 로 변환해, 변환된 버퍼를 filterRGBPixels 메서드에 건네주어, 1개 씩 변환합니다.

주: 이 메서드는 필터 처리의 대상이 되는 픽셀로 구성되는 Image ImageProducer에 의해 호출되는 것을 상정해 구현되고 있습니다. 이 클래스를 사용해 이미지의 픽셀을 필터 처리하는 개발자는 이 메서드를 직접 호출하지 말아 주세요. 이 메서드를 직접 호출하면, 필터 조작을 방해할 가능성이 있습니다.

정의:

인터페이스 ImageConsumer 내의 setPixels

오버라이드(override):

클래스 ImageFilter 내의 setPixels

w - 픽셀 영역의 폭

h - 픽셀 영역의 높이

model - 지정된 ColorModel

pixels - 픽셀의 배열

off - pixels 배열의 오프셋(offset)

scansize - pixels 배열내의, 어느 픽셀행으로부터 다음의 픽셀행까지의 거리

관련 항목:

ColorModel.getRGBdefault(), filterRGBPixels(int, int, int, int, int[], int, int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel  model,
                      int[] pixels,
                      int off,
                      int scansize)

ColorModel 객체가 이미 변환된 객체와 같은 경우, 변환된 ColorModel를 사용해 단순하게 픽셀을 건네줍니다. 그렇지 않은 경우, int 픽셀의 버퍼를 디폴트의 RGB ColorModel 로 변환해, 변환된 버퍼를 filterRGBPixels 메서드에 건네주어, 1개 씩 변환합니다. int 픽셀의 버퍼를 디폴트의 RGB ColorModel 로 변환해, 변환된 버퍼를 filterRGBPixels 메서드에 건네줍니다.

주: 이 메서드는 필터 처리의 대상이 되는 픽셀로 구성되는 Image ImageProducer에 의해 호출되는 것을 상정해 구현되고 있습니다. 이 클래스를 사용해 이미지의 픽셀을 필터 처리하는 개발자는 이 메서드를 직접 호출하지 말아 주세요. 이 메서드를 직접 호출하면, 필터 조작을 방해할 가능성이 있습니다.

정의:

인터페이스 ImageConsumer 내의 setPixels

오버라이드(override):

클래스 ImageFilter 내의 setPixels

w - 픽셀 영역의 폭

h - 픽셀 영역의 높이

model - 지정된 ColorModel

pixels - 픽셀의 배열

off - pixels 배열의 오프셋(offset)

scansize - pixels 배열내의, 어느 픽셀행으로부터 다음의 픽셀행까지의 거리

관련 항목:

ColorModel.getRGBdefault(), filterRGBPixels(int, int, int, int, int[], int, int)

filterRGB

public abstract int filterRGB(int x,
                              int y,
                              int rgb)

서브 클래스는 디폴트의 RGB ColorModel 1개의 입력 픽셀을 1개의 출력 픽셀로 변환하는 메서드를 지정하지 않으면 안됩니다.

파라미터:

x, y - 픽셀의 좌표

rgb - 디폴트 RGB 컬러 모델의 정수형 픽셀 표현

반환값:

디폴트 RGB 컬러 모델의 필터 처리된 픽셀

관련 항목:

ColorModel.getRGBdefault(), filterRGBPixels(int, int, int, int, int[], int, int)