Класс GraphicsContext

java.lang.Object

javafx.scene.canvas.GraphicsContext

public final class GraphicsContext
extends Object

Этот класс используется для выполнения команд рисования на Canvas с помощью буфера.

Каждая вызов помещает необходимые параметры в буфер, где они позже будут отрисованы на изображении узла Canvas потоком отрисовки в конце импульса.

Canvas содержит только один GraphicsContext и только один буфер. Если он не присоединён к какой-либо сцене, то его можно изменять из любого потока, при условии, что он используется только из одного потока за раз. После того, как узел Canvas присоединён к сцене, его необходимо изменять в потоке JavaFX Application.

Вызов любого метода на GraphicsContext считается изменением соответствующего Canvas и подчиняется тем же правилам потоков.

GraphicsContext также управляет стеком объектов состояния, которые можно сохранять или восстанавливать в любое время.

GraphicsContext поддерживает следующие атрибуты отрисовки, которые влияют на различные подмножества методов отрисовки:

Список атрибутов отрисовки
Атрибут	Сохранять/Восстанавливать?	Значение по умолчанию	Описание
Общие атрибуты отрисовки
`Clip`	Да	Без обрезки	Антиалиазированное пересечение различных путей обрезки, к которым ограничена отрисовка.
`Global Alpha`	Да	`1.0`	Значение непрозрачности, контролирующее видимость или затемнение каждой операции отрисовки.
`Global Blend Mode`	Да	`SRC_OVER`	Значение перечисления `BlendMode`, которое контролирует, как пиксели каждой операции отрисовки комбинируются с существующим изображением.
`Transform`	Да	`Identity`	Матрица 3x2 2D аффинного преобразования, которая контролирует, как координаты отображаются на логические пиксели изображения холста.
`Effect`	Да	`null`	Применяемый к каждой операции отрисовки `Effect`.
Атрибуты заливки
`Fill Paint`	Да	`BLACK`	Применяемая к внутренней части фигур в операции заливки `Paint`.
Атрибуты обводки
`Stroke Paint`	Да	`BLACK`	Применяемая к границе фигур в операции обводки `Paint`.
`Line Width`	Да	`1.0`	Ширина обводки, применяемая к границе фигур в операции обводки.
`Line Cap`	Да	`SQUARE`	Стиль конечных заглушек, применяемых к началу и концу каждого штриха и/или подпути в операции обводки.
`Line Join`	Да	`MITER`	Стиль соединений, применяемых между отдельными сегментами в граничных путях фигур в операции обводки.
`Miter Limit`	Да	`10.0`	Предельный коэффициент, определяющий, насколько далеко соединение типа `MITER` может распространяться в направлении острого угла между сегментами в граничном пути фигуры относительно ширины линии, прежде чем он будет усечен до соединения типа `BEVEL` в операции обводки.
`Dashes`	Да	`null`	Массив длин штрихов, применяемых к сегментам границы фигур в операции обводки.
`Dash Offset`	Да	`0.0`	Расстояние смещения в массив длин штрихов, с которого начинать штриховку сегментов границы фигур в операции обводки.
Атрибуты текста
`Font`	Да	`Default Font`	Шрифт, используемый для всех операций заполнения и обводки текста.
`Text Align`	Да	`LEFT`	Горизонтальное выравнивание текста относительно координаты `X`, указанной в операции с текстом.
`Text Baseline`	Да	`BASELINE`	Вертикальное положение текста относительно координаты `Y`, указанной в операции с текстом.
`Font Smoothing`	Да	`GRAY`	Тип сглаживания (антиалиасинга), применяемый к глифам в шрифте для всех операций заполнения текстом.
Атрибуты пути
`Current Path`	Нет	Пустой путь	Путь, построенный с помощью различных методов построения путей, который будет использоваться в различных операциях заполнения, обводки или обрезки путей.
`Fill Rule`	Да	`NON_ZERO`	Метод, используемый для определения внутренней части путей для операции заполнения или обрезки путей.
Атрибуты изображения
`Image Smoothing`	Да	`true`	Логическое состояние, которое включает или отключает сглаживание изображения для `drawImage(all forms)`.

Различные методы отрисовки на GraphicsContext используют следующие наборы атрибутов отрисовки:

Таблица атрибутов отрисовки
Метод	Общие атрибуты отрисовки	Атрибуты заливки	Атрибуты обводки	Атрибуты текста	Атрибуты пути	Атрибуты изображения
Отрисовка базовых фигур
`fillRect()`, `fillRoundRect()`, `fillOval()`, `fillArc()`	Да	Да	Нет	Нет	Нет	Нет
`strokeLine()`, `strokeRect()`, `strokeRoundRect()`, `strokeOval()`, `strokeArc()`	Да	Нет	Да	Нет	Нет	Нет
`clearRect()`	Да [1]	Нет	Нет	Нет	Нет	Нет
`fillPolygon()`	Да	Да	Нет	Нет	Да [2]	Нет
`strokePolygon()`, `strokePolyline()`	Да	Нет	Да	Нет	Нет	Нет
[1] Только преобразование, обрезка и эффект применяются к clearRect() [2] Только правило заливки применяется к fillPolygon(), текущий путь остается неизменным
Отрисовка текста
`fillText()`, `fillText(with maxWidth)`	Да	Да	Нет	Да [3]	Нет	Нет
`strokeText()`, `strokeText(with maxWidth)`	Да	Нет	Да	Да [3]	Нет	Нет
[3] Атрибут сглаживания шрифта применяется только к залитому тексту
Отрисовка пути
`beginPath()`, `moveTo()`, `lineTo()`, `quadraticCurveTo()`, `bezierCurveTo()`, `arc()`, `arcTo()`, `appendSVGPath()`, `closePath()`, `rect()`	Да [4]	Нет	Нет	Нет	Нет	Нет
`fill()`	Да [4]	Да	Нет	Нет	Да	Нет
`stroke()`	Да [4]	Нет	Да	Нет	Да [5]	Нет
`clip()`	Нет	Нет	Нет	Нет	Да	Нет
[4] Преобразование применяется только во время построения пути [5] Правило заливки используется только для fill() и clip()
Отрисовка изображения
`drawImage(all forms)`	Да	Нет	Нет	Нет	Нет	Да
Разное
`applyEffect()`, `PixelWriter methods`	Нет	Нет	Нет	Нет	Нет	Нет

Пример:

 import javafx.scene.*;
 import javafx.scene.paint.*;
 import javafx.scene.canvas.*;

 Group root = new Group();
 Scene s = new Scene(root, 300, 300, Color.BLACK);

 final Canvas canvas = new Canvas(250,250);
 GraphicsContext gc = canvas.getGraphicsContext2D();

 gc.setFill(Color.BLUE);
 gc.fillRect(75,75,100,100);

 root.getChildren().add(canvas);

Since:: JavaFX 2.2
See Also:: Canvas

Краткое описание методов

Модификатор и тип	Метод	Описание

`void`	`appendSVGPath(String svgpath)`	Добавляет строку SVG Path к текущей траектории.
`void`	`applyEffect(Effect e)`	Применяет заданный эффект ко всему области холста и сохраняет результат обратно в тот же холст.
`void`	`arc(double centerX, double centerY, double radiusX, double radiusY, double startAngle, double length)`	Добавляет элементы пути к текущей траектории, чтобы создать дугу, использующую градусы в системе Евклида.
`void`	`arcTo(double x1, double y1, double x2, double y2, double radius)`	Добавляет сегменты в текущую траекторию, чтобы создать дугу.
`void`	`beginPath()`	Сбрасывает текущую траекторию в пустое состояние.
`void`	`bezierCurveTo(double xc1, double yc1, double xc2, double yc2, double x1, double y1)`	Добавляет сегменты в текущую траекторию, чтобы создать кубическую кривую Безье.
`void`	`clearRect(double x, double y, double w, double h)`	Очищает часть холста с прозрачным значением цвета.
`void`	`clip()`	Пересекает текущую область обрезки с текущей траекторией и применяет её к последующим операциям рендеринга как маску с антиалиасингом.
`void`	`closePath()`	Закрывает траекторию.
`void`	`drawImage(Image img, double x, double y)`	Отображает изображение в заданной позиции x, y, используя ширину и высоту заданного изображения.
`void`	`drawImage(Image img, double x, double y, double w, double h)`	Отображает изображение в заданный прямоугольник назначения холста.
`void`	`drawImage(Image img, double sx, double sy, double sw, double sh, double dx, double dy, double dw, double dh)`	Отображает указанный прямоугольник источника заданного изображения в заданный прямоугольник назначения холста.
`void`	`fill()`	Заполняет траекторию текущей заливкой.
`void`	`fillArc(double x, double y, double w, double h, double startAngle, double arcExtent, ArcType closure)`	Заполняет дугу текущей заливкой.
`void`	`fillOval(double x, double y, double w, double h)`	Заполняет овал текущей заливкой.
`void`	`fillPolygon(double[] xPoints, double[] yPoints, int nPoints)`	Заполняет многоугольник с заданными точками текущей заливкой.
`void`	`fillRect(double x, double y, double w, double h)`	Заполняет прямоугольник текущей заливкой.
`void`	`fillRoundRect(double x, double y, double w, double h, double arcWidth, double arcHeight)`	Заполняет скругленный прямоугольник текущей заливкой.
`void`	`fillText(String text, double x, double y)`	Заполняет заданную строку текста в позиции x, y текущей заливкой.
`void`	`fillText(String text, double x, double y, double maxWidth)`	Заполняет текст и включает максимальную ширину строки.
`Canvas`	`getCanvas()`	Получает `Canvas`, которому `GraphicsContext` выдает команды рисования.
`Effect`	`getEffect(Effect e)`	Возвращает копию эффекта, который будет применён после следующего вызова draw.
`Paint`	`getFill()`	Возвращает текущее свойство заливки.
`FillRule`	`getFillRule()`	Получает свойство правила заливки, используемое для определения внутренности путей при операциях заливки и обрезки.
`Font`	`getFont()`	Получает текущий шрифт.
`FontSmoothingType`	`getFontSmoothingType()`	Получает текущий тип сглаживания шрифта.
`double`	`getGlobalAlpha()`	Получает текущий глобальный альфа-канал.
`BlendMode`	`getGlobalBlendMode()`	Получает глобальный режим смешивания.
`StrokeLineCap`	`getLineCap()`	Получает текущую форму окончания линии штриха.
`double[]`	`getLineDashes()`	Получает копию текущего массива штриховых линий.
`double`	`getLineDashOffset()`	Получает текущий смещение штриховых линий.
`StrokeLineJoin`	`getLineJoin()`	Получает текущую форму соединения линии штриха.
`double`	`getLineWidth()`	Получает текущую ширину линии.
`double`	`getMiterLimit()`	Получает текущее значение ограничения фаски.
`PixelWriter`	`getPixelWriter()`	Возвращает объект `PixelWriter`, который можно использовать для изменения пикселей `Canvas`, связанного с этим `GraphicsContext`.
`Paint`	`getStroke()`	Получает текущий штрих.
`TextAlignment`	`getTextAlign()`	Получает текущий `TextAlignment`.
`VPos`	`getTextBaseline()`	Получает текущую базовую линию текста.
`Affine`	`getTransform()`	Возвращает копию текущего преобразования.
`Affine`	`getTransform(Affine xform)`	Копирует текущее преобразование в предоставленный объект, создавая новый объект `Affine`, если он равен null, и возвращает объект, содержащий копию.
`boolean`	`isImageSmoothing()`	Получает текущее состояние сглаживания изображений.
`boolean`	`isPointInPath(double x, double y)`	Возвращает true, если заданная точка x, y находится внутри пути.

`void`	`lineTo(double x1, double y1)`	Добавляет сегменты в текущий путь, чтобы создать линию до заданной координаты x,y.
`void`	`moveTo(double x0, double y0)`	Выполняет команду перемещения для текущего пути в заданную координату x,y.
`void`	`quadraticCurveTo(double xc, double yc, double x1, double y1)`	Добавляет сегменты в текущий путь, чтобы создать квадратичную кривую Безье.
`void`	`rect(double x, double y, double w, double h)`	Добавляет элементы пути в текущий путь, чтобы создать прямоугольник.
`void`	`restore()`	Извлекает состояние из стека, устанавливая следующие атрибуты в их значения на момент, когда это состояние было помещено в стек.
`void`	`rotate(double degrees)`	Поворачивает текущее преобразование на градусы.
`void`	`save()`	Сохраняет следующие атрибуты в стеке.
`void`	`scale(double x, double y)`	Масштабирует текущее преобразование на x, y.
`void`	`setEffect(Effect e)`	Устанавливает эффект, который будет применяться после следующего вызова draw, или null для отключения эффектов.
`void`	`setFill(Paint p)`	Устанавливает текущий атрибут заливки.
`void`	`setFillRule(FillRule fillRule)`	Устанавливает атрибут правила заполнения для определения внутренней части путей в операциях заполнения или обрезки.
`void`	`setFont(Font f)`	Устанавливает текущий шрифт.
`void`	`setFontSmoothingType(FontSmoothingType fontsmoothing)`	Устанавливает текущий тип сглаживания шрифта.
`void`	`setGlobalAlpha(double alpha)`	Устанавливает глобальный альфа-канал текущего состояния.
`void`	`setGlobalBlendMode(BlendMode op)`	Устанавливает глобальный режим смешивания.
`void`	`setImageSmoothing(boolean imageSmoothing)`	Устанавливает состояние сглаживания изображений.
`void`	`setLineCap(StrokeLineCap cap)`	Устанавливает текущую заглушку линии штриховки.
`void`	`setLineDashes(double... dashes)`	Устанавливает текущий шаблон пунктирной линии штриховки как нормализованную копию аргумента.
`void`	`setLineDashOffset(double dashOffset)`	Устанавливает смещение пунктирной линии.
`void`	`setLineJoin(StrokeLineJoin join)`	Устанавливает текущее соединение линии штриховки.
`void`	`setLineWidth(double lw)`	Устанавливает текущую ширину линии.
`void`	`setMiterLimit(double ml)`	Устанавливает текущее ограничение среза.
`void`	`setStroke(Paint p)`	Устанавливает текущий атрибут заливки штриховки.
`void`	`setTextAlign(TextAlignment align)`	Определяет выравнивание текста по горизонтали относительно начала текста `x`.
`void`	`setTextBaseline(VPos baseline)`	Устанавливает текущую базовую линию текста.
`void`	`setTransform(double mxx, double myx, double mxy, double myy, double mxt, double myt)`	Устанавливает текущее преобразование.
`void`	`setTransform(Affine xform)`	Устанавливает текущее преобразование.
`void`	`stroke()`	Штрихует путь текущей штриховкой.
`void`	`strokeArc(double x, double y, double w, double h, double startAngle, double arcExtent, ArcType closure)`	Штрихует дугу с использованием текущей штриховки.
`void`	`strokeLine(double x1, double y1, double x2, double y2)`	Штрихует линию с использованием текущей штриховки.
`void`	`strokeOval(double x, double y, double w, double h)`	Штрихует овал с использованием текущей штриховки.
`void`	`strokePolygon(double[] xPoints, double[] yPoints, int nPoints)`	Штрихует многоугольник с заданными точками с использованием текущей штриховки.
`void`	`strokePolyline(double[] xPoints, double[] yPoints, int nPoints)`	Штрихует ломаную линию с заданными точками с использованием текущего атрибута штриховки.
`void`	`strokeRect(double x, double y, double w, double h)`	Штрихует прямоугольник с использованием текущей штриховки.
`void`	`strokeRoundRect(double x, double y, double w, double h, double arcWidth, double arcHeight)`	Штрихует прямоугольник с закругленными углами с использованием текущей штриховки.
`void`	`strokeText(String text, double x, double y)`	Рисует заданную строку текста в позиции x, y с текущим атрибутом штриховки.
`void`	`strokeText(String text, double x, double y, double maxWidth)`	Рисует текст с штриховкой и включает максимальную ширину строки.
`void`	`transform(double mxx, double myx, double mxy, double myy, double mxt, double myt)`	Конкатенирует ввод с текущим преобразованием.
`void`	`transform(Affine xform)`	Конкатенирует ввод с текущим преобразованием.
`void`	`translate(double x, double y)`	Переводит текущее преобразование на x, y.

Методы, объявленные в классе java.lang.Object

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

Подробное описание методов

getCanvas

public Canvas getCanvas()

Получает Canvas, к которому GraphicsContext выдает команды отрисовки. Для GraphicsContext всегда существует только один Canvas.

Возвращает:: Canvas — холст, к которому этот GraphicsContext выдает команды отрисовки.

save

public void save()

Сохраняет следующие атрибуты в стеке.

Глобальный альфа-канал
Глобальная операция смешивания
Преобразование
Заливка
Штрих
Ширина линии
Тип наконечника линии
Тип соединения линии
Предел скругления
Обрезка
Шрифт
Выравнивание текста
Линия базового текста
Эффект
Правило заливки

Этот метод никак не изменяет текущее состояние. Также обратите внимание, что текущая траектория не сохраняется.

restore

public void restore()

Извлекает состояние из стека, устанавливая следующие атрибуты в значения, которые они имели в момент добавления этого состояния в стек. Если стек пуст, то ничего не меняется.

Глобальный альфа-канал
Глобальная операция смешивания
Преобразование
Заливка
Штрих
Ширина линии
Тип наконечника линии
Тип соединения линии
Предел скругления
Обрезка
Шрифт
Выравнивание текста
Линия базового текста
Эффект
Правило заливки

Обратите внимание, что текущая траектория не восстанавливается.

translate

public void translate(double x, double y)

Переводит текущее преобразование на x, y.

Параметры:: x — значение для перевода по оси x.; y — значение для перевода по оси y.

scale

public void scale(double x, double y)

Масштабирует текущее преобразование на x, y.

Параметры:: x — значение для масштабирования по оси x.; y — значение для масштабирования по оси y.

rotate

public void rotate(double degrees)

Поворачивает текущее преобразование на заданный угол в градусах.

Параметры:: degrees — значение в градусах для поворота текущего преобразования.

transform

public void transform(double mxx, double myx, double mxy, double myy, double mxt, double myt)

Конкатенирует входное значение с текущим преобразованием.

Параметры:: mxx — элемент масштабирования по оси x матрицы 3x4; myx — элемент сдвига по оси y матрицы 3x4; mxy — элемент сдвига по оси x матрицы 3x4; myy — элемент масштабирования по оси y матрицы 3x4; mxt — элемент смещения по оси x матрицы 3x4; myt — элемент смещения по оси y матрицы 3x4

transform

public void transform(Affine xform)

Конкатенирует входное значение с текущим преобразованием. Поддерживаются только 2D преобразования. Используются только компоненты масштабирования, сдвига и сжатия по осям x и y преобразования. Значение null обрабатывается как тождественное.

Параметры:: xform — Аффинное преобразование для конкатенации с текущим преобразованием или null.

setTransform

public void setTransform(double mxx, double myx, double mxy, double myy, double mxt, double myt)

Устанавливает текущее преобразование.

Параметры:: mxx — элемент масштабирования по оси x матрицы 3x4; myx — элемент сдвига по оси y матрицы 3x4; mxy — элемент сдвига по оси x матрицы 3x4; myy — элемент масштабирования по оси y матрицы 3x4; mxt — элемент смещения по оси x матрицы 3x4; myt — элемент смещения по оси y матрицы 3x4

setTransform

public void setTransform(Affine xform)

Устанавливает текущее преобразование. Поддерживаются только 2D преобразования. Используются только компоненты масштабирования, сдвига и сжатия по осям x и y преобразования.

Параметры:: xform — Аффинное преобразование, которое будет скопировано и использовано в качестве текущего преобразования.

getTransform

public Affine getTransform(Affine xform)

Копирует текущее преобразование в предоставленный объект, создавая новый объект Affine, если он null, и возвращает объект, содержащий копию.

Параметры:: xform — Объект преобразования, который будет использоваться для хранения результата. Если xform не null, то этот метод скопирует текущее преобразование в этот объект. Если xform null, будет создан новый объект преобразования. В любом случае, возвращаемое значение — это копия текущего преобразования.
Возвращает:: Копия текущего преобразования.

getTransform

public Affine getTransform()

Возвращает копию текущего преобразования.

Возвращает:: копия преобразования текущего состояния.

setGlobalAlpha

public void setGlobalAlpha(double alpha)

Устанавливает глобальный альфа-канал текущего состояния. Значение по умолчанию — 1.0. Можно установить любое допустимое double, но для отрисовки будут использованы только значения в диапазоне [0.0, 1.0]. Ближайшее значение к этому диапазону будет использоваться. Глобальный альфа-канал — это общий атрибут, используемый почти во всех методах отрисовки, как указано в таблице атрибутов отрисовки.

Параметры:: alpha — новое значение альфа-канала, ограниченное [0.0, 1.0] при фактическом использовании.

getGlobalAlpha

public double getGlobalAlpha()

Возвращает текущий глобальный альфа-канал. Значение по умолчанию — 1.0. Глобальный альфа-канал — это общий атрибут, используемый почти во всех методах отрисовки, как указано в таблице атрибутов отрисовки.

Возвращает:: текущий глобальный альфа-канал.

setGlobalBlendMode

public void setGlobalBlendMode(BlendMode op)

Устанавливает глобальный режим смешивания. Значение по умолчанию — SRC_OVER. Значение null будет проигнорировано, и текущее значение останется неизменным. Режим смешивания — это общий атрибут, используемый почти во всех методах отрисовки, как указано в таблице атрибутов отрисовки.

Параметры:: op — устанавливаемый BlendMode или null.

getGlobalBlendMode

public BlendMode getGlobalBlendMode()

Возвращает глобальный режим смешивания. Значение по умолчанию — SRC_OVER. Режим смешивания — это общий атрибут, используемый почти во всех методах отрисовки, как указано в таблице атрибутов отрисовки.

Возвращает:: глобальный режим BlendMode текущего состояния.

setFill

public void setFill(Paint p)

Устанавливает текущий цвет заливки. Значение по умолчанию — BLACK. Цвет заливки — это атрибут заливки, используемый в методах заливки, как указано в таблице атрибутов отрисовки. Значение null будет проигнорировано, и текущее значение останется неизменным.

Параметры:: p — Цвет Paint заливки или null.

getFill

public Paint getFill()

Возвращает текущий цвет заливки. Значение по умолчанию — BLACK. Цвет заливки — это атрибут заливки, используемый в методах заливки, как указано в таблице атрибутов отрисовки.

Возвращает:: Цвет Paint заливки.

setStroke

public void setStroke(Paint p)

Устанавливает текущий цвет штриха. Значение по умолчанию — BLACK. Цвет штриха — это атрибут штриха, используемый в методах рисования штрихов, как указано в таблице атрибутов отрисовки. Значение null будет проигнорировано, и текущее значение останется неизменным.

Параметры:: p — Цвет штриха или null.

getStroke

public Paint getStroke()

Возвращает текущий цвет штриха. Значение по умолчанию — BLACK. Цвет штриха — это атрибут штриха, используемый в методах рисования штрихов, как указано в таблице атрибутов отрисовки.

Возвращает:: Цвет Paint штриха.

Установить ширину линии

public void setLineWidth(double lw)

Устанавливает текущую ширину линии. Значение по умолчанию — 1.0. Ширина линии — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга. Значение, равное бесконечности или неположительное и выходящее за пределы диапазона (0, +inf), будет проигнорировано, и текущее значение останется неизменным.

Параметры:: lw — значение в диапазоне {0—бесконечность}, при любом другом значении оно будет проигнорировано, и значение останется неизменным.

Получить ширину линии

public double getLineWidth()

Получает текущую ширину линии. Значение по умолчанию — 1.0. Ширина линии — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга.

Возвращает:: значение от 0 до бесконечности.

Установить тип окончания линии

public void setLineCap(StrokeLineCap cap)

Устанавливает текущее окончание линии штриха. Значение по умолчанию — SQUARE. Окончание линии — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга. Значение null будет проигнорировано, и текущее значение останется неизменным.

Параметры:: cap — StrokeLineCap со значением Butt, Round или Square или null.

Получить тип окончания линии

public StrokeLineCap getLineCap()

Получает текущее окончание линии штриха. Значение по умолчанию — SQUARE. Окончание линии — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга.

Возвращает:: StrokeLineCap со значением Butt, Round или Square.

Установить тип соединения линий

public void setLineJoin(StrokeLineJoin join)

Устанавливает текущее соединение линий штриха. Значение по умолчанию — StrokeLineJoin.MITER. Соединение линий — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга. Значение null будет проигнорировано, и текущее значение останется неизменным.

Параметры:: join — StrokeLineJoin со значением Miter, Bevel или Round или null.

Получить тип соединения линий

public StrokeLineJoin getLineJoin()

Получает текущее соединение линий штриха. Значение по умолчанию — StrokeLineJoin.MITER. Соединение линий — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга.

Возвращает:: StrokeLineJoin со значением Miter, Bevel или Round.

Установить предел сжатия

public void setMiterLimit(double ml)

Устанавливает текущий предел сжатия. Значение по умолчанию — 10.0. Предел сжатия — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга. Значение, равное бесконечности или неположительное и выходящее за пределы диапазона (0, +inf), будет проигнорировано, и текущее значение останется неизменным.

Параметры:: ml — значение предела сжатия в диапазоне от 0 до положительной бесконечности; любое другое значение будет проигнорировано, и значение останется неизменным.

Получить предел сжатия

public double getMiterLimit()

Получает текущий предел сжатия. Значение по умолчанию — 10.0. Предел сжатия — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга.

Возвращает:: значение предела сжатия в диапазоне 0.0-positive infinity

Установить чередующиеся штрихи

public void setLineDashes(double... dashes)

Устанавливает текущую схему чередования штрихов на нормализованную копию аргумента. Значение по умолчанию — null. Массив чередования штрихов — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга. Если массив null, пустой или содержит только 0 элементы, то чередование будет отключено, а текущий массив чередования будет установлен на null. Если какой-либо элемент массива — отрицательное, бесконечное или NaN значение, выходящее за пределы диапазона [0, +inf), то весь массив будет проигнорирован, и текущий массив чередования останется неизменным. Если массив имеет нечетную длину, он будет обработан так, как если бы он был двумя копиями массива, присоединёнными друг к другу.

Параметры:: dashes — массив конечных неотрицательных длин чередующихся штрихов
См. также:: JavaFX 8u40

Получить массив чередующихся штрихов

public double[] getLineDashes()

Возвращает копию текущего массива чередования штрихов. Значение по умолчанию — null. Массив может быть нормализован тестами валидации в методе setLineDashes(double...). Массив чередования штрихов — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга.

Возвращает:: копию текущего массива чередования штрихов.
См. также:: JavaFX 8u40

Установить смещение чередования штрихов

public void setLineDashOffset(double dashOffset)

Устанавливает смещение чередования штрихов. Значение по умолчанию — 0.0. Смещение чередования штрихов — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга. Значение, равное бесконечности или NaN и выходящее за пределы диапазона (-inf, +inf), будет проигнорировано, и текущее значение останется неизменным.

Параметры:: dashOffset — смещение чередования штрихов в диапазоне (-inf, +inf)
См. также:: JavaFX 8u40

Получить смещение чередования штрихов

public double getLineDashOffset()

Получает текущее смещение чередования штрихов. Значение по умолчанию — 0.0. Смещение чередования штрихов — это атрибут штриха, используемый для любых методов штриховки, как указано в таблице Атрибуты рендеринга.

Возвращает:: смещение чередования штрихов в диапазоне (-inf, +inf)
См. также:: JavaFX 8u40

Установить шрифт

public void setFont(Font f)

Устанавливает текущий шрифт. Значение по умолчанию задано в Font.getDefault(). Шрифт — это текстовый атрибут, используемый для любых текстовых методов, как указано в таблице Атрибуты рендеринга. Значение null будет проигнорировано, и текущее значение останется неизменным.

Параметры:: f — шрифт или null.

Получить шрифт

public Font getFont()

Получает текущий шрифт. Значение по умолчанию задано в Font.getDefault(). Шрифт — это текстовый атрибут, используемый для любых текстовых методов, как указано в таблице Атрибуты рендеринга.

Возвращает:: шрифт

Установить тип сглаживания шрифта

public void setFontSmoothingType(FontSmoothingType fontsmoothing)

Устанавливает текущий тип сглаживания шрифта. Значение по умолчанию — GRAY. Тип сглаживания шрифта — это текстовый атрибут, используемый для любых текстовых методов, как указано в таблице Атрибуты рендеринга. Значение null будет проигнорировано, и текущее значение останется неизменным.

Примечание: значение FontSmoothingType LCD поддерживается только над непрозрачным фоном. LCD текст обычно отображается как GRAY текст на прозрачных или частично прозрачных пикселях, и в некоторых реализациях он может вообще не поддерживаться на Canvas, потому что требуемая поддержка отсутствует для поверхностей, содержащих альфа-канал, как у всех Canvas объектов.

Параметры:: fontsmoothing — FontSmoothingType или null
См. также:: JavaFX 8u40

Получить тип сглаживания шрифта

public FontSmoothingType getFontSmoothingType()

Получает текущий тип сглаживания шрифта. Значение по умолчанию — GRAY. Тип сглаживания шрифта — это текстовый атрибут, используемый для любых текстовых методов, как указано в таблице Атрибуты рендеринга.

Возвращает:: тип FontSmoothingType
См. также:: JavaFX 8u40

setTextAlign

public void setTextAlign(TextAlignment align)

Определяет горизонтальное выравнивание текста относительно начала текста x. Значение по умолчанию — LEFT. Выравнивание текста — это текстовый атрибут, используемый для любых текстовых методов, как указано в таблице атрибутов отрисовки LEFT.

Пусть горизонтальные границы представляют собой логическую ширину одной строки текста. Каждая строка текста имеет отдельные горизонтальные границы.

Тогда выравнивание по горизонтали задается следующим образом:

Слева: левый край горизонтальных границ будет находиться в x.
По центру: центр, находящийся посередине между левым и правым краем, горизонтальных границ будет находиться в x.
Справа: правый край горизонтальных границ будет находиться в x.

Примечание: Canvas не поддерживает перенос строк, поэтому выравнивание текста по ширине идентично выравниванию по левому краю.

Значение null будет проигнорировано, и текущее значение останется неизменным.

Parameters:: align - TextAlignment со значениями Left, Center, Right или null.

getTextAlign

public TextAlignment getTextAlign()

Возвращает текущее TextAlignment. Значение по умолчанию — LEFT. Выравнивание текста — это текстовый атрибут, используемый для любых текстовых методов, как указано в таблице атрибутов отрисовки LEFT.

Returns:: TextAlignment со значениями Left, Center, Right или Justify.

setTextBaseline

public void setTextBaseline(VPos baseline)

Устанавливает текущую линию базовой строки текста. Значение по умолчанию — BASELINE. Базовая линия текста — это текстовый атрибут, используемый для любых текстовых методов, как указано в таблице атрибутов отрисовки BASELINE. Значение null будет проигнорировано, и текущее значение останется неизменным.

Parameters:: baseline - VPos со значениями Top, Center, Baseline или Bottom или null.

getTextBaseline

public VPos getTextBaseline()

Возвращает текущую линию базовой строки текста. Значение по умолчанию — BASELINE. Базовая линия текста — это текстовый атрибут, используемый для любых текстовых методов, как указано в таблице атрибутов отрисовки BASELINE.

Returns:: VPos со значениями Top, Center, Baseline или Bottom.

fillText

public void fillText(String text, double x, double y)

Заполняет заданную строку текста в позиции x, y текущим атрибутом заливки. Значение null будет проигнорировано.

Этот метод будет затронут любым из общих глобальных, заливки или текстовых атрибутов, как указано в таблице атрибутов отрисовки.

Parameters:: text - строка текста или null.; x - позиция по оси x.; y - позиция по оси y.

strokeText

public void strokeText(String text, double x, double y)

Отображает заданную строку текста в позиции x, y с помощью текущего атрибута заливки контура. Значение null будет проигнорировано.

Этот метод будет затронут любым из общих глобальных, контурных или текстовых атрибутов, как указано в таблице атрибутов отрисовки.

Parameters:: text - строка текста или null.; x - позиция по оси x.; y - позиция по оси y.

fillText

public void fillText(String text, double x, double y, double maxWidth)

Заполняет текст и включает максимальную ширину строки. Если ширина текста превышает максимальную ширину, она будет подогнана. Значение null будет проигнорировано.

Parameters:: text - строка текста или null.; x - позиция по оси x.; y - позиция по оси y.; maxWidth - максимальная ширина строки текста.

strokeText

public void strokeText(String text, double x, double y, double maxWidth)

Отображает текст с контурной заливкой и включает максимальную ширину строки. Если ширина текста превышает максимальную ширину, она будет подогнана. Значение null будет проигнорировано.

Parameters:: text - строка текста или null.; x - позиция по оси x.; y - позиция по оси y.; maxWidth - максимальная ширина строки текста.

setFillRule

public void setFillRule(FillRule fillRule)

Устанавливает атрибут правила заливки для определения внутренней части контуров при операциях заливки или обрезки. Значение по умолчанию — FillRule.NON_ZERO. Значение null будет проигнорировано, и текущее значение останется неизменным. Правило заливки — это атрибут контура, используемый для любых методов заливки или обрезки контура, как указано в таблице атрибутов отрисовки FillRule.NON_ZERO.

Parameters:: fillRule - FillRule со значением Even_odd или Non_zero или null.

getFillRule

public FillRule getFillRule()

Возвращает атрибут правила заливки для определения внутренней части контуров при операциях заливки и обрезки. Значение по умолчанию — FillRule.NON_ZERO. Правило заливки — это атрибут контура, используемый для любых методов заливки или обрезки контура, как указано в таблице атрибутов отрисовки FillRule.NON_ZERO.

Returns:: текущее правило заливки.

setImageSmoothing

public void setImageSmoothing(boolean imageSmoothing)

Устанавливает состояние сглаживания изображения. Сглаживание изображений — это атрибут изображения, используемый для включения или выключения сглаживания изображения для drawImage(all forms), как указано в таблице атрибутов отрисовки drawImage(all forms).
Если сглаживание изображений включено true, изображения будут масштабироваться с помощью фильтрации более высокого качества при преобразовании или масштабировании исходного изображения для соответствия целевому прямоугольнику.
Если сглаживание изображений выключено false, изображения будут масштабироваться без фильтрации (или с использованием фильтрации более низкого качества) при преобразовании или масштабировании исходного изображения для соответствия целевому прямоугольнику.

Значение по умолчанию:: true
Parameters:: imageSmoothing - true для включения или false для выключения сглаживания
Since:: 12

isImageSmoothing

public boolean isImageSmoothing()

Возвращает текущее состояние сглаживания изображения.

Значение по умолчанию:: true
Returns:: состояние сглаживания изображения
Since:: 12

beginPath

public void beginPath()

Сбрасывает текущий контур в пустое состояние. Контур по умолчанию пустой. Текущий контур — это атрибут контура, используемый для любых методов контура, как указано в таблице атрибутов отрисовки

public void beginPath()

, и не затрагивается операциями save() и restore().

moveTo

public void moveTo(double x0, double y0)

Выполняет команду перемещения для текущего контура в заданную координату x,y. Координаты преобразуются текущим преобразованием при добавлении в контур и не затрагиваются последующими изменениями преобразования. Текущий контур — это атрибут контура, используемый для любых методов контура, как указано в таблице атрибутов отрисовки

public void moveTo(double x0, double y0)

и не затрагивается операциями save() и restore().

Parameters:: x0 - положение X для команды перемещения.; y0 - положение Y для команды перемещения.

lineTo

public void lineTo(double x1, double y1)

Добавляет сегменты к текущему контуру, чтобы создать линию до заданной координаты x,y. Координаты преобразуются текущим преобразованием при добавлении в контур и не затрагиваются последующими изменениями преобразования. Текущий контур — это атрибут контура, используемый для любых методов контура, как указано в таблице атрибутов отрисовки

public void lineTo(double x1, double y1)

и не затрагивается операциями save() и restore().

Parameters:: x1 - координата X конечной точки линии.; y1 - координата Y конечной точки линии.

END_OF_DOCUMENT_MARKER

quadraticCurveTo

public void quadraticCurveTo(double xc, double yc, double x1, double y1)

Добавляет сегменты в текущую траекторию, чтобы создать квадратичную кривую Безье. Координаты преобразуются текущим преобразованием при добавлении в траекторию и не затрагиваются последующими изменениями преобразования. Текущая траектория — это атрибут траектории, используемый для любых методов траектории, как указано в таблице Атрибутов рендеринга, и не затрагивается операциями save() и restore().

Parameters:: xc - координата X контрольной точки; yc - координата Y контрольной точки; x1 - координата X конечной точки; y1 - координата Y конечной точки

bezierCurveTo

public void bezierCurveTo(double xc1, double yc1, double xc2, double yc2, double x1, double y1)

Добавляет сегменты в текущую траекторию, чтобы создать кубическую кривую Безье. Координаты преобразуются текущим преобразованием при добавлении в траекторию и не затрагиваются последующими изменениями преобразования. Текущая траектория — это атрибут траектории, используемый для любых методов траектории, как указано в таблице Атрибутов рендеринга, и не затрагивается операциями save() и restore().

Parameters:: xc1 - координата X первой контрольной точки Безье.; yc1 - координата Y первой контрольной точки Безье.; xc2 - координата X второй контрольной точки Безье.; yc2 - координата Y второй контрольной точки Безье.; x1 - координата X конечной точки.; y1 - координата Y конечной точки.

arcTo

public void arcTo(double x1, double y1, double x2, double y2, double radius)

Добавляет сегменты в текущую траекторию, чтобы создать дугу. Координаты преобразуются текущим преобразованием при добавлении в траекторию и не затрагиваются последующими изменениями преобразования. Текущая траектория — это атрибут траектории, используемый для любых методов траектории, как указано в таблице Атрибутов рендеринга, и не затрагивается операциями save() и restore().

Если p0 — текущая точка в траектории, и p1 — точка, заданная (x1, y1) и p2 — точка, заданная (x2, y2), то добавленные сегменты дуги будут сегментами по окружности круга, касающегося и вписанного во внутреннюю сторону p0->p1->p2. Траектория будет содержать сегмент прямой линии (при необходимости) до точки касания между этим кругом и p0->p1, за которым последуют сегменты дуги окружности, чтобы достичь точки касания между кругом и p1->p2, и завершится текущей точкой в этой точке касания (не в p2). Обратите внимание, что радиус и круговые сегменты дуги будут измеряться или рассматриваться относительно текущего преобразования, но полученные сегменты, рассчитанные из этих не преобразованных точек, будут преобразованы при добавлении в траекторию. Поскольку все вычисления выполняются в непространстве преобразования, но существующие сегменты траектории уже преобразованы, возможность правильного выполнения вычислений может неявно зависеть от возможности обратного преобразования текущего конца текущей траектории в координаты непространства преобразования.

Если по какой-либо причине невозможно вычислить и вписать указанный круг, то вся операция просто добавит сегменты, чтобы направить линию к точке p1. Возможные причины, по которым вычисления могут не удаться:

Текущая траектория пуста.
Сегменты p0->p1->p2 коллинеарны.
Текущее преобразование необратимо, поэтому текущую конечную точку текущей траектории нельзя обработать для вычислений.

Parameters:: x1 - координата X первой точки дуги.; y1 - координата Y первой точки дуги.; x2 - координата X второй точки дуги.; y2 - координата Y второй точки дуги.; radius - радиус дуги в диапазоне {0,0-положительная бесконечность}.

arc

public void arc(double centerX, double centerY, double radiusX, double radiusY, double startAngle, double length)

Добавляет элементы траектории в текущую траекторию, чтобы создать дугу, использующую градусы Евклида. Эта евклидова ориентация охватывает области от восток к север, затем запад, затем юг и обратно к востоку. Координаты преобразуются текущим преобразованием при добавлении в траекторию и не затрагиваются последующими изменениями преобразования. Текущая траектория — это атрибут траектории, используемый для любых методов траектории, как указано в таблице Атрибутов рендеринга, и не затрагивается операциями save() и restore().

Parameters:: centerX - центральная позиция x дуги.; centerY - центральная позиция y дуги.; radiusX - радиус x дуги.; radiusY - радиус y дуги.; startAngle - начальный угол дуги в диапазоне 0-360.0; length - длина базовой линии дуги.

rect

public void rect(double x, double y, double w, double h)

Добавляет элементы траектории в текущую траекторию, чтобы создать прямоугольник. Координаты преобразуются текущим преобразованием при добавлении в траекторию и не затрагиваются последующими изменениями преобразования. Текущая траектория — это атрибут траектории, используемый для любых методов траектории, как указано в таблице Атрибутов рендеринга, и не затрагивается операциями save() и restore().

Parameters:: x - положение x левого верхнего угла прямоугольника.; y - положение y левого верхнего угла прямоугольника.; w - ширина прямоугольника.; h - высота прямоугольника.

appendSVGPath

public void appendSVGPath(String svgpath)

Добавляет строку SVG Path в текущую траекторию. Если текущей траектории нет, строка должна начинаться с любого из команд перемещения. Значение null или некорректная строка SVG Path будут проигнорированы. Координаты преобразуются текущим преобразованием при добавлении в траекторию и не затрагиваются последующими изменениями преобразования. Текущая траектория — это атрибут траектории, используемый для любых методов траектории, как указано в таблице Атрибутов рендеринга, и не затрагивается операциями save() и restore().

Parameters:: svgpath - строка SVG Path.

closePath

public void closePath()

Закрывает траекторию. Текущая траектория — это атрибут траектории, используемый для любых методов траектории, как указано в таблице Атрибутов рендеринга, и не затрагивается операциями save() и restore().

fill

public void fill()

Заполняет траекторию текущей заливкой.

Этот метод будет затронут любыми из атрибутов общих глобальных, заливки или траектории, как указано в таблице Атрибутов рендеринга. Обратите внимание, что сегменты траектории были преобразованы при их первоначальном добавлении в текущую траекторию, поэтому текущее преобразование не повлияет на эти сегменты траектории снова, но может повлиять на другие атрибуты, действующие во время операции fill().

stroke

public void stroke()

Отображает траекторию текущей обводкой.

Этот метод будет затронут любыми из атрибутов общих глобальных, обводки или траектории, как указано в таблице Атрибутов рендеринга. Обратите внимание, что сегменты траектории были преобразованы при их первоначальном добавлении в текущую траекторию, поэтому текущее преобразование не повлияет на эти сегменты траектории снова, но может повлиять на другие атрибуты, действующие во время операции stroke().

clip

public void clip()

Пересекает текущий обрез с текущей траекторией и применяет его к последующей операции рендеринга как маску с антиалиасингом. Текущий обрез — это общий атрибут, используемый для почти всех операций рендеринга, как указано в таблице Атрибутов рендеринга.

Этот метод сам будет затронут только атрибутами траектории, как указано в таблице Атрибутов рендеринга. Обратите внимание, что сегменты траектории были преобразованы при их первоначальном добавлении в текущую траекторию, поэтому текущее преобразование не повлияет на эти сегменты траектории снова, но может повлиять на другие атрибуты, действующие во время операции stroke().

isPointInPath

public boolean isPointInPath(double x, double y)

Возвращает true, если заданная точка x,y находится внутри траектории.

Parameters:: x - координата X для проверки.; y - координата Y для проверки.
Returns:: true, если заданная точка находится внутри траектории, иначе false.

очиститьПрямоугольник

public void clearRect(double x, double y, double w, double h)

Очищает часть холста прозрачным цветом.

Этот метод будет затронут только текущим преобразованием, обрезкой и эффектом.

Параметры:: x - X-позиция верхнего левого угла прямоугольника.; y - Y-позиция верхнего левого угла прямоугольника.; w - ширина прямоугольника.; h - высота прямоугольника.

заполнитьПрямоугольник

public void fillRect(double x, double y, double w, double h)

Заполняет прямоугольник текущей заливкой.

Этот метод будет затронут любыми атрибутами общих настроек или заливки, как указано в таблице Атрибутов отрисовки.

Параметры:: x - позиция X верхнего левого угла прямоугольника.; y - позиция Y верхнего левого угла прямоугольника.; w - ширина прямоугольника.; h - высота прямоугольника.

нарисоватьКонтурПрямоугольника

public void strokeRect(double x, double y, double w, double h)

Рисует контур прямоугольника с использованием текущей обводки.

Этот метод будет затронут любыми атрибутами общих настроек или обводки, как указано в таблице Атрибутов отрисовки.

Параметры:: x - позиция X верхнего левого угла прямоугольника.; y - позиция Y верхнего левого угла прямоугольника.; w - ширина прямоугольника.; h - высота прямоугольника.

заполнитьОвал

public void fillOval(double x, double y, double w, double h)

Заполняет овал текущей заливкой.

Параметры:: x - координата X левого верхнего угла овала.; y - координата Y левого верхнего угла овала.; w - ширина овала по центру.; h - высота овала по центру.

нарисоватьКонтурОвала

public void strokeOval(double x, double y, double w, double h)

Рисует контур овала с использованием текущей обводки.

Параметры:: x - координата X левого верхнего угла овала.; y - координата Y левого верхнего угла овала.; w - ширина овала по центру.; h - высота овала по центру.

заполнитьДугу

public void fillArc(double x, double y, double w, double h, double startAngle, double arcExtent, ArcType closure)

Заполняет дугу текущей заливкой. null Тип дуги или не положительная ширина или высота приведет к игнорированию команды отрисовки.

Параметры:: x - координата X дуги.; y - координата Y дуги.; w - ширина дуги.; h - высота дуги.; startAngle - начальный угол дуги в градусах.; arcExtent - угловой охват дуги в градусах.; closure - тип замкнутости (Круг, Аккорд, Открытый) или null.

нарисоватьКонтурДуги

public void strokeArc(double x, double y, double w, double h, double startAngle, double arcExtent, ArcType closure)

Рисует контур дуги с использованием текущей обводки. null Тип дуги или не положительная ширина или высота приведет к игнорированию команды отрисовки.

Параметры:: x - координата X дуги.; y - координата Y дуги.; w - ширина дуги.; h - высота дуги.; startAngle - начальный угол дуги в градусах.; arcExtent - угловой охват дуги в градусах.; closure - тип замкнутости (Круг, Аккорд, Открытый) или null

заполнитьЗакругленныйПрямоугольник

public void fillRoundRect(double x, double y, double w, double h, double arcWidth, double arcHeight)

Заполняет закругленный прямоугольник текущей заливкой.

Параметры:: x - координата X левого верхнего угла овала.; y - координата Y левого верхнего угла овала.; w - ширина овала по центру.; h - высота овала по центру.; arcWidth - радиус скругления углов прямоугольника.; arcHeight - высота скругления углов прямоугольника.

нарисоватьКонтурЗакругленногоПрямоугольника

public void strokeRoundRect(double x, double y, double w, double h, double arcWidth, double arcHeight)

Рисует контур закругленного прямоугольника с использованием текущей обводки.

Параметры:: x - координата X левого верхнего угла овала.; y - координата Y левого верхнего угла овала.; w - ширина овала по центру.; h - высота овала по центру.; arcWidth - радиус скругления углов прямоугольника.; arcHeight - высота скругления углов прямоугольника.

нарисоватьЛинию

public void strokeLine(double x1, double y1, double x2, double y2)

Рисует линию с использованием текущей обводки.

Параметры:: x1 - координата X начальной точки линии.; y1 - координата Y начальной точки линии.; x2 - координата X конечной точки линии.; y2 - координата Y конечной точки линии.

заполнитьМногоугольник

public void fillPolygon(double[] xPoints, double[] yPoints, int nPoints)

Заполняет многоугольник с заданными точками текущей заливкой. null значение для любого из массивов будет проигнорировано, и ничего не будет нарисовано.

Этот метод будет затронут любыми атрибутами общих настроек, заливки или правила заливки, как указано в таблице Атрибутов отрисовки.

Параметры:: xPoints - массив с координатами x точек многоугольника или null.; yPoints - массив с координатами y точек многоугольника или null.; nPoints - количество точек, составляющих многоугольник.

нарисоватьКонтурМногоугольника

public void strokePolygon(double[] xPoints, double[] yPoints, int nPoints)

Рисует контур многоугольника с заданными точками с использованием текущей обводки. null значение для любого из массивов будет проигнорировано, и ничего не будет нарисовано.

Параметры:: xPoints - массив с координатами x точек многоугольника или null.; yPoints - массив с координатами y точек многоугольника или null.; nPoints - количество точек, составляющих многоугольник.

нарисоватьКонтурЛоманой

public void strokePolyline(double[] xPoints, double[] yPoints, int nPoints)

Рисует контур ломаной с заданными точками с использованием текущей обводки. null значение для любого из массивов будет проигнорировано, и ничего не будет нарисовано.

Параметры:: xPoints - массив с координатами x точек ломаной или null.; yPoints - массив с координатами y точек ломаной или null.; nPoints - количество точек, составляющих ломаную.

drawImage

public void drawImage(Image img, double x, double y)

Отображает изображение в заданной позиции x, y, используя ширину и высоту заданного изображения. Значение изображения null или изображение, которое ещё обрабатывается, будет проигнорировано.

Этот метод будет затронут любыми из глобальных общих или изображения атрибутов, как указано в Таблице атрибутов рендеринга.

Параметры:: img - изображение для отображения или null.; x - координата X на целевом элементе для верхнего левого угла изображения.; y - координата Y на целевом элементе для верхнего левого угла изображения.

drawImage

public void drawImage(Image img, double x, double y, double w, double h)

Отображает изображение в заданный прямоугольник назначения холста. Изображение масштабируется для соответствия прямоугольнику назначения. Значение изображения null или изображение, которое ещё обрабатывается, будет проигнорировано.

Параметры:: img - изображение для отображения или null.; x - координата X на целевом элементе для верхнего левого угла изображения.; y - координата Y на целевом элементе для верхнего левого угла изображения.; w - ширина прямоугольника назначения.; h - высота прямоугольника назначения.

drawImage

public void drawImage(Image img, double sx, double sy, double sw, double sh, double dx, double dy, double dw, double dh)

Отображает указанный прямоугольник источника заданного изображения в заданный прямоугольник назначения холста. Значение изображения null или изображение, которое ещё обрабатывается, будет проигнорировано.

Параметры:: img - изображение для отображения или null.; sx - координата X прямоугольника источника.; sy - координата Y прямоугольника источника.; sw - ширина прямоугольника источника.; sh - высота прямоугольника источника.; dx - координата X прямоугольника назначения.; dy - координата Y прямоугольника назначения.; dw - ширина прямоугольника назначения.; dh - высота прямоугольника назначения.

getPixelWriter

public PixelWriter getPixelWriter()

Возвращает объект PixelWriter, который может использоваться для изменения пикселей холста Canvas, связанного с этим GraphicsContext. Все координаты в методах PixelWriter возвращаемого объекта будут в пространстве устройства, так как они напрямую ссылаются на пиксели, и никакие другие атрибуты рендеринга не будут применяться при изменении пикселей с помощью этого объекта.

Возвращает:: объект PixelWriter для изменения пикселей этого Canvas

setEffect

public void setEffect(Effect e)

Устанавливает эффект, который будет применяться после следующего вызова draw, или null для отключения эффектов. Текущий эффект — это общий атрибут, используемый для почти всех операций рендеринга, как указано в Таблице атрибутов рендеринга.

Параметры:: e - эффект для использования, или null для отключения эффектов

getEffect

public Effect getEffect(Effect e)

Получает копию эффекта, который будет применяться после следующего вызова draw. Значение null означает, что после последующих вызовов рендеринга не будет применяться эффект. Текущий эффект — это общий атрибут, используемый для почти всех операций рендеринга, как указано в Таблице атрибутов рендеринга.

Параметры:: e - объект Effect, который может быть использован для хранения копии текущего эффекта, если он совместимого типа
Возвращает:: текущий эффект, используемый для всех вызовов рендеринга, или null, если текущего эффекта нет

applyEffect

public void applyEffect(Effect e)

Применяет заданный эффект ко всем границам холста и сохраняет результат обратно в тот же холст. Значение null будет проигнорировано. Эффект будет применён без других атрибутов рендеринга и под преобразованием координат Identity. Поскольку эффект применяется ко всем границам холста, некоторые эффекты могут иметь запутанный результат, например, эффект Reflection, который будет применять отражение от нижней части холста, даже если только часть холста была отрисована и не будет видна, если не использовать отрицательный смещение, чтобы вернуть отражение в поле зрения.

Параметры:: e - эффект, который нужно применить ко всему целевому элементу или null.

© 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.