Класс BoxBlur
java.lang.Object
javafx.scene.effect.Effect
javafx.scene.effect.BoxBlur
public class BoxBlur
extends Effect Эффект размытия, использующий ядро фильтра простого прямоугольника, с независимо настраиваемыми размерами по обеим осям и параметром итераций, управляющим качеством получаемого размытия.
Пример:
BoxBlur boxBlur = new BoxBlur();
boxBlur.setWidth(10);
boxBlur.setHeight(3);
boxBlur.setIterations(3);
Text text = new Text();
text.setText("Blurry Text!");
text.setFill(Color.web("0x3b596d"));
text.setFont(Font.font(null, FontWeight.BOLD, 50));
text.setX(10);
text.setY(50);
text.setEffect(boxBlur);
Приведённый код генерирует следующее:
- С момента:
- JavaFX 2.0
Краткое описание свойств
| Тип | Свойство | Описание |
|---|---|---|
DoubleProperty | height | Вертикальный размер эффекта размытия. |
ObjectProperty<Effect> | input | Вход для этого Effect. |
IntegerProperty | iterations | Количество итераций эффекта размытия для улучшения его "качества" или "гладкости". |
DoubleProperty | width | Горизонтальный размер эффекта размытия. |
Краткое описание конструкторов
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
double | getHeight() | Получает значение свойства height. |
Effect | getInput() | Получает значение свойства input. |
int | getIterations() | Получает значение свойства iterations. |
double | getWidth() | Получает значение свойства width. |
DoubleProperty | heightProperty() | Вертикальный размер эффекта размытия. |
ObjectProperty<Effect> | inputProperty() | Входной параметр для этого Effect. |
IntegerProperty | iterationsProperty() | Количество итераций эффекта размытия для повышения его "качества" или "гладкости". |
void | setHeight(double value) | Устанавливает значение свойства height. |
void | setInput(Effect value) | Устанавливает значение свойства input. |
void | setIterations(int value) | Устанавливает значение свойства iterations. |
void | setWidth(double value) | Устанавливает значение свойства width. |
DoubleProperty | widthProperty() | Горизонтальный размер эффекта размытия. |
Подробности свойства
input
public final ObjectProperty<Effect> inputProperty
Входное значение для этого
Effect. Если установлено значение null или не указано, графическое изображение Node, к которому прикреплен Effect, будет использоваться как входной параметр.- Значение по умолчанию:
- null
- См. также:
-
getInput(),setInput(Effect)
width
public final DoubleProperty widthProperty
Горизонтальный размер эффекта размытия. Информация о цвете заданного пикселя будет распределена по прямоугольнику указанной ширины, центрированному над пикселем. Значения, меньшие или равные 1, не будут распространять данные о цвете за пределы пикселя, откуда они произошли, и, таким образом, не окажут никакого влияния.
Min: 0.0
Max: 255.0
Default: 5.0
Identity: <1.0
- Значение по умолчанию:
- 5.0
- См. также:
-
getWidth(),setWidth(double)
height
public final DoubleProperty heightProperty
Вертикальный размер эффекта размытия. Информация о цвете заданного пикселя будет распределена по прямоугольнику указанной высоты, центрированному над пикселем. Значения, меньшие или равные 1, не будут распространять данные о цвете за пределы пикселя, откуда они произошли, и, таким образом, не окажут никакого влияния.
Min: 0.0
Max: 255.0
Default: 5.0
Identity: <1.0
- Значение по умолчанию:
- 5.0
- См. также:
-
getHeight(),setHeight(double)
iterations
public final IntegerProperty iterationsProperty
Количество итераций эффекта размытия для повышения его «качества» или «гладкости». 3 итерации эффекта приближают качество Гауссового размытия к 3%.
Min: 0
Max: 3
Default: 1
Identity: 0
- Значение по умолчанию:
- 1
- См. также:
-
getIterations(),setIterations(int)
Подробности конструктора
BoxBlur
public BoxBlur()
Создает новый экземпляр BoxBlur с параметрами по умолчанию.
BoxBlur
public BoxBlur(double width, double height, int iterations)
Создает новый экземпляр BoxBlur с указанной шириной, высотой и количеством итераций.
- Параметры:
-
width- горизонтальный размер эффекта размытия -
height- вертикальный размер эффекта размытия -
iterations- количество итераций эффекта размытия для повышения его «качества» или «гладкости»
Подробности метода
setInput
public final void setInput(Effect value)
Устанавливает значение свойства input.
- Описание свойства:
- Входное значение для этого
Effect. Если установлено значениеnullили не указано, графическое изображениеNode, к которому прикрепленEffect, будет использоваться как входной параметр. - Значение по умолчанию:
- null
getInput
public final Effect getInput()
Получает значение свойства input.
- Описание свойства:
- Входное значение для этого
Effect. Если установлено значениеnullили не указано, графическое изображениеNode, к которому прикрепленEffect, будет использоваться как входной параметр. - Значение по умолчанию:
- null
inputProperty
public final ObjectProperty<Effect> inputProperty()
Входное значение для этого
Effect. Если установлено значение null или не указано, графическое изображение Node, к которому прикреплен Effect, будет использоваться как входной параметр.- Значение по умолчанию:
- null
- См. также:
-
getInput(),setInput(Effect)
setWidth
public final void setWidth(double value)
Устанавливает значение свойства width.
- Описание свойства:
- Горизонтальный размер эффекта размытия. Информация о цвете заданного пикселя будет распределена по прямоугольнику указанной ширины, центрированному над пикселем. Значения, меньшие или равные 1, не будут распространять данные о цвете за пределы пикселя, откуда они произошли, и, таким образом, не окажут никакого влияния.
Min: 0.0 Max: 255.0 Default: 5.0 Identity: <1.0 - Значение по умолчанию:
- 5.0
getWidth
public final double getWidth()
Получает значение свойства width.
- Описание свойства:
- Горизонтальный размер эффекта размытия. Информация о цвете заданного пикселя будет распределена по прямоугольнику указанной ширины, центрированному над пикселем. Значения, меньшие или равные 1, не будут распространять данные о цвете за пределы пикселя, откуда они произошли, и, таким образом, не окажут никакого влияния.
Min: 0.0 Max: 255.0 Default: 5.0 Identity: <1.0 - Значение по умолчанию:
- 5.0
widthProperty
public final DoubleProperty widthProperty()
Горизонтальный размер эффекта размытия. Информация о цвете заданного пикселя будет распределена по прямоугольнику указанной ширины, центрированному над пикселем. Значения, меньшие или равные 1, не будут распространять данные о цвете за пределы пикселя, откуда они произошли, и, таким образом, не окажут никакого влияния.
Min: 0.0
Max: 255.0
Default: 5.0
Identity: <1.0
- Значение по умолчанию:
- 5.0
- См. также:
-
getWidth(),setWidth(double)
setHeight
public final void setHeight(double value)
Устанавливает значение свойства height.
- Описание свойства:
- Вертикальный размер эффекта размытия. Информация о цвете заданного пикселя будет распределена по прямоугольнику указанной высоты, центрированному над пикселем. Значения, меньшие или равные 1, не будут распространять данные о цвете за пределы пикселя, откуда они произошли, и, таким образом, не окажут никакого влияния.
Min: 0.0 Max: 255.0 Default: 5.0 Identity: <1.0 - Значение по умолчанию:
- 5.0
getHeight
public final double getHeight()
Получает значение свойства height.
- Описание свойства:
- Вертикальный размер эффекта размытия. Информация о цвете заданного пикселя будет распределена по прямоугольнику указанной высоты, центрированному над пикселем. Значения, меньшие или равные 1, не будут распространять данные о цвете за пределы пикселя, откуда они произошли, и, таким образом, не окажут никакого влияния.
Min: 0.0 Max: 255.0 Default: 5.0 Identity: <1.0 - Значение по умолчанию:
- 5.0
heightProperty
public final DoubleProperty heightProperty()
Вертикальный размер эффекта размытия. Информация о цвете заданного пикселя будет распределена по прямоугольнику указанной высоты, центрированному над пикселем. Значения, меньшие или равные 1, не будут распространять данные о цвете за пределы пикселя, откуда они произошли, и, таким образом, не окажут никакого влияния.
Min: 0.0
Max: 255.0
Default: 5.0
Identity: <1.0
- Значение по умолчанию:
- 5.0
- См. также:
-
getHeight(),setHeight(double)
setIterations
public final void setIterations(int value)
Устанавливает значение свойства iterations.
- Описание свойства:
- Количество итераций эффекта размытия для повышения его «качества» или «гладкости». 3 итерации эффекта приближают качество Гауссового размытия к 3%.
Min: 0 Max: 3 Default: 1 Identity: 0 - Значение по умолчанию:
- 1
getIterations
public final int getIterations()
Получает значение свойства iterations.
- Описание свойства:
- Количество итераций эффекта размытия для повышения его «качества» или «гладкости». 3 итерации эффекта приближают качество Гауссового размытия к 3%.
Min: 0 Max: 3 Default: 1 Identity: 0 - Значение по умолчанию:
- 1
iterationsProperty
public final IntegerProperty iterationsProperty()
Количество итераций эффекта размытия для повышения его «качества» или «гладкости». 3 итерации эффекта приближают качество Гауссового размытия к 3%.
Min: 0
Max: 3
Default: 1
Identity: 0
- Значение по умолчанию:
- 1
- См. также:
-
getIterations(),setIterations(int)
© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.