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_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]
-
Устанавливает стиль штриховки для gc.
- Параметры:
-
- смещениеfloat
-
Расстояние в пунктах в шаблон штриховки, с которого необходимо начать шаблон. Обычно устанавливается в 0.
- список_штриховмассив-подобный или None
-
Последовательность включений-выключений в виде пунктов. None задает сплошную линию. Все остальные значения должны быть неотрицательными (\(\ge 0\)).
Примечания
См. стр. 666 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]
-
Устанавливает толщину линии в пунктах.
- классmatplotlib.backends.backend_cairo.RendererCairo(dpi)[source]
-
Базовые классы:
RendererBase- draw_image(gc, x, y, im)[source]
-
Отрисовка изображения RGBA.
- Параметры:
-
-
gc
GraphicsContextBase -
Контекст графики с информацией о обрезке.
- xскаляр
-
Расстояние в физических единицах (т.е., точках или пикселях) от левой стороны холста.
- yскаляр
-
Расстояние в физических единицах (т.е., точках или пикселях) от нижней стороны холста.
- im(N, M, 4) массив-подобный np.uint8
-
Массив пикселей RGBA.
-
transform
matplotlib.transforms.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 (исключая контрольные точки).
Базовая (резервная) реализация делает несколько вызовов
draw_path. Бэкенды могут переопределить этот метод, чтобы нарисовать маркер только один раз и повторно использовать его несколько раз.- Параметры:
-
-
gc
GraphicsContextBase -
Контекст графики.
-
marker_trans
Transform -
Аффинное преобразование, применяемое к маркерам.
-
trans
Transform -
Аффинное преобразование, применяемое к пути.
-
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
-
Положение y базы линии текста в координатах отображения.
- 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.
- new_gc()[source]
-
Возвращает экземпляр
GraphicsContextBase.
- points_to_pixels(points)[source]
-
Преобразование точек в единицы отображения.
Вам нужно переопределить эту функцию (если ваш бэкэнд не имеет dpi, например, postscript или svg). Некоторые системы отображения предполагают определенное значение пикселей на дюйм:
points to pixels = points * pixels_per_inch/72 * dpi/72
- Параметры:
-
- pointsfloat или массив-подобный объект
-
число с плавающей точкой или массив NumPy чисел с плавающей точкой
- Возвращает:
-
- Точки, преобразованные в пиксели
- set_context(ctx)[source]
- set_ctx_from_surface(surface)[source]
-
[Устарело]
Примечания
Устарело начиная с версии 3.6: Используйте set_context вместо этого.
- set_width_height(width, height)[source]
-
[Устарело]
Примечания
Устарело начиная с версии 3.6:
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.7.5/api/backend_cairo_api.html