matplotlib.backends.backend_agg

Бэкенд agg http://antigrain.com/

Реализованные возможности

• Стиль закруглений и соединений
• Штрихи
• Ширина линии
• Линии, прямоугольники, эллипсы
• Обрезка до прямоугольника
• Вывод в RGBA и PNG, опционально JPEG и TIFF
• Альфа-смешивание
• Правильное масштабирование DPI — всё масштабируется корректно (штрихи, ширина линий и т.д.)
• Рисование многоугольника
• freetype2 с ft2font

Задачи на будущее:

• Интеграция разрешения экрана (dpi) с ppi и текстом

matplotlib.backends.backend_agg.FigureCanvas

Псевдоним matplotlib.backends.backend_agg.FigureCanvasAgg

class matplotlib.backends.backend_agg.FigureCanvasAgg(figure) [source]

Наследуется от matplotlib.backend_bases.FigureCanvasBase

Поверхность для отрисовки фигуры. Вызывает методы draw и print fig, создаёт рендереры и т.д…

Атрибуты:	figure : matplotlib.figure.Figure Объект Figure высокого уровня

buffer_rgba() [source]

Получение изображения в формате RGBA в виде байтовой строки

draw должен быть вызван по крайней мере один раз перед работой этой функции и для обновления рендерера в случае последующих изменений фигуры.

Возвращает:	bytes

copy_from_bbox(bbox) [source]

draw() [source]

Отрисовка фигуры с помощью рендерера

get_renderer(cleared=False) [source]

print_jpeg(filename_or_obj, *args, **kwargs)

Дополнительные параметры:

quality : int Качество изображения от 1 (худшее) до 95 (лучшее). По умолчанию 95, если не указано в файле matplotlibrc в параметре savefig.jpeg_quality. Значения выше 95 следует избегать; 100 полностью отключает этап квантования JPEG. optimize : bool Если присутствует, указывает, что кодировщик должен выполнить дополнительный проход по изображению для выбора оптимальных параметров кодирования. progressive : bool Если присутствует, указывает, что это изображение должно быть сохранено как прогрессивное JPEG-файл.

print_jpg(filename_or_obj, *args, **kwargs) [source]

Дополнительные параметры:

quality : int Качество изображения от 1 (худшее) до 95 (лучшее). По умолчанию 95, если не указано в файле matplotlibrc в параметре savefig.jpeg_quality. Значения выше 95 следует избегать; 100 полностью отключает этап квантования JPEG. optimize : bool Если присутствует, указывает, что кодировщик должен выполнить дополнительный проход по изображению для выбора оптимальных параметров кодирования. progressive : bool Если присутствует, указывает, что это изображение должно быть сохранено как прогрессивное JPEG-файл.

print_png(filename_or_obj, *args, **kwargs) [source]

print_raw(filename_or_obj, *args, **kwargs) [source]

print_rgba(filename_or_obj, *args, **kwargs)

print_tif(filename_or_obj, *args, **kwargs) [source]

print_tiff(filename_or_obj, *args, **kwargs)

print_to_buffer() [source]

restore_region(region, bbox=None, xy=None) [source]

tostring_argb() [source]

Получение изображения в формате ARGB в виде байтовой строки

draw должен быть вызван по крайней мере один раз перед работой этой функции и для обновления рендерера в случае последующих изменений фигуры.

Возвращает:	bytes

tostring_rgb() [source]

Получение изображения в формате RGB в виде байтовой строки

draw должен быть вызван по крайней мере один раз перед работой этой функции и для обновления рендерера в случае последующих изменений фигуры.

Возвращает:	bytes

class matplotlib.backends.backend_agg.RendererAgg(width, height, dpi) [source]

Базы: matplotlib.backend_bases.RendererBase

Рендерер обрабатывает все примитивы отрисовки с помощью экземпляра графического контекста, который управляет цветами/стилями

buffer_rgba() [source]

clear() [source]

debug

Устарело начиная с версии 2.2: Функция debug устарела в версии 2.2.

draw_markers(*kl, **kw) [source]

Отрисовывает маркер в каждой из вершин в пути. Это включает все вершины, включая контрольные точки на кривых. Чтобы избежать этого поведения, эти вершины должны быть удалены перед вызовом этой функции.

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

Параметры:	gc : GraphicsContextBase Графический контекст marker_trans : matplotlib.transforms.Transform Аффинное преобразование, применяемое к маркеру. trans : matplotlib.transforms.Transform Аффинное преобразование, применяемое к пути.

draw_mathtext(gc, x, y, s, prop, angle) [source]

Отрисовка математического текста с использованием matplotlib.mathtext

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

Отрисовка пути

draw_path_collection(*kl, **kw) [source]

Отрисовывает коллекцию путей, выбирая свойства отрисовки из списков facecolors, edgecolors, linewidths, linestyles и antialiaseds. offsets — список смещений, которые нужно применить к каждому из путей. Смещения в offsets сначала преобразуются с помощью offsetTrans перед применением. offset_position может быть либо "screen", либо "data", в зависимости от пространства, в котором находятся смещения.

Это реализация по умолчанию для draw_path_collection(), которая выполняет несколько вызовов draw_path(). Некоторые бэкэнды могут переопределить этот метод, чтобы отрисовать каждый набор данных пути только один раз, а затем использовать этот путь несколько раз с различными смещениями, цветами, стилями и т. д. Методы-генераторы _iter_collection_raw_paths() и _iter_collection() предназначены для помощи (и стандартизации) реализации в различных бэкэндах. Настоятельно рекомендуется использовать эти генераторы, чтобы изменения в поведении draw_path_collection() можно было применять глобально.

draw_tex(gc, x, y, s, prop, angle, ismath='TeX!', mtext=None) [source]

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

Отрисовка текста

get_canvas_width_height() [source]

возвращает ширину и высоту холста в координатах отображения

get_text_width_height_descent(s, prop, ismath) [source]

Получает ширину, высоту и спуск (смещение от нижней границы до базовой линии) в координатах отображения строки s с FontProperties prop

lock = <unlocked _thread.RLock object owner=0 count=0>

option_image_nocomposite() [source]

переопределите этот метод для рендереров, которые не всегда хотят масштабировать и компоновать растровые изображения. (например, SVG, PDF или PS)

option_scale_image() [source]

бэкэнд agg не поддерживает произвольное масштабирование изображений.

points_to_pixels(points) [source]

преобразовать единицы измерения точек в пиксели, используя dpi и разрешение дисплея в пикселях на дюйм

restore_region(region, bbox=None, xy=None) [source]

Восстановить сохраненную область. Если задан bbox (экземпляр BboxBase или его пределы), будет восстановлена только область, заданная bbox. xy (кортеж из двух чисел с плавающей точкой) необязательно указывает новую позицию (левая нижняя точка исходной области, а не bbox), где будет восстановлена область.

>>> region = renderer.copy_from_bbox()
>>> x1, y1, x2, y2 = region.get_extents()
>>> renderer.restore_region(region, bbox=(x1+dx, y1, x2, y2),
...                         xy=(x1-dx, y1))

start_filter() [source]

Начать фильтрацию. Просто создает новый холст (старый сохраняется).

stop_filter(post_processing) [source]

Сохранить график на текущем холсте как изображение и применить функцию post_processing.

def post_processing(image, dpi):

# ny, nx, depth = image.shape # изображение (массив numpy) имеет каналы RGBA и глубину 4. ... # создать новое изображение (массив numpy из 4 каналов, размер может быть # другим). Результирующее изображение может иметь смещения от # нижней левой точки исходного изображения return new_image, offset_x, offset_y

Сохраненный рендерер восстанавливается, и возвращаемое изображение из post_processing отображается (с помощью draw_image) на нем.

tostring_argb() [source]

tostring_rgb() [source]

tostring_rgba_minimized() [source]

matplotlib.backends.backend_agg.get_hinting_flag() [source]