java.awt.image.renderable
클래스 RenderableImageOp

java.lang.Object 
  |
  +--java.awt.image.renderable.RenderableImageOp

모든 구현 인터페이스:

RenderableImage

public class RenderableImageOp

extends Object

implements RenderableImage

이 클래스는 관련하는 ContextualRenderedImageFactory 의 인스턴스에 의해, 오퍼레이션의 표현 특성을 처리합니다.

필드의 개요

인터페이스 java.awt.image.renderable. RenderableImage 에서 상속받은 필드

HINTS_OBSERVED

생성자의 개요

RenderableImageOp (ContextualRenderedImageFactory CRIF, ParameterBlock paramBlock)
ContextualRenderedImageFactory 오브젝트, 및 RenderableImage 소스와 그 외의 파라미터를 저장하는 ParameterBlock 가 지정된 RenderedImageOp 를 구축합니다.

메소드의 개요

RenderedImage	createDefaultRendering () 이 이미지의 RenderedImage 의 인스턴스를, 디폴트의 폭과 높이 (픽셀 단위)로 작성합니다.
RenderedImage	createRendering (RenderContext renderContext) 지정된 RenderContext 에 의해 표현 된, 이 RenderableImageOp (Renderable 소스를 포함한다)를 나타내는 RenderedImage 를 작성합니다.
RenderedImage	createScaledRendering (int w, int h, RenderingHints hints) 이 이미지의 RenderedImage 의 인스턴스를, 폭 w 픽셀, 높이 h 픽셀로 작성합니다.
float	getHeight () 유저 좌표 공간에서의 높이를 돌려줍니다.
float	getMinX () 표현에 의존하지 않는 이미지 데이터의 최소의 X 좌표를 돌려줍니다.
float	getMinY () 표현에 의존하지 않는 이미지 데이터의 최소의 Y 좌표를 돌려줍니다.
ParameterBlock	getParameterBlock () 현재의 파라미터 블록에의 참조를 돌려줍니다.
Object	getProperty (String name) 이 이미지의 프로퍼티 세트로부터 프로퍼티를 돌려줍니다.
String []	getPropertyNames () getProperty 에 의해 인식되는 이름의 리스트를 돌려줍니다.
Vector	getSources () 이 RenderableImage 의 이미지 데이터의 소스인 RenderableImages 의 벡터를 돌려줍니다.
float	getWidth () 유저 좌표 공간에서의 폭을 돌려줍니다.
boolean	isDynamic () 같은 인수를 사용해 행한 연속한 표현 (즉, createRendering() 또는 createScaledRendering()의 호출)가 다른 결과가 되는 경우는 true 를 돌려줍니다.
ParameterBlock	setParameterBlock (ParameterBlock paramBlock) 현재의 오퍼레이션의 ParameterBlock 를 변경해, 이미지 표현 체인의 편집을 가능하게 합니다.

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

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

생성자의 상세

RenderableImageOp

public RenderableImageOp(ContextualRenderedImageFactory  CRIF,
                         ParameterBlock  paramBlock)

ContextualRenderedImageFactory 오브젝트, 및 RenderableImage 소스와 그 외의 파라미터를 저장하는 ParameterBlock 가 지정된 RenderedImageOp 를 구축합니다. ParameterBlock 에 의해 참조되는 임의의 RenderedImage 소스는 무시됩니다.

파라미터:

CRIF - ContextualRenderedImageFactory 오브젝트

paramBlock - 이 오퍼레이션의 소스 이미지와 오퍼레이션의 실행에 필요한 그 외의 파라미터를 저장하는 ParameterBlock

메소드의 상세

getSources

public Vector  getSources()

이 RenderableImage 의 이미지 데이터의 소스인 RenderableImages 의 벡터를 돌려줍니다. 이 메소드는 이미지에 소스가 없는 것을 나타내기 위해서(때문에) 하늘의 벡터를 돌려주는 경우도 있습니다. 또는 이용할 수 있는 정보가 없는 것을 나타내기 위해서(때문에) null 를 돌려주는 일도 있습니다.

정의:

인터페이스 RenderableImage 내의 getSources

반환값:

RenderableImages 의 Vector (비었을 경우도 있다), 또는 null

getProperty

public Object  getProperty(String  name)

이 이미지의 프로퍼티 세트로부터 프로퍼티를 돌려줍니다. 프로퍼티명이 인식되지 않는 경우, java.awt.Image.UndefinedProperty 가 돌려주어집니다.

정의:

인터페이스 RenderableImage 내의 getProperty

파라미터:

name - 취득하는 프로퍼티의 이름 (String)

반환값:

프로퍼티 Object 에의 참조, 또는 값 java.awt.Image.UndefinedProperty

getPropertyNames

public String [] getPropertyNames()

getProperty 에 의해 인식되는 이름의 리스트를 돌려줍니다.

정의:

인터페이스 RenderableImage 내의 getPropertyNames

반환값:

프로퍼티명의 리스트

isDynamic

public boolean isDynamic()

같은 인수를 사용해 행한 연속한 표현 (즉, createRendering() 또는 createScaledRendering()의 호출)가 다른 결과가 되는 경우는 true 를 돌려줍니다. 이 메소드는 기존의 표현가 캐쉬에 저장 및 재사용될지 어떨지를 판정하기 위해서 사용됩니다. CRIF 의 isDynamic 메소드가 불려 갑니다.

정의:

인터페이스 RenderableImage 내의 isDynamic

반환값:

같은 인수를 사용해 행한 연속한 표현의 결과가 다른 경우는 true, 그렇지 않은 경우는 false

getWidth

public float getWidth()

유저 좌표 공간에서의 폭을 돌려줍니다. 통상은 RenderableImage 의 폭은 이미지의 종횡비 (폭을 높이로 나눈 값)에 동일해집니다.

정의:

인터페이스 RenderableImage 내의 getWidth

반환값:

유저 좌표에서의 이미지의 폭

getHeight

public float getHeight()

유저 좌표 공간에서의 높이를 돌려줍니다. 통상은 RenderedImage 의 높이는 1.0F 에 동일해집니다.

정의:

인터페이스 RenderableImage 내의 getHeight

반환값:

유저 좌표에서의 이미지의 높이

getMinX

public float getMinX()

표현에 의존하지 않는 이미지 데이터의 최소의 X 좌표를 돌려줍니다.

정의:

인터페이스 RenderableImage 내의 getMinX

반환값:

표현에 의존하지 않는 이미지 데이터의 최소의 X 좌표

getMinY

public float getMinY()

표현에 의존하지 않는 이미지 데이터의 최소의 Y 좌표를 돌려줍니다.

정의:

인터페이스 RenderableImage 내의 getMinY

반환값:

표현에 의존하지 않는 이미지 데이터의 최소의 Y 좌표

setParameterBlock

public ParameterBlock  setParameterBlock(ParameterBlock  paramBlock)

현재의 오퍼레이션의 ParameterBlock 를 변경해, 이미지 표현 체인의 편집을 가능하게 합니다. 이러한 변경의 효과는 이 RenderableImageOp 또는 의존하는 임의의 RenderableImageOp 로부터 신규의 표현가 작성된다고 가시가 됩니다.

파라미터:

paramBlock - 신규의 ParameterBlock

반환값:

이전의 ParameterBlock

관련 항목:

getParameterBlock()

getParameterBlock

public ParameterBlock  getParameterBlock()

현재의 파라미터 블록에의 참조를 돌려줍니다.

반환값:

이 RenderableImageOp 의 ParameterBlock

관련 항목:

setParameterBlock(ParameterBlock)

createScaledRendering

public RenderedImage  createScaledRendering(int w,
                                           int h,
                                           RenderingHints  hints)

이 이미지의 RenderedImage 의 인스턴스를, 폭 w 픽셀, 높이 h 픽셀로 작성합니다. RenderContext 는 적절한 usr2dev 변환 및 이미지 전체안의 처리 대상 범위를 사용해 자동적으로 작성됩니다. 모든 표현 힌트는 건네받은 hints 로부터의 것입니다.

w == 0 의 경우는 Math.round(h*(getWidth() /getHeight()))와 같게 됩니다. (와)과 같이 h == 0 의 경우는 Math.round(w*(getHeight() /getWidth()))와 같게 됩니다. w 또는 h 의 어느 쪽인지가 제로 이외일 필요가 있어, 양쪽 모두가 제로의 경우는 IllegalArgumentException 가 슬로우 됩니다.

작성된 RenderedImage 는 이미지를 작성하기 위해서 어느 RenderingHints 를 사용했는지를 나타내는 String HINTS_OBSERVED 에 의해 식별되는 프로퍼티를 가지는 경우가 있습니다. 또, 작성된 RenderedImage 에서의 getSources() 메소드를 개입시켜 취득되는 임의의 RenderedImages 는 그러한 프로퍼티를 가지는 일이 있습니다.

정의:

인터페이스 RenderableImage 내의 createScaledRendering

파라미터:

w - 표현 되는 이미지의 폭 (픽셀수), 또는 0

h - 표현 되는 이미지의 높이 (픽셀수), 또는 0

hints - 힌트가 저장되고 있는 RenderingHints 오브젝트

반환값:

표현 되는 데이터가 저장되고 있는 RenderedImage

createDefaultRendering

public RenderedImage  createDefaultRendering()

이 이미지의 RenderedImage 의 인스턴스를, 디폴트의 폭과 높이 (픽셀 단위)로 작성합니다. RenderContext 는 적절한 usr2dev 변환 및 이미지 전체안의 처리 대상 범위를 사용해 자동적으로 작성됩니다. 모든 표현 힌트는 건네받은 hints 로부터의 것입니다. 이 인터페이스를 구현하는 경우는 디폴트의 폭과 높이가 정의되고 있을 필요가 있습니다.

정의:

인터페이스 RenderableImage 내의 createDefaultRendering

반환값:

표현 되는 데이터가 저장되고 있는 RenderedImage

createRendering

public RenderedImage  createRendering(RenderContext  renderContext)

지정된 RenderContext 에 의해 표현 된, 이 RenderableImageOp (Renderable 소스를 포함한다)를 나타내는 RenderedImage 를 작성합니다.

이 메소드는 Renderable 오퍼레이션 또는 RenderedImage 오퍼레이션의 몇개의 체인을 서포트합니다. RenderableImageOp 의 구축을 위해서(때문에) 사용된 ParameterBlock 의 소스가 RenderableImages 의 경우, 다음의 3 개의 프로세스의 순서가 계속되어 행해집니다.

1. 각 RenderableImage 소스에 관련하는 CRIF 에 mapRenderContext()가 불려 간다
2. 순서 1 으로 취득된 RenderContexts 앞으로 돌아오는 매핑을 사용해, 각 RenderableImage 에 createRendering()를 호출해, 각 소스를 표현 한다
3. createRendering() 호출에 의해 작성된 RenderableImageOp 및 RenderedImages 의 파라미터를 저장하는 신규 ParameterBlock 로, ContextualRenderedImageFactory.create()가 불려 간다

RenderableImageOp 를 작성하기 위해서 사용된 ParameterBlock 의 소스 Vector 의 요소가 RenderedImage 의 인스턴스의 경우는 CRIF.create() 메소드가 원의 ParameterBlock 를 사용하자 마자 불려 갑니다. 이것은 재귀의 기초적인 케이스를 제공합니다.

작성된 RenderedImage 는 이미지를 작성하기 위해서 어느 RenderingHints (RenderContext 로부터의)를 사용했는지를 나타내는 String HINTS_OBSERVED 에 의해 식별되는 프로퍼티를 가지는 경우가 있습니다. 또, 작성되는 RenderedImage 에서의 getSources() 메소드를 개입시켜 취득되는 임의의 RenderedImages 는 이런 종류의 프로퍼티를 가지는 경우가 있습니다.

정의:

인터페이스 RenderableImage 내의 createRendering

파라미터:

renderContext - 표현 작성에 사용하는 RenderContext

반환값:

목적의 출력 이미지가 저장되고 있는 RenderedImage