java.awt.image.renderable
클래스 ParameterBlock

java.lang.Object 
  java.awt.image.renderable.ParameterBlock

모든 구현된 인터페이스:

Serializable, Cloneable

public class ParameterBlock
extends Object 
implements Cloneable,
 Serializable 

ParameterBlock 은 RenderableImageOp 나, 이미지를 처리하는 것 외의 클래스에 의해 필요하게 되는 소스 및 파라미터 (Object)에 대한 모든 정보를 캡슐화합니다.

소스 Vector에는 임의의 객체를 배치할 수 있습니다만, 이 클래스의 사용자는 예를 들어 모든 소스는 RenderedImages 또는 RenderableImage가 아니면 안되는 등이 같은 미 제약을 더할 수도 있습니다. ParameterBlock 자체는 컨테이너에 지나지 않기 때문에 소스 또는 파라미터의 형태의 체크는 실시하지 않습니다.

ParameterBlock 파라미터는 모두 객체입니다. 기본형의 인수를 취하는 간이 add 메서드 및 set 메서드가 이용 가능해, 적절한 Number (Integer 또는 Float 등)의 서브 클래스를 작성합니다. 대응하는 get 메서드는 하부 캐스트를 실행해, 기본형의 반환값을 받습니다. 포함되는 값의 형태가 올바른 형태가 아닌 경우는 예외가 발생 됩니다. short s; add(s)의 결과와 add(new Short(s))의 결과는 구별할 수 없습니다.

get 메서드 및 set 메서드는 참조에 영향을 줍니다. 따라서, ParameterBlock 간에서의 참조의 공유가 부적절한 경우는 공유하지 않게의해 주세요. 예를 들어 추가된 소스를 제외해, 낡은 ParameterBlock 과 같은 새로운 ParameterBlock를 작성하는 경우에 다음과 같이 기술해 버리기 쉽상입니다.

 ParameterBlock addSource(ParameterBlock pb, RenderableImage im) {
     ParameterBlock pb1 = new ParameterBlock(pb.getSources());
     pb1.addSource(im);
     return pb1;
 }
 

이 코드는 getSources 조작이 소스 Vector 에의 참조를 돌려주었기 때문에 원의 ParameterBlock를 변경하는 부작용이 있습니다. pb와 pb1는 소스 Vector를 공유하고 있으므로 한편의 변경은 양쪽 모두에 대해서 가시가 됩니다.

addSource 함수의 기술 방법으로 적절한 것은 다음과 같이 소스 Vector를 복제하는 방법입니다.

 ParameterBlock addSource (ParameterBlock pb, RenderableImage im) {
     ParameterBlock pb1 = new ParameterBlock(pb.getSources(). clone());
     pb1.addSource(im);
     return pb1;
 }
 

ParameterBlock clone 메서드는 이러한 이유로써 소스와 파라미터의 양쪽 모두의 Vector 복제를 실행하도록 정의되고 있습니다. 표준의 샤로 복제를 shallowClone 로서 이용할 수 있습니다.

addSource, setSource, add 및 set 각 메서드는 인수를 추가한 후에 this를 돌려주도록 정의됩니다. 그 때문에 다음과 같은 구문의 사용이 가능합니다.

 ParameterBlock pb = new ParameterBlock();
 op = new RenderableImageOp("operation", pb.add(arg1). add(arg2));
 

관련 항목:

직렬화 된 형식

필드 개요

protected Vector <Object >	parameters 임의의 Object 로서 포함되는 소스 이외의 파라미터의 Vector 입니다.
protected Vector <Object >	sources 임의의 Object 로서 포함되는 소스의 Vector 입니다.

생성자 개요

ParameterBlock ()
더미 생성자 입니다.

ParameterBlock (Vector <Object > sources)
지정된 소스의 Vector를 사용해 ParameterBlock를 구축합니다.

ParameterBlock (Vector <Object > sources, Vector <Object > parameters)
지정된 소스의 Vector 및 파라미터의 Vector를 사용해 ParameterBlock를 구축합니다.

메서드 개요

ParameterBlock	add (byte b) Byte를 파라미터의 리스트에 추가합니다.
ParameterBlock	add (char c) Character를 파라미터의 리스트에 추가합니다.
ParameterBlock	add (double d) Double를 파라미터의 리스트에 추가합니다.
ParameterBlock	add (float f) Float를 파라미터의 리스트에 추가합니다.
ParameterBlock	add (int i) Integer를 파라미터의 리스트에 추가합니다.
ParameterBlock	add (long l) Long를 파라미터의 리스트에 추가합니다.
ParameterBlock	add (Object obj) 객체를 파라미터의 리스트에 추가합니다.
ParameterBlock	add (short s) Short를 파라미터의 리스트에 추가합니다.
ParameterBlock	addSource (Object source) 이미지를 소스의 리스트의 마지막에 추가합니다.
Object	clone () ParameterBlock 복사본을 작성합니다.
byte	getByteParameter (int index) 파라미터를 byte 로서 돌려주는 간이 메서드입니다.
char	getCharParameter (int index) 파라미터를 char 로서 돌려주는 간이 메서드입니다.
double	getDoubleParameter (int index) 파라미터를 double 로서 돌려주는 간이 메서드입니다.
float	getFloatParameter (int index) 파라미터를 float 로서 돌려주는 간이 메서드입니다.
int	getIntParameter (int index) 파라미터를 int 로서 돌려주는 간이 메서드입니다.
long	getLongParameter (int index) 파라미터를 long 로서 돌려주는 간이 메서드입니다.
int	getNumParameters () 파라미터의 수를 리턴합니다.
int	getNumSources () 소스 이미지의 수를 리턴합니다.
Object	getObjectParameter (int index) 파라미터를 객체로서 취득합니다.
Class []	getParamClasses () 파라미터의 형태를 기술하는 Class 객체의 배열을 리턴합니다.
Vector <Object >	getParameters () 파라미터의 Vector 전체를 리턴합니다.
RenderableImage	getRenderableSource (int index) 소스를 RenderableImage 로서 리턴합니다.
RenderedImage	getRenderedSource (int index) 소스를 RenderedImage로 서 리턴합니다.
short	getShortParameter (int index) 파라미터를 short 로서 돌려주는 간이 메서드입니다.
Object	getSource (int index) 소스를 일반적인 Object 로서 리턴합니다.
Vector <Object >	getSources () 소스의 Vector 전체를 리턴합니다.
void	removeParameters () 파라미터의 리스트를 클리어 합니다.
void	removeSources () 소스 이미지의 리스트를 클리어 합니다.
ParameterBlock	set (byte b, int index) 파라미터의 리스트의 Object를 Byte에 옮겨놓습니다.
ParameterBlock	set (char c, int index) 파라미터의 리스트의 Object를 Character에 옮겨놓습니다.
ParameterBlock	set (double d, int index) 파라미터의 리스트의 Object를 Double에 옮겨놓습니다.
ParameterBlock	set (float f, int index) 파라미터의 리스트의 Object를 Float에 옮겨놓습니다.
ParameterBlock	set (int i, int index) 파라미터의 리스트의 Object를 Integer에 옮겨놓습니다.
ParameterBlock	set (long l, int index) 파라미터의 리스트의 Object를 Long에 옮겨놓습니다.
ParameterBlock	set (Object obj, int index) 파라미터의 리스트의 Object를 옮겨놓습니다.
ParameterBlock	set (short s, int index) 파라미터의 리스트의 Object를 Short에 옮겨놓습니다.
void	setParameters (Vector <Object > parameters) 지정된 Vector에 파라미터의 Vector 전체를 설정합니다.
ParameterBlock	setSource (Object source, int index) 소스의 리스트의 엔트리를 새로운 소스에 옮겨놓습니다.
void	setSources (Vector <Object > sources) 지정된 Vector에 소스의 Vector 전체를 설정합니다.
Object	shallowClone () ParameterBlock 샤로코피를 작성합니다.

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

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

필드의 상세

sources

protected Vector <Object > sources

임의의 Object 로서 포함되는 소스의 Vector 입니다.

parameters

protected Vector <Object > parameters

임의의 Object 로서 포함되는 소스 이외의 파라미터의 Vector 입니다.

생성자 상세

ParameterBlock

public ParameterBlock()

더미 생성자 입니다.

ParameterBlock

public ParameterBlock(Vector <Object > sources)

지정된 소스의 Vector를 사용해 ParameterBlock를 구축합니다.

파라미터:

sources - 소스 이미지의 Vector

ParameterBlock

public ParameterBlock(Vector <Object > sources,
                      Vector <Object > parameters)

지정된 소스의 Vector 및 파라미터의 Vector를 사용해 ParameterBlock를 구축합니다.

파라미터:

sources - 소스 이미지의 Vector

parameters - 렌더링 조작으로 사용되는 파라미터의 Vector

메서드의 상세

shallowClone

public Object  shallowClone()

ParameterBlock 샤로코피를 작성합니다. 소스 및 파라미터의 Vector는 참조로 복사됩니다. 추가나 변경은 양쪽 모두의 버전에 대해서 가시가 됩니다.

반환값:

ParameterBlock Object 복제

clone

public Object  clone()

ParameterBlock 복사본을 작성합니다. 소스 및 파라미터의 Vector는 복제됩니다만, 실제의 소스 및 파라미터는 참조로 복사됩니다. 이 때문에 복제에서의 소스 및 파라미터의 순서와 수의 변경은 원의 ParameterBlock로 부터는 불가시가 됩니다. 한편, 공유되는 소스 또는 파라미터 자체의 변경은 가시가 됩니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

ParameterBlock Object 복제

관련 항목:

Cloneable

addSource

public ParameterBlock  addSource(Object  source)

이미지를 소스의 리스트의 마지막에 추가합니다. 장래, 새로운 node 형의 허가를 할 수 있도록, 이미지는 객체로서 포함됩니다.

파라미터:

source - 소스 리스트에 포함되는 이미지 객체

반환값:

지정된 source를 포함하는 새로운의 ParameterBlock

getSource

public Object  getSource(int index)

소스를 일반적인 Object 로서 리턴합니다. 호출측은 그것을 적절한 형태에 캐스트 할 필요가 있습니다.

파라미터:

index - 리턴된 소스의 인덱스

반환값:

sources Vector 내의 지정된 인덱스에 있는 소스를 나타내는 Object

관련 항목:

setSource(Object, int)

setSource

public ParameterBlock  setSource(Object  source,
                                int index)

소스의 리스트의 엔트리를 새로운 소스에 옮겨놓습니다. index 값이 현재의 소스 리스트를 넘는 경우는 필요에 따라서 null을 사용해 리스트가 확장됩니다.

파라미터:

source - 지정된 소스 이미지

index - 지정된 source를 삽입하는 sources Vector 내의 인덱스

반환값:

특정의 index로 지정된 source를 포함하는 새로운의 ParameterBlock

관련 항목:

getSource(int)

getRenderedSource

public RenderedImage  getRenderedSource(int index)

소스를 RenderedImage로 서 리턴합니다. 이 메서드는 간이 메서드입니다. 소스가 RenderedImage가 아닌 경우, 예외가 발생 됩니다.

파라미터:

index - 리턴된 소스의 인덱스

반환값:

sources Vector 내의 지정된 인덱스에 있는 소스 이미지를 나타내는 RenderedImage

getRenderableSource

public RenderableImage  getRenderableSource(int index)

소스를 RenderableImage 로서 리턴합니다. 이 메서드는 간이 메서드입니다. 소스가 RenderableImage가 아닌 경우, 예외가 발생 됩니다.

파라미터:

index - 리턴된 소스의 인덱스

반환값:

sources Vector 내의 지정된 인덱스에 있는 소스 이미지를 나타내는 RenderableImage

getNumSources

public int getNumSources()

소스 이미지의 수를 리턴합니다.

반환값:

sources Vector 내의 소스 이미지의 수

getSources

public Vector <Object > getSources()

소스의 Vector 전체를 리턴합니다.

반환값:

sources Vector

관련 항목:

setSources(Vector)

setSources

public void setSources(Vector <Object > sources)

지정된 Vector에 소스의 Vector 전체를 설정합니다.

파라미터:

sources - 소스 이미지의 Vector

관련 항목:

getSources()

removeSources

public void removeSources()

소스 이미지의 리스트를 클리어 합니다.

getNumParameters

public int getNumParameters()

파라미터의 수를 리턴합니다. 소스 이미지는 포함하지 않습니다.

반환값:

parameters Vector 내의 파라미터의 수

getParameters

public Vector <Object > getParameters()

파라미터의 Vector 전체를 리턴합니다.

반환값:

parameters Vector

관련 항목:

setParameters(Vector)

setParameters

public void setParameters(Vector <Object > parameters)

지정된 Vector에 파라미터의 Vector 전체를 설정합니다.

파라미터:

parameters - 파라미터의 지정된 Vector

관련 항목:

getParameters()

removeParameters

public void removeParameters()

파라미터의 리스트를 클리어 합니다.

add

public ParameterBlock  add(Object  obj)

객체를 파라미터의 리스트에 추가합니다.

파라미터:

obj - parameters Vector에 추가하는 Object

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

add

public ParameterBlock  add(byte b)

Byte를 파라미터의 리스트에 추가합니다.

파라미터:

b - parameters Vector에 추가하는 byte

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

add

public ParameterBlock  add(char c)

Character를 파라미터의 리스트에 추가합니다.

파라미터:

c - parameters Vector에 추가하는 char

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

add

public ParameterBlock  add(short s)

Short를 파라미터의 리스트에 추가합니다.

파라미터:

s - parameters Vector에 추가하는 short

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

add

public ParameterBlock  add(int i)

Integer를 파라미터의 리스트에 추가합니다.

파라미터:

i - parameters Vector에 추가하는 int

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

add

public ParameterBlock  add(long l)

Long를 파라미터의 리스트에 추가합니다.

파라미터:

l - parameters Vector에 추가하는 long

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

add

public ParameterBlock  add(float f)

Float를 파라미터의 리스트에 추가합니다.

파라미터:

f - parameters Vector에 추가하는 float

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

add

public ParameterBlock  add(double d)

Double를 파라미터의 리스트에 추가합니다.

파라미터:

d - parameters Vector에 추가하는 double

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

set

public ParameterBlock  set(Object  obj,
                          int index)

파라미터의 리스트의 Object를 옮겨놓습니다. index 값이 현재의 소스 리스트를 넘는 경우는 필요에 따라서 null을 사용해 리스트가 확장됩니다.

파라미터:

obj - parameters Vector 내의 지정된 인덱스에 있는 파라미터를 옮겨놓는 파라미터

index - 지정된 파라미터로 옮겨지는 파라미터의 인덱스

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

set

public ParameterBlock  set(byte b,
                          int index)

파라미터의 리스트의 Object를 Byte에 옮겨놓습니다. index 값이 현재의 소스 리스트를 넘는 경우는 필요에 따라서 null을 사용해 리스트가 확장됩니다.

파라미터:

b - parameters Vector 내의 지정된 인덱스에 있는 파라미터를 옮겨놓는 파라미터

index - 지정된 파라미터로 옮겨지는 파라미터의 인덱스

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

set

public ParameterBlock  set(char c,
                          int index)

파라미터의 리스트의 Object를 Character에 옮겨놓습니다. index 값이 현재의 소스 리스트를 넘는 경우는 필요에 따라서 null을 사용해 리스트가 확장됩니다.

파라미터:

c - parameters Vector 내의 지정된 인덱스에 있는 파라미터를 옮겨놓는 파라미터

index - 지정된 파라미터로 옮겨지는 파라미터의 인덱스

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

set

public ParameterBlock  set(short s,
                          int index)

파라미터의 리스트의 Object를 Short에 옮겨놓습니다. index 값이 현재의 소스 리스트를 넘는 경우는 필요에 따라서 null을 사용해 리스트가 확장됩니다.

파라미터:

s - parameters Vector 내의 지정된 인덱스에 있는 파라미터를 옮겨놓는 파라미터

index - 지정된 파라미터로 옮겨지는 파라미터의 인덱스

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

set

public ParameterBlock  set(int i,
                          int index)

파라미터의 리스트의 Object를 Integer에 옮겨놓습니다. index 값이 현재의 소스 리스트를 넘는 경우는 필요에 따라서 null을 사용해 리스트가 확장됩니다.

파라미터:

i - parameters Vector 내의 지정된 인덱스에 있는 파라미터를 옮겨놓는 파라미터

index - 지정된 파라미터로 옮겨지는 파라미터의 인덱스

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

set

public ParameterBlock  set(long l,
                          int index)

파라미터의 리스트의 Object를 Long에 옮겨놓습니다. index 값이 현재의 소스 리스트를 넘는 경우는 필요에 따라서 null을 사용해 리스트가 확장됩니다.

파라미터:

l - parameters Vector 내의 지정된 인덱스에 있는 파라미터를 옮겨놓는 파라미터

index - 지정된 파라미터로 옮겨지는 파라미터의 인덱스

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

set

public ParameterBlock  set(float f,
                          int index)

파라미터의 리스트의 Object를 Float에 옮겨놓습니다. index 값이 현재의 소스 리스트를 넘는 경우는 필요에 따라서 null을 사용해 리스트가 확장됩니다.

파라미터:

f - parameters Vector 내의 지정된 인덱스에 있는 파라미터를 옮겨놓는 파라미터

index - 지정된 파라미터로 옮겨지는 파라미터의 인덱스

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

set

public ParameterBlock  set(double d,
                          int index)

파라미터의 리스트의 Object를 Double에 옮겨놓습니다. index 값이 현재의 소스 리스트를 넘는 경우는 필요에 따라서 null을 사용해 리스트가 확장됩니다.

파라미터:

d - parameters Vector 내의 지정된 인덱스에 있는 파라미터를 옮겨놓는 파라미터

index - 지정된 파라미터로 옮겨지는 파라미터의 인덱스

반환값:

지정된 파라미터를 포함하는 새로운의 ParameterBlock

getObjectParameter

public Object  getObjectParameter(int index)

파라미터를 객체로서 취득합니다.

파라미터:

index - 얻는 파라미터의 인덱스

반환값:

parameters Vector 내의 지정된 인덱스에 있는 파라미터를 나타내는 Object

getByteParameter

public byte getByteParameter(int index)

파라미터를 byte 로서 돌려주는 간이 메서드입니다. 파라미터가 null인 경우, 또는 Byte가 아닌 경우는 예외가 발생 됩니다.

파라미터:

index - 리턴된 파라미터의 인덱스

반환값:

지정된 인덱스에서의 byte 값으로 의 파라미터

예외:

ClassCastException - 지정된 인덱스에서의 파라미터가 Byte가 아닌 경우

NullPointerException - 지정된 인덱스에서의 파라미터가 null인 경우

ArrayIndexOutOfBoundsException - index가 부의 경우, 또는 이 ParameterBlock 객체의 현재의 사이즈보다 작지 않은 경우

getCharParameter

public char getCharParameter(int index)

파라미터를 char 로서 돌려주는 간이 메서드입니다. 파라미터가 null인 경우, 또는 Character가 아닌 경우는 예외가 발생 됩니다.

파라미터:

index - 리턴된 파라미터의 인덱스

반환값:

지정된 인덱스에서의 char 값으로 의 파라미터

예외:

ClassCastException - 지정된 인덱스에서의 파라미터가 Character가 아닌 경우

NullPointerException - 지정된 인덱스에서의 파라미터가 null인 경우

ArrayIndexOutOfBoundsException - index가 부의 경우, 또는 이 ParameterBlock 객체의 현재의 사이즈보다 작지 않은 경우

getShortParameter

public short getShortParameter(int index)

파라미터를 short 로서 돌려주는 간이 메서드입니다. 파라미터가 null인 경우, 또는 Short이 아닌 경우는 예외가 발생 됩니다.

파라미터:

index - 리턴된 파라미터의 인덱스

반환값:

지정된 인덱스에서의 short 값으로 의 파라미터

예외:

ClassCastException - 지정된 인덱스에서의 파라미터가 Short이 아닌 경우

NullPointerException - 지정된 인덱스에서의 파라미터가 null인 경우

ArrayIndexOutOfBoundsException - index가 부의 경우, 또는 이 ParameterBlock 객체의 현재의 사이즈보다 작지 않은 경우

getIntParameter

public int getIntParameter(int index)

파라미터를 int 로서 돌려주는 간이 메서드입니다. 파라미터가 null인 경우, 또는 Integer가 아닌 경우는 예외가 발생 됩니다.

파라미터:

index - 리턴된 파라미터의 인덱스

반환값:

지정된 인덱스에서의 int 값으로 의 파라미터

예외:

ClassCastException - 지정된 인덱스에서의 파라미터가 Integer가 아닌 경우

NullPointerException - 지정된 인덱스에서의 파라미터가 null인 경우

ArrayIndexOutOfBoundsException - index가 부의 경우, 또는 이 ParameterBlock 객체의 현재의 사이즈보다 작지 않은 경우

getLongParameter

public long getLongParameter(int index)

파라미터를 long 로서 돌려주는 간이 메서드입니다. 파라미터가 null인 경우, 또는 Long가 아닌 경우는 예외가 발생 됩니다.

파라미터:

index - 리턴된 파라미터의 인덱스

반환값:

지정된 인덱스에서의 long 값으로 의 파라미터

예외:

ClassCastException - 지정된 인덱스에서의 파라미터가 Long가 아닌 경우

NullPointerException - 지정된 인덱스에서의 파라미터가 null인 경우

ArrayIndexOutOfBoundsException - index가 부의 경우, 또는 이 ParameterBlock 객체의 현재의 사이즈보다 작지 않은 경우

getFloatParameter

public float getFloatParameter(int index)

파라미터를 float 로서 돌려주는 간이 메서드입니다. 파라미터가 null인 경우, 또는 Float이 아닌 경우는 예외가 발생 됩니다.

파라미터:

index - 리턴된 파라미터의 인덱스

반환값:

지정된 인덱스에서의 float 값으로 의 파라미터

예외:

ClassCastException - 지정된 인덱스에서의 파라미터가 Float이 아닌 경우

NullPointerException - 지정된 인덱스에서의 파라미터가 null인 경우

ArrayIndexOutOfBoundsException - index가 부의 경우, 또는 이 ParameterBlock 객체의 현재의 사이즈보다 작지 않은 경우

getDoubleParameter

public double getDoubleParameter(int index)

파라미터를 double 로서 돌려주는 간이 메서드입니다. 파라미터가 null인 경우, 또는 Double가 아닌 경우는 예외가 발생 됩니다.

파라미터:

index - 리턴된 파라미터의 인덱스

반환값:

지정된 인덱스에서의 double 값으로 의 파라미터

예외:

ClassCastException - 지정된 인덱스에서의 파라미터가 Double가 아닌 경우

NullPointerException - 지정된 인덱스에서의 파라미터가 null인 경우

ArrayIndexOutOfBoundsException - index가 부의 경우, 또는 이 ParameterBlock 객체의 현재의 사이즈보다 작지 않은 경우

getParamClasses

public Class [] getParamClasses()

파라미터의 형태를 기술하는 Class 객체의 배열을 리턴합니다.

반환값:

Class 객체의 배열