java.awt.image
클래스 RescaleOp

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

모든 구현된 인터페이스:

BufferedImageOp , RasterOp

public class RescaleOp
extends Object 
implements BufferedImageOp , RasterOp 

이 클래스에서는, 전송원이미지의 데이터의 픽셀 단위의 재슬캘링을 실시합니다. 각 픽셀의 샘플치와 슬캘링 계수의 적을 요구해 오프셋(offset)를 가산합니다. 계산으로 요구된 샘플치는, 전송처 이미지의 최소 및 최대에 클립보드 전송 됩니다.

재슬캘링 연산의 가상 코드를 다음에 나타냅니다.

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 객체가 지정되었을 경우, 색변환이 필요한 때에, 칼라 draw 힌트 및 디저링 힌트를 사용할 수 있습니다.

인프레이스 조작 (전송원과 전송 먼저 같은 객체를 지정하는 것)이 허가됩니다.

관련 항목:

RenderingHints.KEY_COLOR_RENDERING , RenderingHints.KEY_DITHERING

생성자 의 개요

RescaleOp (float[] scaleFactors, float[] offsets, RenderingHints hints)
필요한 슬캘링 계수로 오프셋(offset)를 가지는, 새로운 RescaleOp 를 구축합니다.

RescaleOp (float scaleFactor, float offset, RenderingHints hints)
필요한 슬캘링 계수로 오프셋(offset)를 가지는, 새로운 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 의 슬캘링 계수로 오프셋(offset)를 돌려줍니다.
float[]	getOffsets (float[] offsets) 지정된 배열의 오프셋(offset)를 돌려줍니다.
Point2D	getPoint2D (Point2D srcPt, Point2D dstPt) 지정된 전송원의 포인트에 대응하는, 전송처의 포인트의 위치를 돌려줍니다.
RenderingHints	getRenderingHints () 이 조작의 draw 힌트를 돌려줍니다.
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)

필요한 슬캘링 계수로 오프셋(offset)를 가지는, 새로운 RescaleOp 를 구축합니다. scaleFactor와 offset 배열의 길이는, 상기의 클래스 설명의 요건을 채우는 것이 아니면 안됩니다. RenderingHints 인수는 null 에서도 상관하지 않습니다.

파라미터:

scaleFactors - 지정된 슬캘링 계수

offsets - 지정된 오프셋(offset)

hints - 지정된 RenderingHints, 또는 null

RescaleOp

public RescaleOp(float scaleFactor,
                 float offset,
                 RenderingHints  hints)

필요한 슬캘링 계수로 오프셋(offset)를 가지는, 새로운 RescaleOp 를 구축합니다. scaleFactor 와 offset 는, 전송원 Raster 의 모든 밴드, BufferedImage 의 모든 색성분 (알파 성분은 제외하다)에 적용됩니다. RenderingHints 인수는 null 에서도 상관하지 않습니다.

파라미터:

scaleFactor - 지정된 슬캘링 계수

offset - 지정된 오프셋(offset)

hints - 지정된 RenderingHints, 또는 null

메소드의 상세

getScaleFactors

public final float[] getScaleFactors(float[] scaleFactors)

지정된 배열의 슬캘링 계수를 돌려줍니다. 사용하기 쉽게 하기 위해서 배열도 돌려주게 되어 있습니다. scaleFactors 가 null 의 경우, 새로운 배열을 할당할 수 있습니다.

파라미터:

scaleFactors - 이 RescaleOp 의 슬캘링 계수를 포함한 배열

반환값:

이 RescaleOp 의 슬캘링 계수

getOffsets

public final float[] getOffsets(float[] offsets)

지정된 배열의 오프셋(offset)를 돌려줍니다. 사용하기 쉽게 하기 위해서 배열도 돌려주게 되어 있습니다. offsets 가 null 의 경우, 새로운 배열을 할당할 수 있습니다.

파라미터:

offsets - 이 RescaleOp 의 오프셋(offset)를 포함한 배열

반환값:

이 RescaleOp 의 오프셋(offset)

getNumFactors

public final int getNumFactors()

이 RescaleOp 의 슬캘링 계수로 오프셋(offset)를 돌려줍니다.

반환값:

이 RescaleOp 의 슬캘링 계수와 오프셋(offset)의 수

filter

public final BufferedImage  filter(BufferedImage  src,
                                  BufferedImage  dst)

전송원 BufferedImage 의 재슬캘링을 실시합니다. 전송원이미지의 칼라 모델이 전송처 이미지의 칼라 모델과 다른 경우, 전송처에서 픽셀이 변환됩니다. 전송처의 이미지가 null 의 경우, 전송원의 ColorModel 을 사용해 BufferedImage 가 생성됩니다. 이 객체의 슬캘링 계수 및 오프셋(offset)의 수가, 상기의 클래스 설명의 요건을 채우지 않는 경우, 또는 전송원이미지가 IndexColorModel 를 가지는 경우, IllegalArgumentException 가 throw 됩니다.

정의:

인터페이스 BufferedImageOp 내의 filter

파라미터:

src - 필터 처리되는 BufferedImage

dst - 필터 처리 대상의 전송처, 또는 null

반환값:

필터 처리된 BufferedImage

예외:

IllegalArgumentException - src 의 ColorModel 가 IndexColorModel 의 경우, 또는 이 RescaleOp 의 슬캘링 계수 및 오프셋(offset)의 수가 클래스 설명의 요건을 채우지 않는 경우

filter

public final WritableRaster  filter(Raster  src,
                                   WritableRaster  dst)

전송원 Raster 의 픽셀 데이터의 재슬캘링을 실시합니다. 전송처 Raster 가 null 의 경우, 새로운 Raster 가 생성됩니다. 전송원과 전송처의 밴드의 수는 일치하지 않으면 안됩니다. 이 요건을 채우지 않는 경우는 IllegalArgumentException 가 throw 됩니다. 이 객체의 슬캘링 계수 및 오프셋(offset)의 수는, 상기의 클래스 설명의 요건을 채우지 않으면 안됩니다. 이 요건을 채우지 않는 경우는 IllegalArgumentException 가 throw 됩니다.

정의:

인터페이스 RasterOp 내의 filter

파라미터:

src - 필터 처리되는 Raster

dst - 필터 처리 대상의 전송처, 또는 null

반환값:

필터 처리된 WritableRaster

예외:

IllegalArgumentException - src 와 dst 가 같은 밴드수를 가지고 있지 않은 경우 또는 이 RescaleOp 의 슬캘링 계수 및 오프셋(offset)의 수가 클래스 설명의 요건을 채우지 않는 경우

getBounds2D

public final Rectangle2D  getBounds2D(BufferedImage  src)

재슬캘링 된 전송처 이미지의 바운딩 박스를 돌려줍니다. 이것은 기하학적인 조작은 아니기 때문에, 바운딩 박스는 변화하지 않습니다.

정의:

인터페이스 BufferedImageOp 내의 getBounds2D

파라미터:

src - 필터 처리되는 BufferedImage

반환값:

전송처 이미지의 바운딩 박스를 나타낸다 Rectangle2D

getBounds2D

public final Rectangle2D  getBounds2D(Raster  src)

재슬캘링 된 전송처 Raster 의 바운딩 박스를 돌려줍니다. 이것은 기하학적인 조작은 아니기 때문에, 바운딩 박스는 변화하지 않습니다.

정의:

인터페이스 RasterOp 내의 getBounds2D

파라미터:

src - 재슬캘링 된 전송처의 Raster

반환값:

지정된 Raster 의 경계

createCompatibleDestImage

public BufferedImage  createCompatibleDestImage(BufferedImage  src,
                                               ColorModel  destCM)

적절한 사이즈 및 밴드수로, 제로화 된 전송처 이미지를 생성합니다.

정의:

인터페이스 BufferedImageOp 내의 createCompatibleDestImage

파라미터:

src - 필터 오퍼레이션의 소스 이미지

destCM - 전송처의 ColorModel. null 의 경우, 소스의 ColorModel 를 사용

반환값:

제로화 된 전송처 이미지

createCompatibleDestRaster

public WritableRaster  createCompatibleDestRaster(Raster  src)

지정된 소스로, 적절한 사이즈, 적절한 수의 밴드를 가지는 제로화 된 전송처 Raster 를 생성합니다.

정의:

인터페이스 RasterOp 내의 createCompatibleDestRaster

파라미터:

src - 전송원의 Raster

반환값:

제로화 된 전송처의 Raster

getPoint2D

public final Point2D  getPoint2D(Point2D  srcPt,
                                Point2D  dstPt)

지정된 전송원의 포인트에 대응하는, 전송처의 포인트의 위치를 돌려줍니다. dstPt 가 null 가 아닌 경우는, 반환값의 포함처로서 사용됩니다. 기하학적인 조작은 아니기 때문에, srcPt 는 dstPt 와 동일해집니다.

정의:

인터페이스 BufferedImageOp 내의 getPoint2D

정의:

인터페이스 RasterOp 내의 getPoint2D

파라미터:

srcPt - 전송원이미지의 포인트

dstPt - 전송처 포인트, 또는 null

반환값:

전송처 포인트의 위치

getRenderingHints

public final RenderingHints  getRenderingHints()

이 조작의 draw 힌트를 돌려줍니다.

정의:

인터페이스 BufferedImageOp 내의 getRenderingHints

정의:

인터페이스 RasterOp 내의 getRenderingHints

반환값:

이 RescaleOp 의 draw 힌트