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