javax.imageio
클래스 ImageTypeSpecifier

java.lang.Object 
  javax.imageio.ImageTypeSpecifier

public class ImageTypeSpecifier
extends Object 

이미지의 형식, 특히 SampleModel와 ColorModel을, 편리한 방법으로 지정할 수 있도록 하는 클래스입니다.

필드 개요

protected ColorModel	colorModel prototype로서 사용하는 ColorModel 입니다.
protected SampleModel	sampleModel prototype로서 사용하는 SampleModel 입니다.

생성자 개요

ImageTypeSpecifier (ColorModel colorModel, SampleModel sampleModel)
ColorModel 과 SampleModel로 부터 직접 ImageTypeSpecifier를 구성합니다.

ImageTypeSpecifier (RenderedImage image)
RenderedImage로 부터 ImageTypeSpecifier를 구성합니다.

메서드 개요

static ImageTypeSpecifier	createBanded (ColorSpace colorSpace, int[] bankIndices, int[] bandOffsets, int dataType, boolean hasAlpha, boolean isAlphaPremultiplied) ComponentColorModel와 BandedSampleModel을 사용하는 밴드 된 이미지 형식의 지시자를 돌려주고, 각 채널을 다른 배열에 포함합니다.
BufferedImage	createBufferedImage (int width, int height) 이 객체에 받아들여진 지정에 따라, 주어진 폭과 높이의 BufferedImage를 작성합니다.
static ImageTypeSpecifier	createFromBufferedImageType (int bufferedImageType) 표준 BufferedImage 형식의 1개 (TYPE_CUSTOM 이외)를 encode 하는 ImageTypeSpecifier를 리턴합니다.
static ImageTypeSpecifier	createFromRenderedImage (RenderedImage image) RenderedImage (BufferedImage인 경우도 있다)의 배치를 encode 하는 ImageTypeSpecifier를 리턴합니다.
static ImageTypeSpecifier	createGrayscale (int bits, int dataType, boolean isSigned) 주어진 비트 심도의 픽셀을 지정된 데이터형의 배열 요소에 팩 하는 그레이 스케일 이미지 형식의 지시자를 리턴합니다.
static ImageTypeSpecifier	createGrayscale (int bits, int dataType, boolean isSigned, boolean isAlphaPremultiplied) 주어진 비트 심도의 픽셀을 지정된 데이터형의 배열 요소에 팩 하는 그레이 스케일과 플러스 알파의 이미지 형식의 지시자를 리턴합니다.
static ImageTypeSpecifier	createIndexed (byte[] redLUT, byte[] greenLUT, byte[] blueLUT, byte[] alphaLUT, int bits, int dataType) 주어진 비트 심도의 인덱스치를, 지정된 데이터형의 배열 요소에 팩 하는 인덱스 된 컬러 이미지 형식의 지시자를 리턴합니다.
static ImageTypeSpecifier	createInterleaved (ColorSpace colorSpace, int[] bandOffsets, int dataType, boolean hasAlpha, boolean isAlphaPremultiplied) ComponentColorModel와 PixelInterleavedSampleModel을 사용하는 인터리브 된 이미지 형식의 지시자를 돌려주고, 각 픽셀 원가요소를 다른 byte, short, 또는 int에 포함합니다.
static ImageTypeSpecifier	createPacked (ColorSpace colorSpace, int redMask, int greenMask, int blueMask, int alphaMask, int transferType, boolean isAlphaPremultiplied) DirectColorModel와 팩 된 SampleModel을 사용하는 팩 된 이미지 형식의 지시자를 돌려주고, 1 byte, short, 또는 int에 팩 된 각 픽셀을 포함합니다.
boolean	equals (Object o) 주어진 Object이 ImageTypeSpecifier로 이 객체와 동일한 SampleModel와 ColorModel을 가지는 경우, true를 리턴합니다.
int	getBitsPerBand (int band) 주어진 밴드의 샘플을 나타내기 위해서 사용되는 비트수를 리턴합니다.
int	getBufferedImageType () BufferedImage로 부터, 이미지 형식을 기술하는 열거된 정수값 의 1개를 포함한 int를 리턴합니다.
ColorModel	getColorModel () 객체로 지정된 ColorModel을 리턴합니다.
int	getNumBands () 객체로 지정된 밴드의 수를 리턴합니다.
int	getNumComponents () 객체로 지정된 색성분의 수를 리턴합니다.
SampleModel	getSampleModel () 이 객체내에 캡슐화된 설정에 근거하는 SampleModel을 리턴합니다.
SampleModel	getSampleModel (int width, int height) 이 객체내에서 캡슐화된 설정에 근거하는 SampleModel을 리턴합니다.
int	hashCode () 이 ImageTypeSpecifier 해시 코드를 리턴합니다.

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

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

필드의 상세

colorModel

protected ColorModel  colorModel

prototype로서 사용하는 ColorModel 입니다.

sampleModel

protected SampleModel  sampleModel

prototype로서 사용하는 SampleModel 입니다.

생성자 상세

ImageTypeSpecifier

public ImageTypeSpecifier(ColorModel  colorModel,
                          SampleModel  sampleModel)

ColorModel 과 SampleModel로 부터 직접 ImageTypeSpecifier를 구성합니다. 호환성이 있는 파라미터를 제공하는 것은 호출측의 책임이 됩니다.

파라미터:

colorModel - ColorModel

sampleModel - SampleModel

예외:

IllegalArgumentException - 어느 쪽인가의 파라미터가 null인 경우

IllegalArgumentException - sampleModel가 colorModel와 호환성이 없는 경우

ImageTypeSpecifier

public ImageTypeSpecifier(RenderedImage  image)

RenderedImage로 부터 ImageTypeSpecifier를 구성합니다. BufferedImage를 사용하고 있는 경우, 보다 정확한 결과를 얻기 위해서 팩토리 메서드의 1개 인 createFromRenderedImage 또는 createFromBufferedImageType를 대신에 사용할 필요가 있습니다.

파라미터:

image - RenderedImage

예외:

IllegalArgumentException - 인수가 null인 경우

메서드의 상세

createPacked

public static ImageTypeSpecifier  createPacked(ColorSpace  colorSpace,
                                              int redMask,
                                              int greenMask,
                                              int blueMask,
                                              int alphaMask,
                                              int transferType,
                                              boolean isAlphaPremultiplied)

DirectColorModel와 팩 된 SampleModel을 사용하는 팩 된 이미지 형식의 지시자를 돌려주고, 1 byte, short, 또는 int에 팩 된 각 픽셀을 포함합니다.

파라미터:

colorSpace - 희망하는 ColorSpace

redMask - 빨강의 채널의 위값이 나타난 인접하는 마스크

greenMask - 초록의 채널의 위값이 나타난 인접하는 마스크

blueMask - 파랑의 채널의 위값이 나타난 인접하는 마스크

alphaMask - 알파 채널의 위값이 나타난 인접하는 마스크

transferType - 희망하는 SampleModel 전송 타입

isAlphaPremultiplied - 배색 채널이 알파 채널로 배가 되는 경우는 true

반환값:

희망하는 특징을 가지는 ImageTypeSpecifier

예외:

IllegalArgumentException - colorSpace가 null인 경우

IllegalArgumentException - colorSpace가 타입 TYPE_RGB가 아닌 경우

IllegalArgumentException - 마스크에 1 비트나 설정되어 있지 않은 경우

IllegalArgumentException - transferType가 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT 어떤 것도 아닌 경우

createInterleaved

public static ImageTypeSpecifier  createInterleaved(ColorSpace  colorSpace,
                                                   int[] bandOffsets,
                                                   int dataType,
                                                   boolean hasAlpha,
                                                   boolean isAlphaPremultiplied)

ComponentColorModel와 PixelInterleavedSampleModel을 사용하는 인터리브 된 이미지 형식의 지시자를 돌려주고, 각 픽셀 원가요소를 다른 byte, short, 또는 int에 포함합니다.

파라미터:

colorSpace - 희망하는 ColorSpace

bandOffsets - 각 밴드의 오프셋(offset)를 나타내는 int 배열

dataType - 희망하는 데이터형을 DataBuffer 클래스로부터의 열거법의 1개 로 나타낸 것

hasAlpha - 알파 채널을 희망하는 경우는 true

isAlphaPremultiplied - 배색 채널이 알파 채널로 배가 되는 경우는 true

반환값:

희망하는 특징을 가지는 ImageTypeSpecifier

예외:

IllegalArgumentException - colorSpace가 null인 경우

IllegalArgumentException - bandOffsets가 null인 경우

IllegalArgumentException - dataType가 정당한 DataBuffer.TYPE_* 정수의 1개가 아닌 경우

IllegalArgumentException - bandOffsets.length가 컬러 영역 성분의 수로 동일하지 않은 경우, hasAlpha가 true 때 + 1

createBanded

public static ImageTypeSpecifier  createBanded(ColorSpace  colorSpace,
                                              int[] bankIndices,
                                              int[] bandOffsets,
                                              int dataType,
                                              boolean hasAlpha,
                                              boolean isAlphaPremultiplied)

ComponentColorModel와 BandedSampleModel을 사용하는 밴드 된 이미지 형식의 지시자를 돌려주고, 각 채널을 다른 배열에 포함합니다.

파라미터:

colorSpace - 희망하는 ColorSpace

bankIndices - 각 밴드를 포함하는 뱅크를 나타내는 int 배열

bandOffsets - 뱅크내의 각 밴드의 개시 오프셋(offset)를 나타내는 int 배열

dataType - 희망하는 데이터형을 DataBuffer 클래스로부터의 열거법의 1개 로 나타낸 것

hasAlpha - 알파 채널을 희망하는 경우는 true

isAlphaPremultiplied - 배색 채널이 알파 채널로 배가 되는 경우는 true

반환값:

희망하는 특징을 가지는 ImageTypeSpecifier

예외:

IllegalArgumentException - colorSpace가 null인 경우

IllegalArgumentException - bankIndices가 null인 경우

IllegalArgumentException - bandOffsets가 null인 경우

IllegalArgumentException - bankIndices와 bandOffsets 길이가 다른 경우

IllegalArgumentException - bandOffsets.length가 컬러 영역 성분의 수로 동일하지 않은 경우, hasAlpha가 true 때 + 1

IllegalArgumentException - dataType가 정당한 DataBuffer.TYPE_* 정수의 1개가 아닌 경우

createGrayscale

public static ImageTypeSpecifier  createGrayscale(int bits,
                                                 int dataType,
                                                 boolean isSigned)

주어진 비트 심도의 픽셀을 지정된 데이터형의 배열 요소에 팩 하는 그레이 스케일 이미지 형식의 지시자를 리턴합니다.

파라미터:

bits - 회색 표시의 값 마다의 비트수 (1, 2, 4, 8, 또는 16)

dataType - 희망하는 데이터형을 DataBuffer 클래스로부터의 열거법의 1개 로 나타낸 것

isSigned - 잘못된 값이 표시되는 경우는 true

반환값:

희망하는 특징을 가지는 ImageTypeSpecifier

예외:

IllegalArgumentException - bits가 1, 2, 4, 8, 또는 16 어떤 것도 아닌 경우

IllegalArgumentException - dataType가 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_USHORT 어떤 것도 아닌 경우

IllegalArgumentException - bits가 주어지는 dataType 비트 사이즈보다 큰 경우

createGrayscale

public static ImageTypeSpecifier  createGrayscale(int bits,
                                                 int dataType,
                                                 boolean isSigned,
                                                 boolean isAlphaPremultiplied)

주어진 비트 심도의 픽셀을 지정된 데이터형의 배열 요소에 팩 하는 그레이 스케일과 플러스 알파의 이미지 형식의 지시자를 리턴합니다.

파라미터:

bits - 회색 표시의 값 마다의 비트수 (1, 2, 4, 8, 또는 16)

dataType - 희망하는 데이터형을 DataBuffer 클래스로부터의 열거법의 1개 로 나타낸 것

isSigned - 잘못된 값이 표시되는 경우는 true

isAlphaPremultiplied - 휘도 채널이 알파 채널로 배가 되는 경우는 true

반환값:

희망하는 특징을 가지는 ImageTypeSpecifier

예외:

IllegalArgumentException - bits가 1, 2, 4, 8, 또는 16 어떤 것도 아닌 경우

IllegalArgumentException - dataType가 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_USHORT 어떤 것도 아닌 경우

IllegalArgumentException - bits가 주어지는 dataType 비트 사이즈보다 큰 경우

createIndexed

public static ImageTypeSpecifier  createIndexed(byte[] redLUT,
                                               byte[] greenLUT,
                                               byte[] blueLUT,
                                               byte[] alphaLUT,
                                               int bits,
                                               int dataType)

주어진 비트 심도의 인덱스치를, 지정된 데이터형의 배열 요소에 팩 하는 인덱스 된 컬러 이미지 형식의 지시자를 리턴합니다.

파라미터:

redLUT - 각 인덱스에 대한 빨강의 값을 포함한 byte 배열

greenLUT - 각 인덱스에 대한 * 초록의 값을 포함한 byte 배열

blueLUT - 각 인덱스에 대한 파랑의 값을 포함한 byte 배열

alphaLUT - 각 인덱스에 대한 알파값 또는 완전하게 숨겨진 LUT를 작성하기 위한 null을 포함한 byte 배열

bits - 각 인덱스의 비트수

dataType - 희망하는 출력 형식을 DataBuffer 클래스로부터의 열거법의 1개 로 나타낸 것

반환값:

희망하는 특징을 가지는 ImageTypeSpecifier

예외:

IllegalArgumentException - redLUT가 null인 경우

IllegalArgumentException - greenLUT가 null인 경우

IllegalArgumentException - blueLUT가 null인 경우

IllegalArgumentException - bits가 1, 2, 4, 8, 또는 16 어떤 것도 아닌 경우

IllegalArgumentException - null 이외의 LUT 파라미터가 엄밀하게 1 << bits 길이를 가지지 않는 경우

IllegalArgumentException - dataType가 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT 어떤 것도 아닌 경우

IllegalArgumentException - bits가 주어지는 dataType 비트 사이즈보다 큰 경우

createFromBufferedImageType

public static ImageTypeSpecifier  createFromBufferedImageType(int bufferedImageType)

표준 BufferedImage 형식의 1개 (TYPE_CUSTOM 이외)를 encode 하는 ImageTypeSpecifier를 리턴합니다.

파라미터:

bufferedImageType - 표준 BufferedImage 형식의 1개를 나타내는 int

반환값:

희망하는 특징을 가지는 ImageTypeSpecifier

예외:

IllegalArgumentException - bufferedImageType가 표준 형식의 어떤 것도 아닌, 또는 TYPE_CUSTOM와 동일한 경우

관련 항목:

BufferedImage, BufferedImage.TYPE_INT_RGB, BufferedImage.TYPE_INT_ARGB, BufferedImage.TYPE_INT_ARGB_PRE, BufferedImage.TYPE_INT_BGR, BufferedImage.TYPE_3BYTE_BGR, BufferedImage.TYPE_4BYTE_ABGR, BufferedImage.TYPE_4BYTE_ABGR_PRE, BufferedImage.TYPE_USHORT_565_RGB, BufferedImage.TYPE_USHORT_555_RGB, BufferedImage.TYPE_BYTE_GRAY, BufferedImage.TYPE_USHORT_GRAY, BufferedImage.TYPE_BYTE_BINARY, BufferedImage.TYPE_BYTE_INDEXED

createFromRenderedImage

public static ImageTypeSpecifier  createFromRenderedImage(RenderedImage  image)

RenderedImage (BufferedImage인 경우도 있다)의 배치를 encode 하는 ImageTypeSpecifier를 리턴합니다.

파라미터:

image - RenderedImage

반환값:

희망하는 특징을 가지는 ImageTypeSpecifier

예외:

IllegalArgumentException - image가 null인 경우

getBufferedImageType

public int getBufferedImageType()

BufferedImage로 부터, 이미지 형식을 기술하는 열거된 정수값 의 1개를 포함한 int를 리턴합니다.

반환값:

BufferedImage 형식을 나타내는 int

관련 항목:

BufferedImage, BufferedImage.TYPE_CUSTOM, BufferedImage.TYPE_INT_RGB, BufferedImage.TYPE_INT_ARGB, BufferedImage.TYPE_INT_ARGB_PRE, BufferedImage.TYPE_INT_BGR, BufferedImage.TYPE_3BYTE_BGR, BufferedImage.TYPE_4BYTE_ABGR, BufferedImage.TYPE_4BYTE_ABGR_PRE, BufferedImage.TYPE_USHORT_565_RGB, BufferedImage.TYPE_USHORT_555_RGB, BufferedImage.TYPE_BYTE_GRAY, BufferedImage.TYPE_USHORT_GRAY, BufferedImage.TYPE_BYTE_BINARY, BufferedImage.TYPE_BYTE_INDEXED

getNumComponents

public int getNumComponents()

객체로 지정된 색성분의 수를 리턴합니다. ColorModel.getNumComponents가 돌려주는 값과 같습니다.

반환값:

이미지내의 컴퍼넌트수

getNumBands

public int getNumBands()

객체로 지정된 밴드의 수를 리턴합니다. SampleModel.getNumBands가 돌려주는 값과 같습니다.

반환값:

이미지내의 밴드수

getBitsPerBand

public int getBitsPerBand(int band)

주어진 밴드의 샘플을 나타내기 위해서 사용되는 비트수를 리턴합니다.

파라미터:

band - 조회되는 밴드의 인덱스를 int 로 나타낸 것

반환값:

비트수를 지정하는 int

예외:

IllegalArgumentException - band가 부 또는 최대의 밴드 인덱스보다 큰 경우

getSampleModel

public SampleModel  getSampleModel()

이 객체내에 캡슐화된 설정에 근거하는 SampleModel을 리턴합니다. SampleModel 폭과 높이는 임의의 값으로 설정됩니다.

반환값:

임의의 크기를 가지는 SampleModel

getSampleModel

public SampleModel  getSampleModel(int width,
                                  int height)

이 객체내에서 캡슐화된 설정에 근거하는 SampleModel을 리턴합니다. SampleModel 폭과 높이는 제공된 값으로 설정됩니다.

파라미터:

width - 리턴된 SampleModel 희망하는 폭

height - 리턴된 SampleModel 희망하는 높이

반환값:

주어진 크기를 가지는 SampleModel

예외:

IllegalArgumentException - width 또는 height이 부 또는 0인 경우

IllegalArgumentException - width와 height 적이 Integer.MAX_VALUE 보다 큰 경우

getColorModel

public ColorModel  getColorModel()

객체로 지정된 ColorModel을 리턴합니다.

반환값:

ColorModel.

createBufferedImage

public BufferedImage  createBufferedImage(int width,
                                         int height)

이 객체에 받아들여진 지정에 따라, 주어진 폭과 높이의 BufferedImage를 작성합니다.

파라미터:

width - 리턴된 BufferedImage 희망하는 폭

height - 리턴된 BufferedImage 희망하는 높이

반환값:

새로운 BufferedImage

예외:

IllegalArgumentException - width 또는 height이 부 또는 0인 경우

IllegalArgumentException - width와 height 적이 Integer.MAX_VALUE 보다 큰 경우, 또는 이미지를 포함하기 위해서 필요한 배열 요소의 수가 Integer.MAX_VALUE 보다 큰 경우

equals

public boolean equals(Object  o)

주어진 Object이 ImageTypeSpecifier로 이 객체와 동일한 SampleModel와 ColorModel을 가지는 경우, true를 리턴합니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

o - 동일한지 어떤지를 비교하는 대상의 Object

반환값:

주어진 객체가 ImageTypeSpecifier와 동일한 경우는 true

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 ImageTypeSpecifier 해시 코드를 리턴합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 ImageTypeSpecifier 해시 코드

관련 항목:

Object.equals(java.lang.Object), Hashtable