java.awt
클래스 AlphaComposite

java.lang.Object 
  |
  +--java.awt.AlphaComposite

모든 구현 인터페이스:

Composite

public final class AlphaComposite

extends Object

implements Composite

이 AlphaComposite 클래스는 그래픽스와 이미지의 혼합의 효과, 그리고 투명화의 효과를 실현하기 위해서(때문에), 전송원의 픽셀과 전송처의 픽셀을 결합하기 위한 기본적인 알파 합성 규칙을 구현합니다. 이 클래스에서 구현되는 규칙은 T. Porter 및 T. Duff 공저의 「Compositing Digital Images」(SIGGRAPH 84, 253~259)에 기술되고 있는 Porter-Duff 규칙세트입니다.

입력이 알파 채널을 가지지 않는 경우는 모든 픽셀이 알파치 1.0 (완전하게 불투명)으로 보여집니다. 또, 전송원의 픽셀의 알파치에 정수 알파치를 걸도록(듯이) 지정할 수도 있습니다.

규칙의 설명에서는 다음의 생략명이 사용됩니다.

• Cs = 전송원픽셀의 색성분의 1 개
• Cd = 전송처 픽셀의 색성분의 1 개
• As = 전송원픽셀의 알파 성분
• Ad = 전송처 픽셀의 알파 성분
• Fs = 전송원픽셀 가운데, 출력에 관계하는 부분
• Fd = 입력 전송처 픽셀 가운데, 출력에 관계하는 부분

합성 조작에 의해 생성되는 색과 알파 성분은 다음과 같이 계산됩니다.

	Cd = Cs*Fs + Cd*Fd
	Ad = As*Fs + Ad*Fd

Fs 와 Fd 는 각각의 규칙으로 지정됩니다. 위의 등식은 전송원과 전송처의 픽셀이 어느쪽이나, 미리 알파 성분이 곱셈된 색성분을 가지는 것을 전제로 하고 있습니다. 합성 규칙의 정의를 나타내는 다음의 등식도, 똑같이 미리 곱셈된 알파를 전제로 하고 있습니다.

AlphaComposite 클래스에 의해 생성된 CompositeContext 오브젝트의 합성 메소드에게 건네지는 Raster 의 데이터가 미리 곱셈이 끝난 상태이면, 퍼포먼스가 향상합니다. 전송원 또는 전송처의 어느 쪽인가의 Raster 가 곱셈되어 있지 않은 경우, 합성 조작의 전후에 적절한 변환이 실행됩니다.

합성 조작의 결과의 알파는 전송 먼저 알파 채널이 있는 경우는 전송 먼저 저장됩니다. 그렇지 않은 경우, 결과의 색은 전송 먼저 저장되기 전에 결과의 알파에서 제산되어 알파는 파기됩니다. 알파치가 0.0 이면, 칼라치는 0.0 으로 설정됩니다.

관련 항목:

Composite , CompositeContext

필드의 개요

static AlphaComposite	Clear 1. 0f 의 알파를 가지는 불투명의 CLEAR 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static int	CLEAR Porter-Duff Clear 규칙입니다.
static AlphaComposite	Dst 1. 0f 의 알파를 가지는 불투명의 DST 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static int	DST Porter-Duff Destination 규칙입니다.
static int	DST_ATOP Porter-Duff Destination Atop Source 규칙입니다.
static int	DST_IN Porter-Duff Destination In Source 규칙입니다.
static int	DST_OUT Porter-Duff Destination Held Out By Source 규칙입니다.
static int	DST_OVER Porter-Duff Destination Over Source 규칙입니다.
static AlphaComposite	DstAtop 1. 0f 의 알파를 가지는 불투명의 DST_ATOP 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static AlphaComposite	DstIn 1. 0f 의 알파를 가지는 불투명의 DST_IN 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static AlphaComposite	DstOut 1. 0f 의 알파를 가지는 불투명의 DST_OUT 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static AlphaComposite	DstOver 1. 0f 의 알파를 가지는 불투명의 DST_OVER 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static AlphaComposite	Src 1. 0f 의 알파를 가지는 불투명의 SRC 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static int	SRC Porter-Duff Source 규칙입니다.
static int	SRC_ATOP Porter-Duff Source Atop Destination 규칙입니다.
static int	SRC_IN Porter-Duff Source In Destination 규칙입니다.
static int	SRC_OUT Porter-Duff Source Held Out By Destination 규칙입니다.
static int	SRC_OVER Porter-Duff Source Over Destination 규칙입니다.
static AlphaComposite	SrcAtop 1. 0f 의 알파를 가지는 불투명의 SRC_ATOP 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static AlphaComposite	SrcIn 1. 0f 의 알파를 가지는 불투명의 SRC_IN 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static AlphaComposite	SrcOut 1. 0f 의 알파를 가지는 불투명의 SRC_OUT 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static AlphaComposite	SrcOver 1. 0f 의 알파를 가지는 불투명의 SRC_OVER 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static AlphaComposite	Xor 1. 0f 의 알파를 가지는 불투명의 XOR 규칙을 구현하는 AlphaComposite 오브젝트입니다.
static int	XOR Porter-Duff Source Xor Destination 규칙입니다.

메소드의 개요

CompositeContext	createContext (ColorModel srcColorModel, ColorModel dstColorModel, RenderingHints hints) 합성 조작의 문맥을 작성합니다.
boolean	equals (Object obj) 지정된 Object 가 이 AlphaComposite 오브젝트와 동일한지 어떤지를 판정합니다.
float	getAlpha () 이 AlphaComposiste 의 알파치를 돌려줍니다.
static AlphaComposite	getInstance (int rule) 지정된 규칙을 사용해 AlphaComposite 오브젝트를 생성합니다.
static AlphaComposite	getInstance (int rule, float alpha) 지정된 규칙과 전송원의 알파에 거는 정수 알파를 사용해 AlphaComposite 오브젝트를 생성합니다.
int	getRule () 이 AlphaComposite 의 합성 규칙을 돌려줍니다.
int	hashCode () 이 합성의 해시 코드를 돌려줍니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

CLEAR

public static final int CLEAR

Porter-Duff Clear 규칙입니다. 전송처의 색 및 알파의 양쪽 모두가 클리어 됩니다. 전송원과 전송처의 어느쪽이나 입력으로서 사용되지 않습니다.

Fs = 0, Fd = 0 의 경우, 다음과 같이 됩니다.

	Cd = 0
	Ad = 0

관련 항목:

정수 필드치

SRC

public static final int SRC

Porter-Duff Source 규칙입니다. 전송원이 전송 먼저 카피됩니다. 전송처는 입력으로서 사용되지 않습니다.

Fs = 1, Fd = 0 의 경우, 다음과 같이 됩니다.

	Cd = Cs
	Ad = As

관련 항목:

정수 필드치

DST

public static final int DST

Porter-Duff Destination 규칙입니다. 전송처는 변경되지 않습니다.

Fs = 0, Fd = 1 의 경우, 다음과 같이 됩니다.

	Cd = Cd
	Ad = Ad

도입된 버젼:

1.4

관련 항목:

정수 필드치

SRC_OVER

public static final int SRC_OVER

Porter-Duff Source Over Destination 규칙입니다. 전송원래는 전송처 우에에 겹쳐 맞출 수 있습니다.

Fs = 1, Fd = (1-As)의 경우, 다음과 같이 됩니다.

	Cd = Cs + Cd*(1-As)
	Ad = As + Ad*(1-As)

관련 항목:

정수 필드치

DST_OVER

public static final int DST_OVER

Porter-Duff Destination Over Source 규칙입니다. 전송처는 전송원 우에에 겹쳐 맞출 수 있어 이 결과 생성된 색으로 전송처를 옮겨놓을 수 있습니다.

Fs = (1-Ad), Fd = 1 의 경우, 다음과 같이 됩니다.

	Cd = Cs*(1-Ad) + Cd
	Ad = As*(1-Ad) + Ad

관련 항목:

정수 필드치

SRC_IN

public static final int SRC_IN

Porter-Duff Source In Destination 규칙입니다. 전송원의 전송처 내부에 있는 부분에서 전송처를 옮겨놓을 수 있습니다.

Fs = Ad, Fd = 0 의 경우, 다음과 같이 됩니다.

	Cd = Cs*Ad
	Ad = As*Ad

관련 항목:

정수 필드치

DST_IN

public static final int DST_IN

Porter-Duff Destination In Source 규칙입니다. 전송처의 전송원의 내부에 있는 부분에서 전송처를 옮겨놓을 수 있습니다.

Fs = 0, Fd = As 의 경우, 다음과 같이 됩니다.

	Cd = Cd*As
	Ad = Ad*As

관련 항목:

정수 필드치

SRC_OUT

public static final int SRC_OUT

Porter-Duff Source Held Out By Destination 규칙입니다. 전송원의 전송처의 밖에 있는 부분에서 전송처를 옮겨놓을 수 있습니다.

Fs = (1-Ad), Fd = 0 의 경우, 다음과 같이 됩니다.

	Cd = Cs*(1-Ad)
	Ad = As*(1-Ad)

관련 항목:

정수 필드치

DST_OUT

public static final int DST_OUT

Porter-Duff Destination Held Out By Source 규칙입니다. 전송처의 전송원의 밖에 있는 부분에서 전송처를 옮겨놓을 수 있습니다.

Fs = 0, Fd = (1-As)의 경우, 다음과 같이 됩니다.

	Cd = Cd*(1-As)
	Ad = Ad*(1-As)

관련 항목:

정수 필드치

SRC_ATOP

public static final int SRC_ATOP

Porter-Duff Source Atop Destination 규칙입니다. 전송원의 전송처 내부에 있는 부분이, 전송 먼저 거듭해 배합할 수 있습니다.

Fs = Ad, Fd = (1-As)의 경우, 이하와 같이 됩니다.

	Cd = Cs*Ad + Cd*(1-As)
	Ad = As*Ad + Ad*(1-As) = Ad

도입된 버젼:

1.4

관련 항목:

정수 필드치

DST_ATOP

public static final int DST_ATOP

Porter-Duff Destination Atop Source 규칙입니다. 전송처의 전송원내부에 있는 부분이, 전송 바탕으로 거듭해 맞출 수 있어 이 결과 생성된 색으로 전송처를 옮겨놓을 수 있습니다.

Fs = (1-Ad), Fd = As 의 경우, 이하와 같이 됩니다.

	Cd = Cs*(1-Ad) + Cd*As
	Ad = As*(1-Ad) + Ad*As = As

도입된 버젼:

1.4

관련 항목:

정수 필드치

XOR

public static final int XOR

Porter-Duff Source Xor Destination 규칙입니다. 전송원의 전송처의 밖에 있는 부분이, 전송처의 전송원의 밖에 있는 부분과 혼합됩니다.

Fs = (1-Ad), Fd = (1-As)의 경우, 이하와 같이 됩니다.

	Cd = Cs*(1-Ad) + Cd*(1-As)
	Ad = As*(1-Ad) + Ad*(1-As)

도입된 버젼:

1.4

관련 항목:

정수 필드치

Clear

public static final AlphaComposite  Clear

1.0f 의 알파를 가지는 불투명의 CLEAR 규칙을 구현하는 AlphaComposite 오브젝트입니다.

관련 항목:

CLEAR

Src

public static final AlphaComposite  Src

1.0f 의 알파를 가지는 불투명의 SRC 규칙을 구현하는 AlphaComposite 오브젝트입니다.

관련 항목:

SRC

Dst

public static final AlphaComposite  Dst

1.0f 의 알파를 가지는 불투명의 DST 규칙을 구현하는 AlphaComposite 오브젝트입니다.

도입된 버젼:

1.4

관련 항목:

DST

SrcOver

public static final AlphaComposite  SrcOver

1.0f 의 알파를 가지는 불투명의 SRC_OVER 규칙을 구현하는 AlphaComposite 오브젝트입니다.

관련 항목:

SRC_OVER

DstOver

public static final AlphaComposite  DstOver

1.0f 의 알파를 가지는 불투명의 DST_OVER 규칙을 구현하는 AlphaComposite 오브젝트입니다.

관련 항목:

DST_OVER

SrcIn

public static final AlphaComposite  SrcIn

1.0f 의 알파를 가지는 불투명의 SRC_IN 규칙을 구현하는 AlphaComposite 오브젝트입니다.

관련 항목:

SRC_IN

DstIn

public static final AlphaComposite  DstIn

1.0f 의 알파를 가지는 불투명의 DST_IN 규칙을 구현하는 AlphaComposite 오브젝트입니다.

관련 항목:

DST_IN

SrcOut

public static final AlphaComposite  SrcOut

1.0f 의 알파를 가지는 불투명의 SRC_OUT 규칙을 구현하는 AlphaComposite 오브젝트입니다.

관련 항목:

SRC_OUT

DstOut

public static final AlphaComposite  DstOut

1.0f 의 알파를 가지는 불투명의 DST_OUT 규칙을 구현하는 AlphaComposite 오브젝트입니다.

관련 항목:

DST_OUT

SrcAtop

public static final AlphaComposite  SrcAtop

1.0f 의 알파를 가지는 불투명의 SRC_ATOP 규칙을 구현하는 AlphaComposite 오브젝트입니다.

도입된 버젼:

1.4

관련 항목:

SRC_ATOP

DstAtop

public static final AlphaComposite  DstAtop

1.0f 의 알파를 가지는 불투명의 DST_ATOP 규칙을 구현하는 AlphaComposite 오브젝트입니다.

도입된 버젼:

1.4

관련 항목:

DST_ATOP

Xor

public static final AlphaComposite  Xor

1.0f 의 알파를 가지는 불투명의 XOR 규칙을 구현하는 AlphaComposite 오브젝트입니다.

도입된 버젼:

1.4

관련 항목:

XOR

메소드의 상세

getInstance

public static AlphaComposite  getInstance(int rule)

지정된 규칙을 사용해 AlphaComposite 오브젝트를 생성합니다.

파라미터:

rule - 합성 규칙

예외:

IllegalArgumentException - rule 가,CLEAR ,SRC ,DST ,SRC_OVER ,DST_OVER ,SRC_IN ,DST_IN ,SRC_OUT ,DST_OUT ,SRC_ATOP ,DST_ATOP , 또는 XOR 의 어떤 것도 아닌 경우

getInstance

public static AlphaComposite  getInstance(int rule,
                                         float alpha)

지정된 규칙과 전송원의 알파에 거는 정수 알파를 사용해 AlphaComposite 오브젝트를 생성합니다. 전송처와 합성되기 전에, 전송원래는 지정된 알파에서 곱셈됩니다.

파라미터:

rule - 합성 규칙

alpha - 전송원의 알파에 거는 정수 알파. alpha 는 범위 [0.0, 1. 0] (양단을 포함한다)의 부동 소수점수(실수)치가 아니면 안된다

createContext

public CompositeContext  createContext(ColorModel  srcColorModel,
                                      ColorModel  dstColorModel,
                                      RenderingHints  hints)

합성 조작의 문맥을 작성합니다. 문맥에는 합성 조작을 실행하는 경우 상태가 설정됩니다.

정의:

인터페이스 Composite 내의 createContext

파라미터:

srcColorModel - 전송원의 ColorModel

dstColorModel - 전송처의 ColorModel

hints - 문맥 오브젝트가 표현의 선택사항을 선택할 경우에 사용하는 힌트

반환값:

합성 조작을 실행하기 위해서 사용되는 CompositeContext 오브젝트

getAlpha

public float getAlpha()

이 AlphaComposiste 의 알파치를 돌려줍니다. 이 AlphaComposiste 가 알파치를 가지지 않는 경우는 1.0 이 돌려주어집니다.

반환값:

이 AlphaComposite 의 알파치

getRule

public int getRule()

이 AlphaComposite 의 합성 규칙을 돌려줍니다.

반환값:

이 AlphaComposite 의 합성 규칙

hashCode

public int hashCode()

이 합성의 해시 코드를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 합성의 해시 코드

관련 항목:

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

equals

public boolean equals(Object  obj)

지정된 Object 가 이 AlphaComposite 오브젝트와 동일한지 어떤지를 판정합니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 동일한지 어떤지가 판정되는 Object

반환값:

obj 가 이 AlphaComposite 와 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode() , Hashtable