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

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

관련 항목:

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 () 이 조작의 렌더링 힌트를 리턴합니다.
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가 발생 됩니다.

정의:

인터페이스 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가 발생 됩니다. 이 객체의 슬캘링 계수 및 오프셋(offset)의 수는 상기의 클래스 설명의 요건을 채우지 않으면 안됩니다. 이 요건을 채우지 않는 경우는 IllegalArgumentException가 발생 됩니다.

정의:

인터페이스 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()

이 조작의 렌더링 힌트를 리턴합니다.

정의:

인터페이스 BufferedImageOp 내의 getRenderingHints

정의:

인터페이스 RasterOp 내의 getRenderingHints

반환값:

이 RescaleOp 렌더링 힌트