javax.imageio
클래스 IIOParam

java.lang.Object 
  javax.imageio.IIOParam

알려진 직계 서브 클래스:

ImageReadParam, ImageWriteParam

public abstract class IIOParam
extends Object 

스트림을 디코드 또는 encode 하는 방법을 기술하는 모든 클래스의 슈퍼 클래스입니다. 이 클래스는 ImageReadParam와 ImageWriteParam로 공유되는 모든 변수와 메서드를 보관 유지합니다.

이 클래스는 소스 영역 및 목적지 영역을 지정하는 도구를 제공합니다. read시에는 소스가 스트림이 되어, 메모리내 이미지가 목적지가 됩니다. 출력시에는 그 거꾸로 됩니다. 출력의 경우, 목적지 영역은 픽셀의 치환을 지원하는 라이터인 만큼 사용됩니다.

솎아냄 서브 샘플링은 이동 가능한 서브 샘플링 구라두를 사용해 리더와 라이터의 양쪽 모두로 지정됩니다.

소스와 목적지 밴드의 부분집합을 선택할 수 있습니다.

필드 개요

protected IIOParamController	controller activateController 메서드가 불려 갔을 때에 이 IIOParam 객체의 설정을 제공하기 위해서 사용하는 IIOParamController 입니다.
protected IIOParamController	defaultController activateController 메서드가 불려 갔을 때에 이 IIOParam 객체의 설정을 제공하기 위해서 사용하는 디폴트의 IIOParamController 입니다.
protected Point	destinationOffset 좌상구석의 디코드된 픽셀이 배치되는 목적지의 오프셋(offset)입니다.
protected ImageTypeSpecifier	destinationType read시에 목적지의 이미지를 생성한다, 또는 write에 출력의 컬러 타입을 설정하기 위해서 사용하는 ImageTypeSpecifier 입니다.
protected int[]	sourceBands 사용하는 소스 밴드를 나타내는 int 배열, 또는 null 입니다.
protected Rectangle	sourceRegion 소스 영역, 또는 아무것도 설정되지 않는 경우는 null와 리.
protected int	sourceXSubsampling 수평 방향으로 적용되는 솎아냄 서브 샘플링입니다.
protected int	sourceYSubsampling 수직 방향으로 적용되는 솎아냄 서브 샘플링입니다.
protected int	subsamplingXOffset 서브 샘플링 하기 전에 서브 샘플링 구라두에 적용되는 수평 방향의 오프셋(offset)입니다.
protected int	subsamplingYOffset 서브 샘플링 하기 전에 서브 샘플링 구라두에 적용되는 수직 방향의 오프셋(offset)입니다.

생성자 개요

protected

IIOParam () protected 생성자는 서브 클래스에 해서만 호출합니다.

메서드 개요

boolean	activateController () 이 IIOParam 객체에 인스톨 된 IIOParamController를 시작해, 결과의 값을 리턴합니다.
IIOParamController	getController () IIOParamController가 현재 인스톨 되고 있는 것은 뭐든지 리턴합니다.
IIOParamController	getDefaultController () 디폴트의 IIOParamController가 있는 경우는 현재 인스톨 되고 있는 콘트롤러와는 관계없이, 이것을 리턴합니다.
Point	getDestinationOffset () 픽셀이 배치되는 목적지 이미지의 오프셋(offset)를 리턴합니다.
ImageTypeSpecifier	getDestinationType () ImageTypeSpecifier로 서setDestination(ImageTypeSpecifier) 호출에 의해 설정되었을 경우, read에 의해 리턴된 이미지의 타입을 리턴합니다.
int[]	getSourceBands () 사용하는 소스 밴드세트를 리턴합니다.
Rectangle	getSourceRegion () 사용하는 소스 영역을 리턴합니다.
int	getSourceXSubsampling () 픽셀 마다 떠오르는 소스열의 수를 리턴합니다.
int	getSourceYSubsampling () 픽셀 마다 떠오르는 소스행의 수를 리턴합니다.
int	getSubsamplingXOffset () 서브 샘플링 구라두의 수평 방향의 오프셋(offset)를 리턴합니다.
int	getSubsamplingYOffset () 서브 샘플링 구라두의 수직 방향의 오프셋(offset)를 리턴합니다.
boolean	hasController () 이 IIOParam 객체에 인스톨 된 콘트롤러가 있는 경우는 true를 리턴합니다.
void	setController (IIOParamController controller) activateController 메서드가 불려 갔을 때에 디폴트 콘트롤러를 오버라이드(override) 해, 이 IIOParam 객체의 설정을 제공하기 위해서 사용하는 IIOParamController를 설정합니다.
void	setDestinationOffset (Point destinationOffset) read시의 경우는 장래 디코드되는 픽셀이 배치되는 오프셋(offset), 출력시의 경우는 영역이 출력해지는 오프셋(offset)를 목적지 이미지로 지정합니다.
void	setDestinationType (ImageTypeSpecifier destinationType) ImageTypeSpecifier를 사용해, 이용하고 싶은 이미지 형식을 목적지 이미지로 설정합니다.
void	setSourceBands (int[] sourceBands) 사용하는 소스 밴드의 인덱스를 설정합니다.
void	setSourceRegion (Rectangle sourceRegion) 처리 대상의 소스 영역을 설정합니다.
void	setSourceSubsampling (int sourceXSubsampling, int sourceYSubsampling, int subsamplingXOffset, int subsamplingYOffset) 솎아냄 서브 샘플링을 지정해 입출력에 적용합니다.

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

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

필드의 상세

sourceRegion

protected Rectangle  sourceRegion

소스 영역, 또는 아무것도 설정되지 않는 경우는 null와 리.

sourceXSubsampling

protected int sourceXSubsampling

수평 방향으로 적용되는 솎아냄 서브 샘플링입니다. 디폴트의 값은 1 입니다. 값은 반드시 정말로의해 주세요.

sourceYSubsampling

protected int sourceYSubsampling

수직 방향으로 적용되는 솎아냄 서브 샘플링입니다. 디폴트의 값은 1 입니다. 값은 반드시 정말로의해 주세요.

subsamplingXOffset

protected int subsamplingXOffset

서브 샘플링 하기 전에 서브 샘플링 구라두에 적용되는 수평 방향의 오프셋(offset)입니다. 최초로 사용하는 픽셀은 영역의 원점으로부터, 영역이 지정되지 않는 경우는 이미지로부터 이 양이 오프셋(offset) 됩니다.

subsamplingYOffset

protected int subsamplingYOffset

서브 샘플링 하기 전에 서브 샘플링 구라두에 적용되는 수직 방향의 오프셋(offset)입니다. 최초로 사용하는 픽셀은 영역의 원점으로부터, 영역이 지정되지 않는 경우는 이미지로부터 이 양이 오프셋(offset) 됩니다.

sourceBands

protected int[] sourceBands

사용하는 소스 밴드를 나타내는 int 배열, 또는 null 입니다. null인 경우, 사용하는 소스 밴드세트는 setSourceBands 메서드의 코멘트에 기술되고 있는 대로입니다. 잘못된 값은 사용할 수 없습니다.

destinationType

protected ImageTypeSpecifier  destinationType

read시에 목적지의 이미지를 생성한다, 또는 write에 출력의 컬러 타입을 설정하기 위해서 사용하는 ImageTypeSpecifier 입니다. 아무것도 설정되어 있지 않은 경우, 값은 null이 됩니다. 디폴트의 값은 null 입니다.

destinationOffset

protected Point  destinationOffset

좌상구석의 디코드된 픽셀이 배치되는 목적지의 오프셋(offset)입니다. 디폴트의 값은 (0, 0)입니다.

defaultController

protected IIOParamController  defaultController

activateController 메서드가 불려 갔을 때에 이 IIOParam 객체의 설정을 제공하기 위해서 사용하는 디폴트의 IIOParamController 입니다. 이 디폴트는 서브 클래스에서 설정합니다. 서브 클래스는 그 자체의 파라미터 설정용의 디폴트 콘트롤러 (일반적으로 GUI)를 제공합니다.

관련 항목:

IIOParamController, getDefaultController(), activateController()

controller

protected IIOParamController  controller

activateController 메서드가 불려 갔을 때에 이 IIOParam 객체의 설정을 제공하기 위해서 사용하는 IIOParamController 입니다. 이 값은 null인 경우를 포함한 모든 디폴트 콘트롤러를 오버라이드(override) 합니다.

관련 항목:

IIOParamController, setController(IIOParamController), hasController(), activateController()

생성자 상세

IIOParam

protected IIOParam()

protected 생성자는 서브 클래스에 해서만 호출합니다.

메서드의 상세

setSourceRegion

public void setSourceRegion(Rectangle  sourceRegion)

처리 대상의 소스 영역을 설정합니다. 처리 대상의 영역은 소스 이미지의 좌상구석을 픽셀 (0, 0)로서 하부 및 우측향에 값을 증가시키는 구형으로 기술됩니다. 사용하는 실제의 픽셀수는 setSourceSubsampling로 설정되는 서브 샘플링 계수에 합니다. 서브 샘플링의 수가 제로가 되도록 설정되었을 경우, IllegalStateException는 발생 됩니다.

이 메서드에 의해 지정된 처리 대상의 소스 영역은 실제의 입출력시의 목적지의 오프셋(offset),넓이 및 높이와 함께 소스의 경계내에 막 들어가도록 클립 됩니다.

sourceRegion값 null은 임의의 영역의 지정을 삭제해, 이미지 전체를 사용할 수 있도록 합니다.

파라미터:

sourceRegion - 처리 대상의 소스 영역을 지정하는 Rectangle 또는 null

예외:

IllegalArgumentException - sourceRegion가 null 이외의 경우로 sourceRegion.x 또는 sourceRegion.y 중 한쪽이 부의 경우

IllegalArgumentException - sourceRegion가 null 이외의 경우로sourceRegion.width 또는 sourceRegion.height 중 한쪽이 부 또는 0 때

IllegalStateException - 서브 샘플링의 영역이 솎아냄 된넓이 또는 높이 제로를 가지는 경우

관련 항목:

getSourceRegion(), setSourceSubsampling(int, int, int, int), setDestinationOffset(java.awt.Point), getDestinationOffset()

getSourceRegion

public Rectangle  getSourceRegion()

사용하는 소스 영역을 리턴합니다. 리턴된 값은 setSourceRegion 직전의 호출에 의해 설정된 값입니다. 영역 세트가 없는 경우는 null이 됩니다.

반환값:

Rectangle로서의 처리 대상 소스 영역, 또는 null

관련 항목:

setSourceRegion(java.awt.Rectangle)

setSourceSubsampling

public void setSourceSubsampling(int sourceXSubsampling,
                                 int sourceYSubsampling,
                                 int subsamplingXOffset,
                                 int subsamplingYOffset)

솎아냄 서브 샘플링을 지정해 입출력에 적용합니다. sourceXSubsampling 및 sourceYSubsampling 파라미터는 서브 샘플링 주기, 즉 모든 소스 픽셀의 후에 떠오르는 행과 열의 수를 지정합니다. 특히, 주기 1 은 모든 행 또는 열을 사용해, 주기 2는 1개 간격으로 행 또는 열을 사용합니다. subsamplingXOffset 및 subsamplingYOffset 파라미터는 최초로 솎아냄 된 픽셀의 영역 또는 이미지의 기점으로부터의 오프셋(offset)를 지정합니다. 매우 큰 소스 이미지를, 솎아냄 된 완전한 이미지에 조립할 수 있는 목적지 영역에 서브 샘플링 하는 경우, 서브 샘플 구라두의 기점을 조정하면, 연결고리를 피하는데 도움이 됩니다. 대부분의 경우, 이러한 파라미터는 단지 0 대로의해 둡니다.

사용하는 픽셀수와 주사선의 수는 다음과 같이 계산됩니다.

주사선의 솎아냄 된 픽셀의 수는 다음의 계산식에서 주어집니다.

truncate[(width - subsamplingXOffset + sourceXSubsampling - 1) / sourceXSubsampling]

폭이 제로인 것 같은 영역의 경우, IllegalStateException가 발생 됩니다.

사용하는 주사선의 수는 똑같이 계산됩니다.

서브 샘플링 구라두를, 소스 영역의 원점 이외의 장소로부터 시작시키는 설정은 큰 이미지의 솎아냄 된 타일을 작성하기 위해서 영역이 사용되는 경우에 도움이 됩니다. 여기에서는 타일의 폭과 높이는 서브 샘플링 주기의 배수가 아닙니다. 서브 샘플링 구라두가 타일간의 일관성을 유지하고 있지 않는 경우, 타일의 경계에 아티팩트가 생깁니다. 각 타일의 서브 샘플링 구라두의 오프셋(offset)를 조정해 보정하는 것으로써, 이러한 아티팩트를 회피할 수 있습니다. 다만, 아티팩트를 회피하기 위해서는 모든 타일을 같은 사이즈에는 할 수 없습니다. 이 경우에 사용하는 구라두 오프셋(offset)는 다음의 계산식에서 주어집니다.
grid offset = [period - (region offset modulo period)] modulo period)

sourceXSubsampling 또는 sourceYSubsampling 중 한쪽이 0 또는 부의 경우, IllegalArgumentException가 발생 됩니다.

subsamplingXOffset 또는 subsamplingYOffset 중 한쪽이 부, 혹은 대응하는 주기보다 큰가 동일한 경우, IllegalArgumentException가 발생 됩니다.

unsetSourceSubsampling 메서드는 없습니다. 단지 setSourceSubsampling(1, 1, 0, 0)를 호출해 기본값을 복원합니다.

파라미터:

sourceXSubsampling - 픽셀 사이에 떠오르는 렬수

sourceYSubsampling - 픽셀 사이에 떠오르는 행수

subsamplingXOffset - 영역내, 또는 영역이 설정되어 있지 않은 경우는 이미지내의 최초의 서브 샘플의 수평 방향의 오프셋(offset)

subsamplingYOffset - 영역내, 또는 영역이 설정되어 있지 않은 경우는 이미지내의 최초의 서브 샘플의 수평 방향의 오프셋(offset)

예외:

IllegalArgumentException - 어떤 것인가의 주기가 부 또는 0인 경우, 또는 구라두의 오프셋(offset)가 부나 대응하는 주기보다 큰 경우

IllegalStateException - 소스 영역의 솎아냄 된 출력이 픽셀을 보관 유지하고 있지 않는 경우

getSourceXSubsampling

public int getSourceXSubsampling()

픽셀 마다 떠오르는 소스열의 수를 리턴합니다.

setSourceSubsampling가 불려가 지 않았던 경우, 올바른 값 1 이 리턴됩니다 .

반환값:

소스 서브 샘플링 주기 X

관련 항목:

setSourceSubsampling(int, int, int, int), getSourceYSubsampling()

getSourceYSubsampling

public int getSourceYSubsampling()

픽셀 마다 떠오르는 소스행의 수를 리턴합니다.

setSourceSubsampling가 불려가 지 않았던 경우, 올바른 값 1 이 리턴됩니다 .

반환값:

소스 서브 샘플링의 주기 Y

관련 항목:

setSourceSubsampling(int, int, int, int), getSourceXSubsampling()

getSubsamplingXOffset

public int getSubsamplingXOffset()

서브 샘플링 구라두의 수평 방향의 오프셋(offset)를 리턴합니다.

setSourceSubsampling가 불려가 지 않았던 경우, 올바른 값 0 이 리턴됩니다 .

반환값:

소스 서브 샘플링 구라두의 X 오프셋(offset)

관련 항목:

setSourceSubsampling(int, int, int, int), getSubsamplingYOffset()

getSubsamplingYOffset

public int getSubsamplingYOffset()

서브 샘플링 구라두의 수직 방향의 오프셋(offset)를 리턴합니다.

setSourceSubsampling가 불려가 지 않았던 경우, 올바른 값 0 이 리턴됩니다 .

반환값:

소스 서브 샘플링 구라두의 Y 오프셋(offset)

관련 항목:

setSourceSubsampling(int, int, int, int), getSubsamplingXOffset()

setSourceBands

public void setSourceBands(int[] sourceBands)

사용하는 소스 밴드의 인덱스를 설정합니다. 인덱스의 복제는 사용할 수 없습니다.

값 null은 모든 소스 밴드가 사용되는 것을 나타냅니다.

사용 가능한 최대 소스 밴드 인덱스보다 큰 값이 지정되었을 경우, 또는 사용하는 소스 밴드와 목적지 밴드의 수가 다른 경우, IllegalArgumentException는 read시에 리더 또는 Writer에 의해 발생 됩니다. 이 테스트를 자동화하기 위해서 ImageReader.checkReadParamBandSettings 메서드가 사용됩니다.

미상에서는 카피는 배열로부터 작성됩니다. 이 호출의 후에 배열의 내용이 변경되어도, IIOParam에는 무슨 영향도 없습니다.

파라미터:

sourceBands - 사용하는 정수형 밴드 인덱스의 배열

예외:

IllegalArgumentException - sourceBands가 부 또는 중복 하는 값을 보관 유지하는 경우

관련 항목:

getSourceBands(), ImageReadParam.setDestinationBands(int[]), ImageReader.checkReadParamBandSettings(javax.imageio.ImageReadParam, int, int)

getSourceBands

public int[] getSourceBands()

사용하는 소스 밴드세트를 리턴합니다. 리턴된 값은 직전의 setSourceBands 호출에 의해 설정된 값, 또는 setSourceBands를 호출하지 않았던 경우는 null 입니다.

미상에서는 리턴된 배열은 카피입니다. 이 호출의 후에 배열의 내용이 변경되어도, IIOParam에는 무슨 영향도 없습니다.

반환값:

사용하는 소스 밴드세트, 또는 null

관련 항목:

setSourceBands(int[])

setDestinationType

public void setDestinationType(ImageTypeSpecifier  destinationType)

ImageTypeSpecifier를 사용해, 이용하고 싶은 이미지 형식을 목적지 이미지로 설정합니다.

read시에 이 메서드를 사용해 목적지의 레이아웃이 설정되었을 경우, ImageReader read 메서드의 각 호출은 주어진 타입의 지시자에 의해 지정된 형식을 사용해, 새로운 BufferedImage를 리턴합니다. 부작용으로서ImageReadParam.setDestination(BufferedImage)에 의해 설정되는 모든 목적지 BufferedImage는 목적지로서 설정되지 않게 됩니다. 바꾸어 말하면, 이 메서드는 setDestination((BufferedImage) null) 호출이라고 생각할 수도 있습니다.

출력시에 목적지의 타입은 이미지의 컬러 타입을 결정하기 위해서 사용되는 경우가 있습니다. SampleModel 정보는 무시되어, null이 됩니다. 예를 들어 4 밴드의 이미지는 CMYK 또는 RGBA 데이터의 어떤 것인가로 나타낼 수 있습니다. 목적지의 타입이 설정되었을 경우, 그 ColorModel는 이미지 자체에 있는 모든 ColorModel을 오버라이드(override) 합니다. 이것은 이미지의 ColorModel가 출력해진 밴드의 부분집합은 아니고 이미지 전체를 참조하므로setSourceBands를 사용하는 경우에 중요합니다.

파라미터:

destinationType - 목적지의 레이아웃과 컬러 타입을 결정하기 위해서 사용하는 ImageTypeSpecifier

관련 항목:

getDestinationType()

getDestinationType

public ImageTypeSpecifier  getDestinationType()

ImageTypeSpecifier로 서setDestination(ImageTypeSpecifier) 호출에 의해 설정되었을 경우, read에 의해 리턴된 이미지의 타입을 리턴합니다. 설정되지 않았던 경우, null이 리턴됩니다 .

반환값:

목적지의 타입을 기술하는 ImageTypeSpecifier 또는 null

관련 항목:

setDestinationType(javax.imageio.ImageTypeSpecifier)

setDestinationOffset

public void setDestinationOffset(Point  destinationOffset)

read시의 경우는 장래 디코드되는 픽셀이 배치되는 오프셋(offset), 출력시의 경우는 영역이 출력해지는 오프셋(offset)를 목적지 이미지로 지정합니다.

read시에 BufferedImage 목적지내에 출력해지는 영역은 이 오프셋(offset)로 개시해, 처리 대상의 소스 영역, 서브 샘플링 파라미터 및 목적지의 경계에 의해 결정되는 폭과 높이를 가집니다.

보통 의 출력은 이 메서드의 영향을 받지 않습니다. ImageWriter.replacePixels를 사용해 실행되는 출력만이 영향을 받습니다. 이러한 출력의 경우, 지정된 오프셋(offset)는 픽셀이 변경되는 출력 스트림 이미지내에 있습니다.

unsetDestinationOffset 메서드는 존재하지 않습니다. 단지 setDestinationOffset(new Point(0, 0))를 호출해 기본값을 복원합니다.

파라미터:

destinationOffset - Point로서의 , 목적지의 오프셋(offset)

예외:

IllegalArgumentException - destinationOffset이 null인 경우

관련 항목:

getDestinationOffset(), ImageWriter.replacePixels(java.awt.image.RenderedImage, javax.imageio.ImageWriteParam)

getDestinationOffset

public Point  getDestinationOffset()

픽셀이 배치되는 목적지 이미지의 오프셋(offset)를 리턴합니다.

setDestinationOffsets가 불려가 지 않았던 경우, X 및 Y 값이 제로의 Point이 리턴됩니다 . 이것은 올바른 값입니다.

반환값:

Point로서의 , 목적지의 오프셋(offset)

관련 항목:

setDestinationOffset(java.awt.Point)

setController

public void setController(IIOParamController  controller)

activateController 메서드가 불려 갔을 때에 디폴트 콘트롤러를 오버라이드(override) 해, 이 IIOParam 객체의 설정을 제공하기 위해서 사용하는 IIOParamController를 설정합니다. 인수가 null인 경우, 디폴트를 포함해 콘트롤러는 사용되지 않습니다. 디폴트를 복원하려면, setController(getDefaultController())를 사용합니다.

파라미터:

controller - 적절한 IIOParamController 또는 null

관련 항목:

IIOParamController, getController(), getDefaultController(), hasController(), activateController()

getController

public IIOParamController  getController()

IIOParamController가 현재 인스톨 되고 있는 것은 뭐든지 리턴합니다. 이것이 있는 경우는 디폴트로 null, 또는 setController 직전의 호출의 인수가 됩니다.

반환값:

현재 인스톨 되고 있는 IIOParamController 또는 null

관련 항목:

IIOParamController, setController(javax.imageio.IIOParamController), getDefaultController(), hasController(), activateController()

getDefaultController

public IIOParamController  getDefaultController()

디폴트의 IIOParamController가 있는 경우는 현재 인스톨 되고 있는 콘트롤러와는 관계없이, 이것을 리턴합니다. 디폴트 콘트롤러가 없는 경우는 null을 리턴합니다.

반환값:

디폴트의 IIOParamController 또는 null

관련 항목:

IIOParamController, setController(IIOParamController), getController(), hasController(), activateController()

hasController

public boolean hasController()

이 IIOParam 객체에 인스톨 된 콘트롤러가 있는 경우는 true를 리턴합니다. getController가 null을 돌려주지 않는 경우는 true를 리턴합니다.

반환값:

콘트롤러가 인스톨 되고 있는 경우는 true

관련 항목:

IIOParamController, setController(IIOParamController), getController(), getDefaultController(), activateController()

activateController

public boolean activateController()

이 IIOParam 객체에 인스톨 된 IIOParamController를 시작해, 결과의 값을 리턴합니다. 이 메서드가 true를 돌려주는 경우, 이 IIOParam 객체의 모든 값은 다음의 읽기 또는 출력조작이 가능합니다. false가 돌려주고졌을 경우, 이 객체의 설정은 전혀 영향을 받지 않습니다. 즉, 사용자가 이 조작을 취소했을 경우와 같게 됩니다.

보통 의 콘트롤러는 지정된 플러그 인의 IIOParam 서브 클래스에 대한 사용자 인터페이스를 제공하는 GUI 입니다. 다만, 콘트롤러는 GUI 일 필요는 없습니다.

반환값:

콘트롤러가 보통 대로 완료했을 경우는 true

예외:

IllegalStateException - 콘트롤러가 현재 인스톨되어 있지 않은 경우

관련 항목:

IIOParamController, setController(IIOParamController), getController(), getDefaultController(), hasController()