- 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Да BLACKPaintдля применения к внутреннему пространству фигур при операции заливки.Атрибуты обводки Stroke PaintДа BLACKPaintдля применения к границе фигур при операции обводки.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Метод, используемый для определения внутренней части путей для операции заполнения или обрезки пути. Различные методы отрисовки на
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
- См. также:
Canvas
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание voidappendSVGPath(String svgpath)Добавляет строку SVG Path к текущей траектории.voidapplyEffect(Effect e)Применяет заданный эффект ко всему периметру холста и сохраняет результат обратно в тот же холст.voidarc(double centerX, double centerY, double radiusX, double radiusY, double startAngle, double length)Добавляет элементы траектории, чтобы создать дугу, использующую градусы Евклида.voidarcTo(double x1, double y1, double x2, double y2, double radius)Добавляет сегменты в текущую траекторию, чтобы создать дугу.voidbeginPath()Сбрасывает текущую траекторию на пустую.voidbezierCurveTo(double xc1, double yc1, double xc2, double yc2, double x1, double y1)Добавляет сегменты в текущую траекторию, чтобы создать кубическую кривую Безье.voidclearRect(double x, double y, double w, double h)Очищает часть холста прозрачным цветом.voidclip()Пересекает текущую область обрезки с текущей траекторией и применяет её к последующим операциям отрисовки как маску с антиалиасингом.voidclosePath()Закрывает траекторию.voiddrawImage(Image img, double x, double y)Отрисовывает изображение в заданной позиции x, y, используя ширину и высоту заданного изображения.voiddrawImage(Image img, double x, double y, double w, double h)Отрисовывает изображение в заданный прямоугольник назначения холста.voiddrawImage(Image img, double sx, double sy, double sw, double sh, double dx, double dy, double dw, double dh)Отрисовывает указанный прямоугольник источника заданного изображения в заданный прямоугольник назначения холста.voidfill()Заливает траекторию текущей краской заливки.voidfillArc(double x, double y, double w, double h, double startAngle, double arcExtent, ArcType closure)Заливает дугу текущей краской заливки.voidfillOval(double x, double y, double w, double h)Заливает овал текущей краской заливки.voidfillPolygon(double[] xPoints, double[] yPoints, int nPoints)Заливает многоугольник с заданными точками текущей краской заливки.voidfillRect(double x, double y, double w, double h)Заливает прямоугольник текущей краской заливки.voidfillRoundRect(double x, double y, double w, double h, double arcWidth, double arcHeight)Заливает прямоугольник с закругленными углами текущей краской заливки.voidfillText(String text, double x, double y)Заливает заданную строку текста в позиции x, y текущей краской заливки.voidfillText(String text, double x, double y, double maxWidth)Заливает текст и включает максимальную ширину строки.CanvasgetCanvas()ВозвращаетCanvas, которомуGraphicsContextвыдает команды отрисовки.EffectgetEffect(Effect e)Возвращает копию эффекта, который будет применён после следующего вызова draw.PaintgetFill()Возвращает текущую краску заливки.FillRulegetFillRule()Получает атрибут правила заливки для определения внутренней части траекторий в операциях заливки и обрезки.FontgetFont()Возвращает текущий шрифт.FontSmoothingTypegetFontSmoothingType()Возвращает текущий тип сглаживания шрифта.doublegetGlobalAlpha()Возвращает текущий глобальный альфа-канал.BlendModegetGlobalBlendMode()Возвращает глобальный режим смешивания.StrokeLineCapgetLineCap()Возвращает текущее значение закругления концов линии.double[]getLineDashes()Возвращает копию текущего массива пунктирной линии.doublegetLineDashOffset()Возвращает текущий смещение пунктирной линии.StrokeLineJoingetLineJoin()Возвращает текущее соединение концов линии.doublegetLineWidth()Возвращает текущую толщину линии.doublegetMiterLimit()Возвращает текущий предел срезания.PixelWritergetPixelWriter()Возвращает объектPixelWriter, который можно использовать для изменения пикселейCanvas, связанных с этимGraphicsContext.PaintgetStroke()Возвращает текущую обводку.TextAlignmentgetTextAlign()Возвращает текущуюTextAlignment.VPosgetTextBaseline()Возвращает текущую базовую линию текста.AffinegetTransform()Возвращает копию текущего преобразования.AffinegetTransform(Affine xform)Копирует текущее преобразование в предоставленный объект, создавая новый объектAffine, если он равен null, и возвращает объект, содержащий копию.booleanisPointInPath(double x, double y)Возвращает true, если заданная точка x,y находится внутри траектории.
voidlineTo(double x1, double y1)Добавляет сегменты к текущему пути, чтобы создать линию до заданных координат x, y.voidmoveTo(double x0, double y0)Выполняет команду перемещения для текущего пути в заданные координаты x, y.voidquadraticCurveTo(double xc, double yc, double x1, double y1)Добавляет сегменты к текущему пути, чтобы создать квадратичную кривую Безье.voidrect(double x, double y, double w, double h)Добавляет элементы пути в текущий путь, чтобы создать прямоугольник.voidrestore()Извлекает состояние из стека, устанавливая следующие атрибуты в значения, которые они имели в момент, когда это состояние было помещено в стек.voidrotate(double degrees)Поворачивает текущее преобразование на указанный угол в градусах.voidsave()Сохраняет следующие атрибуты в стеке.voidscale(double x, double y)Масштабирует текущее преобразование на x, y.voidsetEffect(Effect e)Устанавливает эффект, который будет применён после следующего вызова draw, или null для отключения эффектов.voidsetFill(Paint p)Устанавливает текущий атрибут заливки.voidsetFillRule(FillRule fillRule)Устанавливает правило заливки для определения внутренности пути при операциях заливки или обрезки.voidsetFont(Font f)Устанавливает текущий шрифт.voidsetFontSmoothingType(FontSmoothingType fontsmoothing)Устанавливает текущий тип сглаживания шрифта.voidsetGlobalAlpha(double alpha)Устанавливает глобальный альфа-канал текущего состояния.voidsetGlobalBlendMode(BlendMode op)Устанавливает глобальный режим смешивания.voidsetLineCap(StrokeLineCap cap)Устанавливает текущую форму окончания линии обводки.voidsetLineDashes(double... dashes)Устанавливает текущую пунктирную линию обводки, используя нормализованную копию аргумента.voidsetLineDashOffset(double dashOffset)Устанавливает смещение пунктирной линии.voidsetLineJoin(StrokeLineJoin join)Устанавливает текущую форму соединения линии обводки.voidsetLineWidth(double lw)Устанавливает текущую ширину линии.voidsetMiterLimit(double ml)Устанавливает текущее значение предела скругления.voidsetStroke(Paint p)Устанавливает текущий атрибут обводки.voidsetTextAlign(TextAlignment align)Определяет выравнивание текста по горизонтали относительно начала текстаx.voidsetTextBaseline(VPos baseline)Устанавливает текущую линию базовой черты текста.voidsetTransform(double mxx, double myx, double mxy, double myy, double mxt, double myt)Устанавливает текущее преобразование.voidsetTransform(Affine xform)Устанавливает текущее преобразование.voidstroke()Выполняет обводку пути с использованием текущего атрибута обводки.voidstrokeArc(double x, double y, double w, double h, double startAngle, double arcExtent, ArcType closure)Выполняет обводку дуги с использованием текущего атрибута обводки.voidstrokeLine(double x1, double y1, double x2, double y2)Выполняет обводку линии с использованием текущего атрибута обводки.voidstrokeOval(double x, double y, double w, double h)Выполняет обводку овала с использованием текущего атрибута обводки.voidstrokePolygon(double[] xPoints, double[] yPoints, int nPoints)Выполняет обводку многоугольника с заданными точками с использованием текущего атрибута обводки.voidstrokePolyline(double[] xPoints, double[] yPoints, int nPoints)Выполняет обводку ломаной с заданными точками с использованием текущего атрибута обводки.voidstrokeRect(double x, double y, double w, double h)Выполняет обводку прямоугольника с использованием текущего атрибута обводки.voidstrokeRoundRect(double x, double y, double w, double h, double arcWidth, double arcHeight)Выполняет обводку скругленного прямоугольника с использованием текущего атрибута обводки.voidstrokeText(String text, double x, double y)Отображает заданную строку текста в позиции x, y с использованием текущего атрибута обводки.voidstrokeText(String text, double x, double y, double maxWidth)Отображает текст с обводкой и включает максимальную ширину строки.voidtransform(double mxx, double myx, double mxy, double myy, double mxt, double myt)Конкатенирует входные данные с текущим преобразованием.voidtransform(Affine xform)Конкатенирует входные данные с текущим преобразованием.voidtranslate(double x, double y)Перемещает текущее преобразование на x, y.
-
Подробное описание методов
-
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.
-
getGlobalBlendMode
public BlendMode getGlobalBlendMode()
Получает глобальный режим смешивания. Значение по умолчанию —SRC_OVER. Режим смешивания — это общий атрибут, используемый почти во всех методах рендеринга, как указано в таблице Атрибутов рендеринга.- Возвращает:
- глобальный режим смешивания текущего состояния.
-
setFill
public void setFill(Paint p)
Устанавливает текущий атрибут кисти заливки. Значение по умолчанию —BLACK. Кисть заливки — это атрибут заливки, используемый в методах заливки, как указано в таблице Атрибутов рендеринга. Значениеnullбудет проигнорировано, и текущее значение останется неизменным.- Параметры:
-
p- Кисть заливки, используемая в качестве атрибута заливки, или null.
-
getFill
public Paint getFill()
Получает текущий атрибут кисти заливки. Значение по умолчанию —BLACK. Кисть заливки — это атрибут заливки, используемый в методах заливки, как указано в таблице Атрибутов рендеринга.- Возвращает:
- Кисть заливки, используемая в качестве атрибута заливки.
-
setStroke
public void setStroke(Paint p)
Устанавливает текущий атрибут кисти обводки. Значение по умолчанию —BLACK. Кисть обводки — это атрибут обводки, используемый в методах обводки, как указано в таблице Атрибутов рендеринга. Значениеnullбудет проигнорировано, и текущее значение останется неизменным.- Параметры:
-
p- Кисть обводки, используемая в качестве атрибута обводки, или null.
-
getStroke
public Paint getStroke()
Получает текущую кисть обводки. Значение по умолчанию —BLACK. Кисть обводки — это атрибут обводки, используемый в методах обводки, как указано в таблице Атрибутов рендеринга.- Возвращает:
- Кисть обводки, используемая в качестве атрибута обводки.
-
-
setLineWidth
public void setLineWidth(double lw)
Устанавливает текущую ширину линии. Значение по умолчанию —1.0. Ширина линии — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга. Значение бесконечности или не положительное значение вне диапазона(0, +inf)будет проигнорировано, и текущее значение останется неизменным.- Параметры:
-
lw— значение в диапазоне {0-положительная бесконечность}, любое другое значение будет проигнорировано, и значение останется без изменений.
-
getLineWidth
public double getLineWidth()
Получает текущую ширину линии. Значение по умолчанию —1.0. Ширина линии — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга.- Возвращает:
- значение между 0 и бесконечностью.
-
setLineCap
public void setLineCap(StrokeLineCap cap)
Устанавливает текущий тип окончания линии обводки. Значение по умолчанию —SQUARE. Тип окончания линии — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга. Значениеnullбудет проигнорировано, и текущее значение останется неизменным.- Параметры:
-
cap—StrokeLineCapсо значением Butt, Round или Square или null.
-
getLineCap
public StrokeLineCap getLineCap()
Получает текущий тип окончания линии обводки. Значение по умолчанию —SQUARE. Тип окончания линии — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга.- Возвращает:
-
StrokeLineCapсо значением Butt, Round или Square.
-
setLineJoin
public void setLineJoin(StrokeLineJoin join)
Устанавливает текущий тип соединения линий обводки. Значение по умолчанию —StrokeLineJoin.MITER. Тип соединения линий — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга. Значениеnullбудет проигнорировано, и текущее значение останется неизменным.- Параметры:
-
join—StrokeLineJoinсо значением Miter, Bevel или Round или null.
-
getLineJoin
public StrokeLineJoin getLineJoin()
Получает текущий тип соединения линий обводки. Значение по умолчанию —StrokeLineJoin.MITER. Тип соединения линий — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга.- Возвращает:
-
StrokeLineJoinсо значением Miter, Bevel или Round.
-
setMiterLimit
public void setMiterLimit(double ml)
Устанавливает текущее значение предела скругления. Значение по умолчанию —10.0. Предел скругления — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга. Значение бесконечности или не положительное значение вне диапазона(0, +inf)будет проигнорировано, и текущее значение останется неизменным.- Параметры:
-
ml— значение предела скругления в диапазоне от 0 до положительной бесконечности; любое другое значение будет проигнорировано, и значение останется без изменений.
-
getMiterLimit
public double getMiterLimit()
Получает текущее значение предела скругления. Значение по умолчанию —10.0. Предел скругления — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга.- Возвращает:
- значение предела скругления в диапазоне
0.0-positive infinity
-
setLineDashes
public void setLineDashes(double... dashes)
Устанавливает текущую схему штриховки обводки на нормализованную копию аргумента. Значение по умолчанию —null. Массив штриховки — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга. Если массивnull, пуст или содержит только0элементы, штриховка будет отключена, и текущий массив штриховки будет установлен наnull. Если какой-либо элемент массива имеет отрицательное, бесконечное или NaN значение вне диапазона[0, +inf), весь массив будет проигнорирован, и текущий массив штриховки останется без изменений. Если длина массива нечетная, она будет обрабатываться так, как если бы она состояла из двух копий массива, добавленных друг к другу.- Параметры:
-
dashes— массив конечных неотрицательных длин штрихов - С:
- JavaFX 8u40
-
getLineDashes
public double[] getLineDashes()
Получает копию текущего массива штриховки. Значение по умолчанию —null. Массив может быть нормализован тестами валидации в методеsetLineDashes(double...). Массив штриховки — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга.- Возвращает:
- копию текущего массива штриховки.
- С:
- JavaFX 8u40
-
setLineDashOffset
public void setLineDashOffset(double dashOffset)
Устанавливает смещение штриховки линии. Значение по умолчанию —0.0. Смещение штриховки линии — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга. Значение бесконечности или NaN вне диапазона(-inf, +inf)будет проигнорировано, и текущее значение останется неизменным.- Параметры:
-
dashOffset— смещение штриховки линии в диапазоне(-inf, +inf) - С:
- JavaFX 8u40
-
getLineDashOffset
public double getLineDashOffset()
Получает текущее смещение штриховки линии. Значение по умолчанию —0.0. Смещение штриховки линии — это атрибут обводки, используемый для любых методов обводки, как указано в таблице атрибутов рендеринга.- Возвращает:
- смещение штриховки линии в диапазоне
(-inf, +inf) - С:
- JavaFX 8u40
-
setFont
public void setFont(Font f)
Устанавливает текущий шрифт. Значение по умолчанию задано вFont.getDefault(). Шрифт — это атрибут текста, используемый для любых методов работы с текстом, как указано в таблице атрибутов рендеринга. Значениеnullбудет проигнорировано, и текущее значение останется неизменным.- Параметры:
-
f— шрифт или null.
-
getFont
public Font getFont()
Получает текущий шрифт. Значение по умолчанию задано вFont.getDefault(). Шрифт — это атрибут текста, используемый для любых методов работы с текстом, как указано в таблице атрибутов рендеринга.- Возвращает:
- шрифт
-
setFontSmoothingType
public void setFontSmoothingType(FontSmoothingType fontsmoothing)
Устанавливает текущий тип сглаживания шрифта. Значение по умолчанию —GRAY. Тип сглаживания шрифта — это атрибут текста, используемый для любых методов работы с текстом, как указано в таблице атрибутов рендеринга. Значениеnullбудет проигнорировано, и текущее значение останется неизменным.Примечание, что значение
FontSmoothingTypeLCDподдерживается только на непрозрачном фоне.LCDтекст обычно отображается какGRAYтекст на прозрачных или полупрозрачных пикселях, и в некоторых реализациях он может вообще не поддерживаться наCanvas, так как необходимая поддержка отсутствует для поверхностей, содержащих альфа-канал, как у всехCanvasобъектов.- Параметры:
-
fontsmoothing—FontSmoothingTypeили null - С:
- JavaFX 8u40
-
getFontSmoothingType
public FontSmoothingType getFontSmoothingType()
Получает текущий тип сглаживания шрифта. Значение по умолчанию —GRAY. Тип сглаживания шрифта — это атрибут текста, используемый для любых методов работы с текстом, как указано в таблице атрибутов рендеринга.- Возвращает:
-
FontSmoothingType - С:
- JavaFX 8u40
-
-
setTextAlign
public void setTextAlign(TextAlignment align)
Определяет горизонтальное выравнивание текста относительно начала текстаx. Значение по умолчанию —LEFT. Выравнивание текста — это атрибут текста, используемый для любых методов работы с текстом, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга.Пусть горизонтальные границы представляют собой логическую ширину одной строки текста. Каждая строка текста имеет отдельные горизонтальные границы.
Тогда выравнивание текста задается следующим образом:
- Слева: левый край горизонтальных границ будет в позиции
x. - По центру: центр, находящийся посередине между левым и правым краем, горизонтальных границ будет в позиции
x. - Справа: правый край горизонтальных границ будет в позиции
x.
Примечание: холст не поддерживает перенос слов, поэтому выравнивание текста по ширине идентично выравниванию по левому краю.
Значение
nullбудет проигнорировано, и текущее значение останется неизменным.- Параметры:
-
align—TextAlignmentсо значениями Слева, Центр, Справа или null.
- Слева: левый край горизонтальных границ будет в позиции
-
getTextAlign
public TextAlignment getTextAlign()
Возвращает текущее выравниваниеTextAlignment. Значение по умолчанию —LEFT. Выравнивание текста — это атрибут текста, используемый для любых методов работы с текстом, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга.- Возвращает:
-
TextAlignmentсо значениями Слева, Центр, Справа или Выравнивание.
-
setTextBaseline
public void setTextBaseline(VPos baseline)
Устанавливает текущую линию основания текста. Значение по умолчанию —BASELINE. Линия основания текста — это атрибут текста, используемый для любых методов работы с текстом, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга. Значениеnullбудет проигнорировано, и текущее значение останется неизменным.- Параметры:
-
baseline—VPosсо значениями Верх, Центр, Основание или Низ или null.
-
getTextBaseline
public VPos getTextBaseline()
Возвращает текущую линию основания текста. Значение по умолчанию —BASELINE. Линия основания текста — это атрибут текста, используемый для любых методов работы с текстом, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга.- Возвращает:
-
VPosсо значениями Верх, Центр, Основание или Низ
-
fillText
public void fillText(String text, double x, double y)
Заполняет заданную строку текста в позиции x, y текущим атрибутом заливки. Значениеnullтекста будет проигнорировано.Этот метод будет затронут любыми глобальными общими, атрибутами заливки или текста, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга.
- Параметры:
-
text— строка текста или null. -
x— позиция по оси x. -
y— позиция по оси y.
-
strokeText
public void strokeText(String text, double x, double y)
Рисует заданную строку текста в позиции x, y с текущим атрибутом обводки. Значениеnullтекста будет проигнорировано.Этот метод будет затронут любыми глобальными общими, атрибутами обводки или текста, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга.
- Параметры:
-
text— строка текста или null. -
x— позиция по оси x. -
y— позиция по оси y.
-
fillText
public void fillText(String text, double x, double y, double maxWidth)
Заполняет текст и включает максимальную ширину строки. Если ширина текста превышает максимальную ширину, она будет уменьшена для соответствия. Значениеnullтекста будет проигнорировано.Этот метод будет затронут любыми глобальными общими, атрибутами заливки или текста, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга.
- Параметры:
-
text— строка текста или null. -
x— позиция по оси x. -
y— позиция по оси y. -
maxWidth— максимальная ширина строки текста.
-
strokeText
public void strokeText(String text, double x, double y, double maxWidth)
Рисует текст с атрибутом обводки и включает максимальную ширину строки. Если ширина текста превышает максимальную ширину, она будет уменьшена для соответствия. Значениеnullтекста будет проигнорировано.Этот метод будет затронут любыми глобальными общими, атрибутами обводки или текста, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга.
- Параметры:
-
text— строка текста или null. -
x— позиция по оси x. -
y— позиция по оси y. -
maxWidth— максимальная ширина строки текста.
-
setFillRule
public void setFillRule(FillRule fillRule)
Устанавливает атрибут правила заливки для определения внутренней части путей при операциях заливки или обрезки. Значение по умолчанию —FillRule.NON_ZERO. Значениеnullбудет проигнорировано, и текущее значение останется неизменным. Правило заливки — это атрибут пути, используемый для любых методов заливки или обрезки пути, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга.- Параметры:
-
fillRule—FillRuleсо значением Even_odd или Non_zero или null.
-
getFillRule
public FillRule getFillRule()
Возвращает атрибут правила заливки для определения внутренней части путей при операциях заливки и обрезки. Значение по умолчанию —FillRule.NON_ZERO. Правило заливки — это атрибут пути, используемый для любых методов заливки или обрезки пути, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга.- Возвращает:
- текущее правило заливки.
-
beginPath
public void beginPath()
Сбрасывает текущий путь в пустое состояние. Путь по умолчанию пустой. Текущий путь — это атрибут пути, используемый для любых методов работы с путём, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга и не изменяется операциямиsave()иrestore().
-
moveTo
public void moveTo(double x0, double y0)Выполняет команду перемещения текущего пути в заданные координаты x,y. Координаты преобразуются текущим преобразованием при добавлении в путь и не изменяются последующими изменениями преобразования. Текущий путь — это атрибут пути, используемый для любых методов работы с путём, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга и не изменяется операциямиsave()иrestore().- Параметры:
-
x0— позиция X для команды перемещения. -
y0— позиция Y для команды перемещения.
-
lineTo
public void lineTo(double x1, double y1)Добавляет отрезки в текущий путь для создания линии до заданных координат x,y. Координаты преобразуются текущим преобразованием при добавлении в путь и не изменяются последующими изменениями преобразования. Текущий путь — это атрибут пути, используемый для любых методов работы с путём, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга и не изменяется операциямиsave()иrestore().- Параметры:
-
x1— координата X конечной точки линии. -
y1— координата Y конечной точки линии.
-
quadraticCurveTo
public void quadraticCurveTo(double xc, double yc, double x1, double y1)Добавляет отрезки в текущий путь для создания квадратичной кривой Безье. Координаты преобразуются текущим преобразованием при добавлении в путь и не изменяются последующими изменениями преобразования. Текущий путь — это атрибут пути, используемый для любых методов работы с путём, как указано в таблице атрибутов рендеринга Таблица атрибутов рендеринга и не изменяется операциямиsave()иrestore().- Параметры:
-
xc— координата X контрольной точки -
yc— координата Y контрольной точки -
x1— координата X конечной точки -
y1— координата Y конечной точки
-
-
bezierCurveTo
public void bezierCurveTo(double xc1, double yc1, double xc2, double yc2, double x1, double y1)Добавляет сегменты в текущую траекторию, чтобы создать кубическую кривую Безье. Координаты преобразуются текущим преобразованием при добавлении в траекторию и не затрагиваются последующими изменениями преобразования. Текущая траектория — это атрибут path, используемый для любых методов траектории, как указано в таблице Атрибутов отрисовки, и не затрагивается операциямиsave()иrestore().- Параметры:
-
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)Добавляет сегменты в текущую траекторию, чтобы создать дугу. Координаты преобразуются текущим преобразованием при добавлении в траекторию и не затрагиваются последующими изменениями преобразования. Текущая траектория — это атрибут path, используемый для любых методов траектории, как указано в таблице Атрибутов отрисовки, и не затрагивается операциямиsave()иrestore().Если
p0является текущей точкой в траектории, аp1— точкой, заданной(x1, y1)иp2— точкой, заданной(x2, y2), то добавляемые сегменты дуги будут сегментами по окружности круга заданного радиуса, касающегося и вписанного во внутреннюю сторону выпуклостиp0->p1->p2. Траектория будет содержать отрезки прямой (если необходимо) до точки касания этого круга иp0->p1, за которыми последуют сегменты круговой дуги для достижения точки касания между кругом иp1->p2, и закончится текущей точкой в этой точке касания (не вp2). Обратите внимание, что радиус и окружность сегментов дуги будут измеряться или рассматриваться относительно текущего преобразования, но полученные сегменты, вычисленные из этих не преобразованных точек, будут преобразованы при добавлении в траекторию. Поскольку все вычисления выполняются в не преобразованном пространстве, но существующие сегменты траектории все преобразуются, способность правильно выполнить вычисление может неявно зависеть от возможности обратного преобразования текущего конца текущей траектории в не преобразованные координаты.Если по какой-либо причине невозможно вычислить и вписать указанный круг, то вся операция просто добавит сегменты, чтобы нарисовать линию до точки
p1. Возможные причины, по которым вычисление может завершиться неудачей:- Текущая траектория пуста.
- Сегменты
p0->p1->p2коллинеарны. - текущее преобразование не обратимо, поэтому текущую конечную точку текущей траектории нельзя преобразовать обратно для вычисления.
- Параметры:
-
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)Добавляет элементы траектории в текущую траекторию, чтобы создать дугу, использующую градусы в системе Евклида. Эта евклидова ориентация охватывает точки с востока на север, затем запад, затем юг, затем обратно на восток. Координаты преобразуются текущим преобразованием при добавлении в траекторию и не затрагиваются последующими изменениями преобразования. Текущая траектория — это атрибут path, используемый для любых методов траектории, как указано в таблице Атрибутов отрисовки, и не затрагивается операциямиsave()иrestore().- Параметры:
-
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)Добавляет элементы траектории в текущую траекторию, чтобы создать прямоугольник. Координаты преобразуются текущим преобразованием при добавлении в траекторию и не затрагиваются последующими изменениями преобразования. Текущая траектория — это атрибут path, используемый для любых методов траектории, как указано в таблице Атрибутов отрисовки, и не затрагивается операциямиsave()иrestore().- Параметры:
-
x- положение X левого верхнего угла прямоугольника. -
y- положение Y левого верхнего угла прямоугольника. -
w- ширина прямоугольника. -
h- высота прямоугольника.
-
appendSVGPath
public void appendSVGPath(String svgpath)
Добавляет строку SVG Path в текущую траекторию. Если текущей траектории нет, строка должна начинаться с команды перемещения. Значениеnullили некорректный путь SVG будут проигнорированы. Координаты преобразуются текущим преобразованием при добавлении в траекторию и не затрагиваются последующими изменениями преобразования. Текущая траектория — это атрибут path, используемый для любых методов траектории, как указано в таблице Атрибутов отрисовки, и не затрагивается операциямиsave()иrestore().- Параметры:
-
svgpath- строка SVG Path.
-
closePath
public void closePath()
Закрывает траекторию. Текущая траектория — это атрибут path, используемый для любых методов траектории, как указано в таблице Атрибутов отрисовки, и не затрагивается операциями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 находится внутри траектории.- Параметры:
-
x- координата X для проверки. -
y- координата Y для проверки. - Возвращает:
- true, если заданная точка находится внутри траектории, иначе false.
-
clearRect
public void clearRect(double x, double y, double w, double h)Очищает часть холста прозрачным цветом.Этот метод будет затронут только текущим преобразованием, областью обрезки и эффектом.
- Параметры:
-
x- положение X левого верхнего угла прямоугольника. -
y- положение Y левого верхнего угла прямоугольника. -
w- ширина прямоугольника. -
h- высота прямоугольника.
-
-
fillRect
public void fillRect(double x, double y, double w, double h)Заполняет прямоугольник текущей краской заливки.Этот метод будет затронут любыми из глобальных общих или атрибутов заливки, как указано в Таблице атрибутов рендеринга.
- Параметры:
-
x- положение X верхнего левого угла прямоугольника. -
y- положение Y верхнего левого угла прямоугольника. -
w- ширина прямоугольника. -
h- высота прямоугольника.
-
strokeRect
public void strokeRect(double x, double y, double w, double h)Отображает контур прямоугольника с помощью текущей красящей кисти контура.Этот метод будет затронут любыми из глобальных общих или атрибутов контура, как указано в Таблице атрибутов рендеринга.
- Параметры:
-
x- положение X верхнего левого угла прямоугольника. -
y- положение Y верхнего левого угла прямоугольника. -
w- ширина прямоугольника. -
h- высота прямоугольника.
-
fillOval
public void fillOval(double x, double y, double w, double h)Заполняет овал текущей краской заливки.Этот метод будет затронут любыми из глобальных общих или атрибутов заливки, как указано в Таблице атрибутов рендеринга.
- Параметры:
-
x- координата X левой верхней границы овала. -
y- координата Y левой верхней границы овала. -
w- ширина по центру овала. -
h- высота по центру овала.
-
strokeOval
public void strokeOval(double x, double y, double w, double h)Отображает контур овала с помощью текущей красящей кисти контура.Этот метод будет затронут любыми из глобальных общих или атрибутов контура, как указано в Таблице атрибутов рендеринга.
- Параметры:
-
x- координата X левой верхней границы овала. -
y- координата Y левой верхней границы овала. -
w- ширина по центру овала. -
h- высота по центру овала.
-
fillArc
public void fillArc(double x, double y, double w, double h, double startAngle, double arcExtent, ArcType closure)Заполняет дугу текущей краской заливки.nullArcType или неположительная ширина или высота приведут к игнорированию команды рендеринга.Этот метод будет затронут любыми из глобальных общих или атрибутов заливки, как указано в Таблице атрибутов рендеринга.
- Параметры:
-
x- координата X дуги. -
y- координата Y дуги. -
w- ширина дуги. -
h- высота дуги. -
startAngle- начальный угол дуги в градусах. -
arcExtent- угловой охват дуги в градусах. -
closure- тип замкнутости (Round, Chord, Open) или null.
-
strokeArc
public void strokeArc(double x, double y, double w, double h, double startAngle, double arcExtent, ArcType closure)Отображает контур дуги с помощью текущей красящей кисти контура.nullArcType или неположительная ширина или высота приведут к игнорированию команды рендеринга.Этот метод будет затронут любыми из глобальных общих или атрибутов контура, как указано в Таблице атрибутов рендеринга.
- Параметры:
-
x- координата X дуги. -
y- координата Y дуги. -
w- ширина дуги. -
h- высота дуги. -
startAngle- начальный угол дуги в градусах. -
arcExtent- угловой охват дуги в градусах. -
closure- тип замкнутости (Round, Chord, Open) или null
-
fillRoundRect
public void fillRoundRect(double x, double y, double w, double h, double arcWidth, double arcHeight)Заполняет скругленный прямоугольник текущей краской заливки.Этот метод будет затронут любыми из глобальных общих или атрибутов заливки, как указано в Таблице атрибутов рендеринга.
- Параметры:
-
x- координата X левой верхней границы овала. -
y- координата Y левой верхней границы овала. -
w- ширина по центру овала. -
h- высота по центру овала. -
arcWidth- ширина дуги углов прямоугольника. -
arcHeight- высота дуги углов прямоугольника.
-
strokeRoundRect
public void strokeRoundRect(double x, double y, double w, double h, double arcWidth, double arcHeight)Отображает контур скругленного прямоугольника с помощью текущей красящей кисти контура.Этот метод будет затронут любыми из глобальных общих или атрибутов контура, как указано в Таблице атрибутов рендеринга.
- Параметры:
-
x- координата X левой верхней границы овала. -
y- координата Y левой верхней границы овала. -
w- ширина по центру овала. -
h- высота по центру овала. -
arcWidth- ширина дуги углов прямоугольника. -
arcHeight- высота дуги углов прямоугольника.
-
strokeLine
public void strokeLine(double x1, double y1, double x2, double y2)Отображает линию с помощью текущей красящей кисти контура.Этот метод будет затронут любыми из глобальных общих или атрибутов контура, как указано в Таблице атрибутов рендеринга.
- Параметры:
-
x1- координата X начальной точки линии. -
y1- координата Y начальной точки линии. -
x2- координата X конечной точки линии. -
y2- координата Y конечной точки линии.
-
fillPolygon
public void fillPolygon(double[] xPoints, double[] yPoints, int nPoints)Заполняет многоугольник с заданными точками текущей краской заливки. Значениеnullдля любого из массивов будет проигнорировано, и ничего не будет нарисовано.Этот метод будет затронут любыми из глобальных общих, атрибутов заливки или правил заливки, как указано в Таблице атрибутов рендеринга.
- Параметры:
-
xPoints- массив, содержащий координаты x точек многоугольника или null. -
yPoints- массив, содержащий координаты y точек многоугольника или null. -
nPoints- количество точек, образующих многоугольник.
-
strokePolygon
public void strokePolygon(double[] xPoints, double[] yPoints, int nPoints)Отображает контур многоугольника с заданными точками с помощью текущей красящей кисти контура. Значениеnullдля любого из массивов будет проигнорировано, и ничего не будет нарисовано.Этот метод будет затронут любыми из глобальных общих или атрибутов контура, как указано в Таблице атрибутов рендеринга.
- Параметры:
-
xPoints- массив, содержащий координаты x точек многоугольника или null. -
yPoints- массив, содержащий координаты y точек многоугольника или null. -
nPoints- количество точек, образующих многоугольник.
-
strokePolyline
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.