matplotlib.backends.backend_agg

Бэкенд Anti-Grain Geometry (AGG).

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

стили концов и соединений линий
пунктирные линии
толщина линий
линии, прямоугольники, эллипсы
отсечение по прямоугольнику
вывод в RGBA и форматы изображений, поддерживаемые Pillow
смешивание с альфа-каналом
корректное масштабирование DPI — масштабируется всё (штрихи, толщина линий и т. д.)
рисование многоугольников
freetype2 с ft2font

В планах:

интегрировать DPI экрана с PPI и текстом

matplotlib.backends.backend_agg.FigureCanvas[исходный код]: псевдоним FigureCanvasAgg

classmatplotlib.backends.backend_agg.FigureCanvasAgg(figure=None)[исходный код]

Базовые классы: FigureCanvasBase

buffer_rgba()[исходный код]

Получить изображение в виде memoryview для буфера средства визуализации.

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

copy_from_bbox(bbox)[исходный код]

draw()[исходный код]

Отобразить Figure.

Этот метод должен обходить дерево объектов-художников, даже если вывод не создаётся, поскольку он запускает отложенные операции, к которым пользователям может потребоваться доступ до сохранения вывода на диск. Например, вычисление пределов, автоматических пределов и значений делений.

get_renderer()[исходный код]

print_jpeg(filename_or_obj, *, metadata=None, pil_kwargs=None)[исходный код]

Записать рисунок в файл JPEG.

Параметры:

filename_or_objstr or path-like or file-like: Файл для записи.
pil_kwargsdict, optional: Дополнительные именованные аргументы, передаваемые в PIL.Image.Image.save при сохранении рисунка.

print_jpg(filename_or_obj, *, metadata=None, pil_kwargs=None)[исходный код]

Записать рисунок в файл JPEG.

Параметры:

filename_or_objstr or path-like or file-like: Файл для записи.
pil_kwargsdict, optional: Дополнительные именованные аргументы, передаваемые в PIL.Image.Image.save при сохранении рисунка.

print_png(filename_or_obj, *, metadata=None, pil_kwargs=None)[исходный код]

Записать рисунок в файл PNG.

Параметры:

filename_or_objstr or path-like or file-like

Файл для записи.

metadatadict, optional

Метаданные файла PNG в виде пар «ключ — значение»: байты или строки, кодируемые в latin-1. Согласно спецификации PNG, длина ключа должна быть меньше 79 символов.

Спецификация PNG определяет несколько распространённых ключевых слов, которые можно использовать по назначению:

Title: краткий (в одну строку) заголовок или подпись к изображению.
Author: имя создателя изображения.
Description: описание изображения (возможно, длинное).
Copyright: уведомление об авторских правах.
Creation Time: время создания исходного изображения (обычно в формате RFC 1123).
Software: программное обеспечение, использованное для создания изображения.
Disclaimer: отказ от ответственности.
Warning: предупреждение о характере содержимого.
Source: устройство, использованное для создания изображения.
Comment: произвольный комментарий; преобразование из другого формата изображения.

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

Если ключ 'Software' не задан, будет использоваться автоматически сгенерированное значение для Matplotlib. Чтобы убрать его, задайте None.

Дополнительные сведения см. в спецификации PNG.

pil_kwargsdict, optional

Именованные аргументы, передаваемые в PIL.Image.Image.save.

Если присутствует ключ 'pnginfo', он полностью переопределяет metadata, включая ключ 'Software', используемый по умолчанию.

print_raw(filename_or_obj, *, metadata=None)[исходный код]

print_rgba(filename_or_obj, *, metadata=None)[исходный код]

print_tif(filename_or_obj, *, metadata=None, pil_kwargs=None)[исходный код]

Записать рисунок в файл TIFF.

Параметры:

filename_or_objstr or path-like or file-like: Файл для записи.
pil_kwargsdict, optional: Дополнительные именованные аргументы, передаваемые в PIL.Image.Image.save при сохранении рисунка.

print_tiff(filename_or_obj, *, metadata=None, pil_kwargs=None)[исходный код]

Записать рисунок в файл TIFF.

Параметры:

filename_or_objstr or path-like or file-like: Файл для записи.
pil_kwargsdict, optional: Дополнительные именованные аргументы, передаваемые в PIL.Image.Image.save при сохранении рисунка.

print_to_buffer()[исходный код]

print_webp(filename_or_obj, *, metadata=None, pil_kwargs=None)[исходный код]

Записать рисунок в файл WebP.

Параметры:

filename_or_objstr or path-like or file-like: Файл для записи.
pil_kwargsdict, optional: Дополнительные именованные аргументы, передаваемые в PIL.Image.Image.save при сохранении рисунка.

restore_region(region, bbox=None, xy=None)[исходный код]

tostring_argb()[исходный код]

Получить изображение в виде bytes в формате ARGB.

classmatplotlib.backends.backend_agg.RendererAgg(width, height, dpi)[исходный код]

Базовые классы: RendererBase

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

buffer_rgba()[исходный код]

clear()[исходный код]

draw_mathtext(gc, x, y, s, prop, angle)[исходный код]: Рисует mathtext с помощью matplotlib.mathtext.

draw_path(gc, path, transform, rgbFace=None)[исходный код]: Рисует экземпляр Path с помощью заданного аффинного преобразования.

draw_tex(gc, x, y, s, prop, angle, *, mtext=None)[исходный код]

Рисует экземпляр TeX.

Параметры:

gcGraphicsContextBase: Графический контекст.
xfloat: Координата x текста в координатах дисплея.
yfloat: Координата y базовой линии текста в координатах дисплея.
sstr: Текстовая строка TeX.
propFontProperties: Свойства шрифта.
anglefloat: Угол поворота в градусах против часовой стрелки.
mtextText: Исходный текстовый объект для отображения.

draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)[исходный код]

Рисует текстовый объект.

Параметры:

gcGraphicsContextBase: Графический контекст.
xfloat: Координата x текста в координатах дисплея.
yfloat: Координата y базовой линии текста в координатах дисплея.
sstr: Текстовая строка.
propFontProperties: Свойства шрифта.
anglefloat: Угол поворота в градусах против часовой стрелки.
ismathbool or "TeX": Если True, использовать парсер mathtext.
mtextText: Исходный текстовый объект для отображения.

Примечания

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

RendererBase.draw_text также поддерживает передачу "TeX" в параметр ismath для использования отображения TeX, но это не обязательно для реальных бэкендов отрисовки, и многие встроенные бэкенды эту возможность не поддерживают. Отображение TeX обеспечивается методом draw_tex.

get_canvas_width_height()[исходный код]: Возвращает ширину и высоту холста в координатах дисплея.

get_text_width_height_descent(s, prop, ismath)[исходный код]

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

Пробелы в начале и конце s учитываются в возвращаемой ширине.

option_image_nocomposite()[исходный код]

Возвращает, следует ли пропустить объединение изображений средствами Matplotlib.

Растровые бэкенды обычно должны возвращать False (позволяя растеризатору на уровне C выполнять объединение изображений); векторные бэкенды обычно должны возвращать not rcParams["image.composite_image"].

option_scale_image()[исходный код]: Возвращает, поддерживаются ли произвольные аффинные преобразования в draw_image (True для большинства векторных бэкендов).

points_to_pixels(points)[исходный код]

Преобразует пункты в единицы дисплея.

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

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

Параметры:

pointsfloat or array-like

Возвращает:

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

restore_region(region, bbox=None, xy=None)[исходный код]

Восстанавливает сохраненную область. Если задан 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()[исходный код]: Запускает фильтрацию. Создается новый холст (старый сохраняется).

stop_filter(post_processing)[исходный код]

Сохраняет текущий холст как изображение и выполняет постобработку.

Функция post_processing:

def post_processing(image, dpi):
  # ny, nx, depth = image.shape
  # image (numpy array) has RGBA channels and has a depth of 4.
  ...
  # create a new_image (numpy array of 4 channels, size can be
  # different). The resulting image may have offsets from
  # lower-left corner of the original image
  return new_image, offset_x, offset_y

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

tostring_argb()[исходный код]

matplotlib.backends.backend_agg.get_hinting_flag()[исходный код]