matplotlib.backends.backend_cairo
Фронтенд Cairo для Matplotlib
- Автор:
-
Стив Чаплин и другие
Этот фронтенд зависит от cairocffi или pycairo.
- matplotlib.backends.backend_cairo.FigureCanvas[source]
-
Псевдоним для
FigureCanvasCairo
- classmatplotlib.backends.backend_cairo.FigureCanvasCairo(figure=None)[source]
-
Базы:
FigureCanvasBase- copy_from_bbox(bbox)[source]
- get_renderer()[source]
- print_pdf(fobj, *, orientation='portrait')
- print_png(fobj)[source]
- print_ps(fobj, *, orientation='portrait')
- print_raw(fobj)[source]
- print_rgba(fobj)[source]
- print_svg(fobj, *, orientation='portrait')
- print_svgz(fobj, *, orientation='portrait')
- restore_region(region)[source]
- classmatplotlib.backends.backend_cairo.GraphicsContextCairo(renderer)[source]
-
Bases:
GraphicsContextBase- get_antialiased()[source]
-
Возвращает, следует ли объекту пытаться выполнить рендеринг сглаживанием.
- get_rgb()[source]
-
Возвращает кортеж из трёх или четырёх чисел с плавающей точкой от 0 до 1.
- restore()[source]
-
Восстанавливает контекст графики из стека — необходимо только для тех бэкэндов, которые сохраняют контексты графики в стеке.
- set_alpha(alpha)[source]
-
Устанавливает значение альфа-канала, используемое для смешивания — не поддерживается во всех бэкэндах.
Если
alpha=None(по умолчанию), компоненты альфа-канала переднего и заливки будут использованы для установки их прозрачности (если применимо); в противном случае,alphaпереопределит их.
- set_antialiased(b)[source]
-
Устанавливает, следует ли объекту рисовать сглаживанием.
- set_capstyle(cs)[source]
-
Устанавливает, как рисовать концы линий.
- Параметры:
-
-
cs
CapStyleили {'butt', 'projecting', 'round'}
-
cs
- set_clip_path(path)[source]
-
Устанавливает обрезной путь на
TransformedPathили None.
- set_clip_rectangle(rectangle)[source]
-
Устанавливает обрезной прямоугольник на
Bboxили None.
- set_dashes(offset, dashes)[source]
-
Устанавливает стиль пунктирной линии для контекста графики.
- Параметры:
-
- dash_offsetfloat
-
Расстояние в пунктах от начала пунктирной линии до указанной точки.
- dash_listпоследовательность или None
-
Последовательность включений/выключений. None задаёт сплошную линию. Все значения должны быть неотрицательными (\(\ge 0\)).
Примечания
Для получения дополнительной информации см. стр. 666 справки языка PostScript по языку PostScript.
- set_foreground(fg, isRGBA=None)[source]
-
Устанавливает цвет переднего плана.
- Параметры:
-
- fgцвет
- isRGBAbool
-
Если известно, что fg является
(r, g, b, a)кортежем, isRGBA можно установить в True для повышения производительности.
- set_joinstyle(js)[source]
-
Устанавливает, как рисовать соединения между отрезками линий.
- Параметры:
-
-
js
JoinStyleили {'miter', 'round', 'bevel'}
-
js
- set_linewidth(w)[source]
-
Устанавливает ширину линии в пунктах.
- classmatplotlib.backends.backend_cairo.RendererCairo(dpi)[source]
-
Базы:
RendererBase- draw_image(gc, x, y, im)[source]
-
Отобразить изображение в формате RGBA.
- Параметры:
-
-
gc
GraphicsContextBase -
Контекст графики с информацией о обрезке.
- xскаляр
-
Расстояние в физических единицах (т.е. точки или пиксели) от левой стороны холста.
- yскаляр
-
Расстояние в физических единицах (т.е. точки или пиксели) от нижней стороны холста.
-
im(N, M, 4) массив
numpy.uint8 -
Массив пикселей в формате RGBA.
-
transform
Affine2DBase -
Если и только если конкретный бэкэнд написан таким образом, что
option_scale_imageвозвращаетTrue, может быть передано аффинное преобразование (т.е.,Affine2DBase) может быть передано вdraw_image. Вектор сдвига преобразования задан в физических единицах (т.е. точки или пиксели). Обратите внимание, что преобразование не переопределяет x и y и должно быть применено до перевода результата на x и y (это можно сделать, добавив x и y к вектору сдвига, определённому параметром transform).
-
gc
- draw_markers(gc, marker_path, marker_trans, path, transform, rgbFace=None)[source]
-
Отобразить маркер в каждой вершине path (исключая точки управления).
Базовая (fallback) реализация выполняет несколько вызовов
draw_path. Бэкэнды могут переопределить этот метод, чтобы отобразить маркер только один раз и использовать его несколько раз.- Параметры:
-
-
gc
GraphicsContextBase -
Контекст графики.
-
marker_path
Path -
Путь для маркера.
-
marker_trans
Transform -
Аффинное преобразование, применяемое к маркеру.
-
path
Path -
Позиции для отображения маркеров.
-
trans
Transform -
Аффинное преобразование, применяемое к пути.
- rgbFaceцвет, необязательно
-
gc
- draw_path(gc, path, transform, rgbFace=None)[source]
-
Отобразить объект
Pathс заданным аффиным преобразованием.
- draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)[source]
-
Отобразить текстовый объект.
- Параметры:
-
-
gc
GraphicsContextBase -
Контекст графики.
- xfloat
-
Позиция x текста в координатах отображения.
- yfloat
-
Позиция базовой линии текста в координатах отображения.
- sstr
-
Строка текста.
-
prop
FontProperties -
Свойства шрифта.
- anglefloat
-
Угол поворота в градусах против часовой стрелки.
- ismathbool или "TeX"
-
Если True, использовать парсер mathtext. Если "TeX", использовать tex для рендеринга.
-
mtext
Text -
Исходный объект текста для рендеринга.
-
gc
Примечания
Примечание для разработчиков бэкэндов:
При попытке определить, правильно ли вы рассчитали рамку (что необходимо для правильной работы расположения и выравнивания текста), полезно изменить строку в text.py:
if 0: bbox_artist(self, renderer)
на if 1, и тогда вместе с текстом будет отображаться и сама рамка.
- get_canvas_width_height()[source]
-
Возвращает ширину и высоту холста в координатах отображения.
- get_text_width_height_descent(s, prop, ismath)[source]
-
Возвращает ширину, высоту и спуск (смещение от нижней точки до базовой линии) в координатах отображения строки s со свойствами шрифта
FontPropertiesprop.Пробелы в начале и в конце строки s учитываются при расчёте ширины.
- new_gc()[source]
-
Возвращает экземпляр
GraphicsContextBase.
- points_to_pixels(points)[source]
-
Преобразует точки в единицы отображения.
Вам необходимо переопределить эту функцию (если ваш бэкэнд не имеет разрешения dpi, например, postscript или svg). Некоторые системы изображений предполагают некоторое значение для пикселей на дюйм:
points to pixels = points * pixels_per_inch/72 * dpi/72
- Параметры:
-
- pointsfloat или массив-подобный объект
- Возвращает:
-
- Преобразованные в пиксели точки
- set_context(ctx)[source]
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.8.4/api/backend_cairo_api.html