backend_cairo

Графический интерфейс Cairo для Matplotlib

Автор

Стив Чаплин и другие

Этот интерфейс зависит от cairocffi или pycairo.

matplotlib.backends.backend_cairo.FigureCanvas[source]

Псевдоним для matplotlib.backends.backend_cairo.FigureCanvasCairo

classmatplotlib.backends.backend_cairo.FigureCanvasCairo(figure=None)[source]

Базы: matplotlib.backend_bases.FigureCanvasBase

copy_from_bbox(bbox)[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: matplotlib.backend_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]

Устанавливает стиль пунктирной линии для контекста.

Параметры

dash_offsetfloat

Смещение (обычно 0).

dash_listпоследовательность или None

Последовательность включения/выключения, как точки. None задаёт сплошную линию.

Примечания

См. стр. 107 руководства PostScript по этой ссылке для получения дополнительной информации.

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: matplotlib.backend_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 (исключая контрольные точки).

Это реализация по умолчанию для draw_markers, которая выполняет несколько вызовов 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 в координатах отображения.

propertymathtext_parser[source]

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_ctx_from_surface(surface)[source]

set_width_height(width, height)[source]