Документация Engee

poly

Страница в процессе перевода.

poly(vertices, indices; kwargs...)
poly(points; kwargs...)
poly(shape; kwargs...)
poly(mesh; kwargs...)

Строит многоугольник на основе заданных аргументов. Если заданы вершины и индексы, действует аналогично mesh. Если заданы точки, отрисовывает один многоугольник, соединяющий все точки по порядку. Если задана форма (по сути, любой объект, разлагаемый на GeometryBasics), строит decompose(shape).

poly(coordinates, connectivity; kwargs...)

Строит многоугольники, которые определяются coordinates (координатами вершин) и connectivity (ребрами между вершинами).

Тип графика

Псевдоним типа графика для функции poly — Poly.

Примеры

using CairoMakie
using Makie.GeometryBasics


f = Figure()
Axis(f[1, 1])

poly!(Point2f[(0, 0), (2, 0), (3, 1), (1, 1)], color = :red, strokecolor = :black, strokewidth = 1)

f
629b1f1

using CairoMakie
using Makie.GeometryBasics


f = Figure()
Axis(f[1, 1])

# многоугольник с отверстием
p = Polygon(
    Point2f[(0, 0), (2, 0), (3, 1), (1, 1)],
    [Point2f[(0.75, 0.25), (1.75, 0.25), (2.25, 0.75), (1.25, 0.75)]]
)

poly!(p, color = :blue)

f
278b9ad

using CairoMakie
using Makie.GeometryBasics


f = Figure()
Axis(f[1, 1])

# вектор фигур
poly!(
    [Rect(i, j, 0.75, 0.5) for i in 1:5 for j in 1:3],
    color = 1:15,
    colormap = :heat
)

f
5ec6ebc

using CairoMakie
using Makie.GeometryBasics


f = Figure()
Axis(f[1, 1], aspect = DataAspect())

# разложение фигуры
poly!(Circle(Point2f(0, 0), 15f0), color = :pink)

f
64ed6ef

using CairoMakie
using Makie.GeometryBasics


f = Figure()
Axis(f[1, 1]; backgroundcolor = :gray15)

# вектор многоугольников
ps = [Polygon(rand(Point2f, 3) .+ Point2f(i, j))
    for i in 1:5 for j in 1:10]

poly!(ps, color = rand(RGBf, length(ps)))

f
5c3ceab

using CairoMakie
using Makie.GeometryBasics


f = Figure()
Axis(f[1, 1])

# вектор фигур
poly!(
    [Rect(i, j, 0.75, 0.5) for i in 1:5 for j in 1:3],
    color = :white,
    strokewidth = 2,
    strokecolor = 1:15,
    strokecolormap=:plasma,
)

f
e05edbc

Атрибуты

alpha

Значение по умолчанию: 1.0
альфа-значение цветовой карты или атрибута цвета. Несколько альфа-значений, как в plot(alpha=0.2, color=(:red, 0.5), перемножаются.

clip_planes

Значение по умолчанию: automatic
плоскости отсечения позволяют выполнять отсечение в трехмерном пространстве. Здесь можно указать вектор из 8 плоскостей Plane3f, за которыми графики будут отсечены (т. е. станут невидимыми). По умолчанию плоскости отсечения наследуются от родительского графика или сцены. Чтобы удалить родительский объект clip_planes, передайте Plane3f[].

color

Значение по умолчанию: @inherit patchcolor
задает цвет многоугольника. Значением может быть вектор Vector{<:Colorant} для разных цветов вершин или один объект Colorant. Для окрашивания сетки текстурой можно использовать Matrix{<:Colorant}, при этом сетка должна содержать координаты текстуры. Кроме того, можно использовать векторы или матрицы чисел. При этом числа с цветами будут сопоставляться посредством аргументов цветовой карты. Чтобы залить многоугольник однообразным штриховым узором, можно использовать Makie.LinePattern.

colormap

Значение по умолчанию: @inherit colormap :viridis
задает цветовую карту, из которой производится выборка для числовых значений color. Также можно использовать PlotUtils.cgrad(...), Makie.Reverse(any_colormap) или любой символ из ColorBrewer или PlotUtils. Чтобы увидеть все доступные цветовые градиенты, можно вызвать Makie.available_gradients().

colorrange

Значение по умолчанию: automatic
значения, представляющие начальную и конечную точки colormap.

colorscale

Значение по умолчанию: identity
функция преобразования цвета. Может быть любой функцией, но с Colorbar хорошо работают только identity, log, log2, log10, sqrt, logit, Makie.pseudolog10 и Makie.Symlog10.

cycle

Значение по умолчанию: [:color => :patchcolor]
документация недоступна.

depth_shift

Значение по умолчанию: 0.0
корректирует значение глубины графика после всех остальных преобразований, т. е. в пространстве отсечения, где 0 <= depth <= 1. Применимо только к GLMakie и WGLMakie и может использоваться для настройки порядка отрисовки (настраиваемая перерисовка).

fxaa

Значение по умолчанию: true
определяет то, будет ли график отрисовываться с помощью fxaa (сглаживание, только GLMakie).

highclip

Значение по умолчанию: automatic
цвет для любого значения выше цветового диапазона.

inspectable

Значение по умолчанию: true
определяет, должен ли график проверяться с помощью DataInspector.

inspector_clear

Значение по умолчанию: automatic
задает функцию обратного вызова (inspector, plot) -> ... для очистки пользовательских индикаторов в DataInspector.

inspector_hover

Значение по умолчанию: automatic
задает функцию обратного вызова (inspector, plot, index) -> ..., которая заменяет методы show_data по умолчанию.

inspector_label

Значение по умолчанию: automatic
задает функцию обратного вызова (plot, index, position) -> string, которая заменяет метку по умолчанию, сгенерированную DataInspector.

joinstyle

Значение по умолчанию: @inherit joinstyle
документация недоступна.

linecap

Значение по умолчанию: @inherit linecap
документация недоступна.

linestyle

Значение по умолчанию: nothing
задает стиль штриховой линии. Возможные значения: :solid (эквивалентно nothing), :dot, :dash, :dashdot и :dashdotdot. Можно также задать в виде кортежа с модификатором стиля пробела: :normal, :dense или :loose. Например, (:dot, :loose) или (:dashdot, :dense).

Если нужен пользовательский стиль, см. описание Makie.Linestyle.

lowclip

Значение по умолчанию: automatic
цвет для любого значения ниже цветового диапазона.

miter_limit

Значение по умолчанию: @inherit miter_limit
документация недоступна.

model

Значение по умолчанию: automatic
задает модельную матрицу для графика. Переопределяет настройки, выполненные с помощью translate!, rotate! и scale!.

nan_color

Значение по умолчанию: :transparent
цвет для значений NaN.

overdraw

Значение по умолчанию: false
определяет то, будет ли график отрисовываться поверх других графиков. В частности, это означает игнорирование проверок глубины в бэкендах GL.

shading

Значение по умолчанию: NoShading
документация недоступна.

space

Значение по умолчанию: :data
задает пространство преобразования для прямоугольника, охватывающего график. Возможные входные данные см. в описании Makie.spaces().

ssao

Значение по умолчанию: false
определяет то, будет ли график отрисовываться с использованием ssao (преграждение окружающего света в экранном пространстве). Обратите внимание, что это имеет смысл только для трехмерных графиков и применимо только с fxaa = true.

stroke_depth_shift

Значение по умолчанию: -1.0e-5
смещение глубины штрихового графика. Полезно для предотвращения z-конфликтов между штриховкой и заливкой.

strokecolor

Значение по умолчанию: @inherit patchstrokecolor
задает цвет контура вокруг маркера.

strokecolormap

Значение по умолчанию: @inherit colormap
задает цветовую карту, из которой производится выборка числовых значений color.

strokewidth

Значение по умолчанию: @inherit patchstrokewidth
задает толщину контура.

transformation

Значение по умолчанию: automatic
документация недоступна.

transparency

Значение по умолчанию: false
определяет то, как реализуется прозрачность графика. В GLMakie transparency = true приводит к использованию прозрачности, независимой от порядка.

visible

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