Класс GraphicsContext

java.lang.Object

javafx.scene.canvas.GraphicsContext

public final class GraphicsContext extends Object

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

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

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

Вызов любого метода на 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);

С момента:

JavaFX 2.2

См. также:

Canvas

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

Modifier and Type	Method	Description
`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)`	Получает копию эффекта, который должен быть применён после следующего вызова рисования.
`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)`	Устанавливает эффект, который должен быть применён после следующего вызова рисования, или 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)`	Устанавливает текущее ограничение фаски.

END_OF_DOCUMENT_MARKER

`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. Можно установить любое действительное число, но только значения в диапазоне [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 - устанавливаемый или null BlendMode.

getGlobalBlendMode

public BlendMode getGlobalBlendMode()

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

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

setFill

public void setFill(Paint p)

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

Параметры:: p - Paint, используемый как атрибут заливки Paint или null.

getFill

public Paint getFill()

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

Возвращает:: Paint, используемый как атрибут заливки Paint.

setStroke

public void setStroke(Paint p)

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

Параметры:

p -

public Paint getStroke()

, используемый как атрибут штриха BLACK или null.

getStroke

public Paint getStroke()

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

Возвращает:: Paint, используемый как атрибут штриха 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.