Класс 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) Создаёт RenderedImageOp, используя объект ContextualRenderedImageFactory и ParameterBlock, содержащий источники RenderableImage и другие параметры. |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
RenderedImage |
createDefaultRendering() Получает экземпляр RenderedImage этого изображения с шириной и высотой по умолчанию в пикселях. |
RenderedImage |
createRendering(RenderContext renderContext) Создаёт RenderedImage, представляющий этот RenderableImageOp (включая его источники Renderable) с рендерингом в соответствии с заданным RenderContext. |
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<RenderableImage> |
getSources() Возвращает вектор RenderableImages, которые являются источниками данных изображения для этого RenderableImage. |
float |
getWidth() Получает ширину в пространстве координат пользователя. |
boolean |
isDynamic() Возвращает true, если последовательные рендеринги (то есть вызовы createRendering() или createScaledRendering()) с теми же аргументами могут давать разные результаты. |
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) Создаёт RenderedImageOp, используя объект ContextualRenderedImageFactory и ParameterBlock, содержащий источники RenderableImage и другие параметры. Источники RenderedImage, указанные в ParameterBlock, будут проигнорированы.
- Параметры:
-
CRIF- объект ContextualRenderedImageFactory -
paramBlock- ParameterBlock, содержащий исходные изображения и другие параметры, необходимые для выполнения операции.
Методы
getSources
public Vector<RenderableImage> getSources()
Возвращает вектор RenderableImages, которые являются источниками данных изображения для данного RenderableImage. Обратите внимание, что этот метод может вернуть пустой вектор, чтобы указать, что у изображения нет источников, или null, чтобы указать, что информация недоступна.
- Определено в:
-
getSourcesв интерфейсеRenderableImage - Возвращает:
- вектор (возможно, пустой) RenderableImages или null.
getProperty
public Object getProperty(String name)
Получает свойство из набора свойств этого изображения. Если имя свойства не распознаётся, возвращается java.awt.Image.UndefinedProperty.
- Определено в:
-
getPropertyв интерфейсеRenderableImage - Параметры:
-
name- имя свойства для получения в виде строки. - Возвращает:
- ссылку на объект свойства или значение java.awt.Image.UndefinedProperty.
getPropertyNames
public String[] getPropertyNames()
Возвращает список имён, распознаваемых getProperty.
- Определено в:
-
getPropertyNamesв интерфейсеRenderableImage - Возвращает:
- список имён свойств.
isDynamic
public boolean isDynamic()
Возвращает true, если последующие рендеринги (то есть вызовы createRendering() или createScaledRendering()) с одинаковыми аргументами могут давать разные результаты. Этот метод может использоваться для определения того, можно ли кэшировать и повторно использовать существующий рендеринг. Будет вызван метод isDynamic CRIF.
- Определено в:
-
isDynamicв интерфейсеRenderableImage - Возвращает:
-
trueесли последующие рендеринги с одинаковыми аргументами могут давать разные результаты;falseв противном случае.
getWidth
public float getWidth()
Получает ширину в пространстве координат пользователя. По соглашению, обычная ширина RenderableImage равна соотношению сторон изображения (ширина, делённая на высоту).
- Определено в:
-
getWidthв интерфейсеRenderableImage - Возвращает:
- ширину изображения в координатах пользователя.
getHeight
public float getHeight()
Получает высоту в пространстве координат пользователя. По соглашению, обычная высота RenderedImage равна 1.0F.
- Определено в:
-
getHeightв интерфейсеRenderableImage - Возвращает:
- высоту изображения в координатах пользователя.
getMinX
public float getMinX()
Получает минимальную координату X рендеринг-независимых данных изображения.
- Определено в:
-
getMinXв интерфейсеRenderableImage - Возвращает:
- минимальную координату X рендеринг-независимых данных изображения.
getMinY
public float getMinY()
Получает минимальную координату Y рендеринг-независимых данных изображения.
- Определено в:
-
getMinYв интерфейсеRenderableImage - Возвращает:
- минимальную координату Y рендеринг-независимых данных изображения.
setParameterBlock
public ParameterBlock setParameterBlock(ParameterBlock paramBlock)
Изменяет текущий ParameterBlock операции, позволяя редактировать цепочки рендеринга изображений. Эффекты такого изменения будут видны при создании нового рендеринга из этого RenderableImageOp или любого зависимого RenderableImageOp.
- Параметры:
-
paramBlock- новый ParameterBlock. - Возвращает:
- старый ParameterBlock.
- См. также:
getParameterBlock()
getParameterBlock
public ParameterBlock getParameterBlock()
Возвращает ссылку на текущий блок параметров.
- Возвращает:
- текущий
ParameterBlockэтогоRenderableImageOp. - См. также:
setParameterBlock(ParameterBlock)
createScaledRendering
public RenderedImage createScaledRendering(int w,
int h,
RenderingHints hints) Создаёт экземпляр RenderedImage этого изображения с шириной w и высотой h в пикселях. RenderContext строится автоматически с соответствующим преобразованием usr2dev и областью интереса всего изображения. Все параметры рендеринга берутся из переданных параметров.
Если w == 0, оно будет равно Math.round(h*(getWidth()/getHeight())). Аналогично, если h == 0, оно будет равно Math.round(w*(getHeight()/getWidth())). Одно из w или h должно быть отличным от нуля, иначе будет брошено исключение IllegalArgumentException.
Созданный RenderedImage может иметь свойство, идентифицируемое строкой HINTS_OBSERVED, указывающее, какие RenderingHints использовались для создания изображения. Кроме того, у любых RenderedImages, полученных через метод getSources() на созданном RenderedImage, может быть такое свойство.
- Определено в:
-
createScaledRenderingв интерфейсеRenderableImage - Параметры:
-
w- ширина рендерного изображения в пикселях или 0. -
h- высота рендерного изображения в пикселях или 0. -
hints- объект RenderingHints, содержащий параметры. - Возвращает:
- RenderedImage, содержащий рендерные данные.
createDefaultRendering
public RenderedImage createDefaultRendering()
Получает экземпляр RenderedImage этого изображения с шириной и высотой по умолчанию в пикселях. RenderContext строится автоматически с соответствующим преобразованием usr2dev и областью интереса всего изображения. Все параметры рендеринга берутся из переданных параметров. Реализующие этот интерфейс должны убедиться, что определены значения ширины и высоты по умолчанию.
- Определено в:
-
createDefaultRenderingв интерфейсеRenderableImage - Возвращает:
- RenderedImage, содержащий рендерные данные.
createRendering
public RenderedImage createRendering(RenderContext renderContext)
Создаёт RenderedImage, представляющий этот RenderableImageOp (включая его Renderable-источники), рендеренный в соответствии с заданным RenderContext.
Этот метод поддерживает цепочки операций Renderable или RenderedImage. Если источники в ParameterBlock, используемые для построения RenderableImageOp, являются RenderedImages, то выполняется трёхэтапный процесс:
- mapRenderContext() вызывается для каждого источника RenderableImage связанного CRIF;
- createRendering() вызывается для каждого из источников RenderableImage, используя полученные в шаге 1 обратные преобразования RenderContext, в результате чего каждый источник рендерится;
- ContextualRenderedImageFactory.create() вызывается с новым ParameterBlock, содержащим параметры RenderableImageOp и RenderedImages, которые были созданы вызовами createRendering().
Если элементы вектора источников ParameterBlock, используемого для построения RenderableImageOp, являются экземплярами RenderedImage, то метод CRIF.create() вызывается немедленно, используя исходный ParameterBlock. Это обеспечивает базовый случай для рекурсии.
Созданный RenderedImage может иметь свойство, идентифицируемое строкой HINTS_OBSERVED, указывающее, какие RenderingHints (из RenderContext) использовались для создания изображения. Кроме того, у любых RenderedImages, полученных через метод getSources() на созданном RenderedImage, может быть такое свойство.
- Определено в:
-
createRenderingв интерфейсеRenderableImage - Параметры:
-
renderContext- RenderContext, используемый для выполнения рендеринга. - Возвращает:
- RenderedImage, содержащий желаемое выходное изображение.
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.