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]

Устанавливает способ рисования концов линий.

Параметры:

csCapStyle или {'butt', 'projecting', 'round'}

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 Language Reference для получения дополнительной информации.

set_foreground(fg, isRGBA=None)[source]

Устанавливает цвет переднего плана.

Параметры:

fgцвет

isRGBAbool

Если известно, что fg является кортежем (r, g, b, a) , isRGBA можно установить в True для повышения производительности.

set_joinstyle(js)[source]

Устанавливает способ рисования соединений между отрезками линий.

Параметры:

jsJoinStyle или {'miter', 'round', 'bevel'}

set_linewidth(w)[source]

Устанавливает ширину линии в пунктах.

classmatplotlib.backends.backend_cairo.RendererCairo(dpi)[source]

Bases: RendererBase

draw_image(gc, x, y, im)[source]

Отобразить изображение RGBA.

Параметры:

gcGraphicsContextBase

Контекст графики с информацией о обрезке.

xскаляр

Расстояние в физических единицах (т.е. точках или пикселях) от левой стороны холста.

yскаляр

Расстояние в физических единицах (т.е. точках или пикселях) от нижней стороны холста.

im(N, M, 4) массив-подобный np.uint8

Массив пикселей RGBA.

transformmatplotlib.transforms.Affine2DBase

Если и только если конкретный бэкенд написан таким образом, что option_scale_image возвращает True, может быть передано аффинное преобразование (т.е. Affine2DBase) может быть передано в draw_image. Вектор сдвига преобразования задаётся в физических единицах (т.е. точках или пикселях). Обратите внимание, что преобразование не переопределяет x и y и должно быть применено перед переводом результата на x и y (это можно сделать, добавив x и y к вектору сдвига, определённому transform).

draw_markers(gc, marker_path, marker_trans, path, transform, rgbFace=None)[source]

Отобразить маркер в каждой из вершин path (исключая контрольные точки).

Базовое (fallback) реализация вызывает несколько вызовов draw_path. Бэкенды могут переопределить этот метод, чтобы отобразить маркер только один раз и повторно использовать его несколько раз.

Параметры:

gcGraphicsContextBase

Контекст графики.

marker_transmatplotlib.transforms.Transform

Аффинное преобразование, применяемое к маркерам.

transmatplotlib.transforms.Transform

Аффинное преобразование, применяемое к пути.

draw_path(gc, path, transform, rgbFace=None)[source]

Отобразить экземпляр Path с помощью заданного аффинного преобразования.

draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)[source]

Отобразить экземпляр текста.

Параметры:

gcGraphicsContextBase

Контекст графики.

xfloat

Позиция x текста в координатах отображения.

yfloat

Позиция y базовой линии текста в координатах отображения.

sstr

Строка текста.

propmatplotlib.font_manager.FontProperties

Свойства шрифта.

anglefloat

Угол поворота в градусах против часовой стрелки.

mtextmatplotlib.text.Text

Исходный объект текста, который нужно отобразить.

Примечания

Примечание для разработчиков бэкендов:

Когда вы пытаетесь определить, правильно ли вы получили прямоугольник обрезки (что необходимо для правильной работы выравнивания текста), вам поможет изменение строки в файле 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 со шрифтом FontProperties prop.

new_gc()[source]

Возвращает экземпляр GraphicsContextBase.

points_to_pixels(points)[source]

Преобразование точек в единицы отображения.

Вам нужно переопределить эту функцию (если ваш бэкэнд не имеет dpi, например, postscript или svg). Некоторые системы отображения предполагают какое-то значение для пикселей на дюйм:

points to pixels = points * pixels_per_inch/72 * dpi/72

Параметры:

pointsfloat или array-like

число с плавающей точкой или массив NumPy с плавающей точкой

Возвращаемое значение:

Преобразованные точки в пиксели

set_context(ctx)[source]

set_ctx_from_surface(surface)[source]

[Устарело]

Примечания

Устарело начиная с версии 3.6: Используйте set_context вместо этого.

set_width_height(width, height)[source]

[Устарело]

Примечания

Устарело начиная с версии 3.6: