matplotlib.backends.backend_agg

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

Реализованные функции:

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

Осталось сделать:

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

matplotlib.backends.backend_agg.FigureCanvas[source]

Псевдоним для FigureCanvasAgg

classmatplotlib.backends.backend_agg.FigureCanvasAgg(figure=None)[source]

Основы: FigureCanvasBase

buffer_rgba()[source]

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

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

copy_from_bbox(bbox)[source]

draw()[source]

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

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

get_renderer()[source]

print_jpeg(filename_or_obj, *, metadata=None, pil_kwargs=None)[source]

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

Параметры:

filename_or_objstr или путь или файл-подобный объект

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

pil_kwargsсловарь, необязательно

Дополнительные ключевые аргументы, передаваемые в PIL.Image.Image.save при сохранении изображения.

print_jpg(filename_or_obj, *, metadata=None, pil_kwargs=None)[source]

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

Параметры:

filename_or_objstr или путь или файл-подобный объект

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

pil_kwargsсловарь, необязательно

Дополнительные ключевые аргументы, передаваемые в PIL.Image.Image.save при сохранении изображения.

print_png(filename_or_obj, *, metadata=None, pil_kwargs=None)[source]

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

Параметры:

filename_or_objstr или путь или файл-подобный объект

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

metadataсловарь, необязательно

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

Спецификация PNG определяет некоторые общие ключевые слова, которые могут быть использованы как уместно:

• Название: Короткое (одна строка) название или подпись изображения.
• Автор: Имя создателя изображения.
• Описание: Описание изображения (возможно длинное).
• Авторские права: Предупреждение об авторских правах.
• Время создания: Время создания исходного изображения (обычно в формате RFC 1123).
• Программное обеспечение: Программное обеспечение, использованное для создания изображения.
• Отказ от ответственности: Правовая отметка об отказе от ответственности.
• Предупреждение: Предупреждение о характере содержимого.
• Источник: Устройство, использованное для создания изображения.
• Комментарий: Разнообразный комментарий; преобразование из другого формата изображения.

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

Если 'Software' не указан, будет использовано автоматически сгенерированное значение Matplotlib. Это можно удалить, установив его в None.

Для получения более подробной информации см. спецификацию PNG.

pil_kwargsсловарь, необязательно

Ключевые аргументы, передаваемые в PIL.Image.Image.save.

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

print_raw(filename_or_obj, *, metadata=None)[source]

print_rgba(filename_or_obj, *, metadata=None)[source]

print_tif(filename_or_obj, *, metadata=None, pil_kwargs=None)[source]

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

Параметры:

filename_or_objstr или путь или файл-подобный объект

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

pil_kwargsсловарь, необязательно

Дополнительные ключевые аргументы, передаваемые в PIL.Image.Image.save при сохранении изображения.

print_tiff(filename_or_obj, *, metadata=None, pil_kwargs=None)[source]

Вывести рисунок в файл TIFF.

Параметры:

filename_or_objстрока или объект пути или объект файла

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

pil_kwargsсловарь, необязательно

Дополнительные ключевые аргументы, передаваемые в PIL.Image.Image.save при сохранении рисунка.

print_to_buffer()[source]

print_webp(filename_or_obj, *, metadata=None, pil_kwargs=None)[source]

Вывести рисунок в файл WebP.

Параметры:

filename_or_objстрока или объект пути или объект файла

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

pil_kwargsсловарь, необязательно

Дополнительные ключевые аргументы, передаваемые в PIL.Image.Image.save при сохранении рисунка.

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

tostring_argb()[source]

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

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

tostring_rgb()[source]

[Устарело] Получить изображение в формате RGB bytes.

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

Примечания

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

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

Bases: RendererBase

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

buffer_rgba()[source]

clear()[source]

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

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

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

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

draw_tex(gc, x, y, s, prop, angle, *, mtext=None)[source]

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

Параметры:

gcGraphicsContextBase

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

xfloat

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

yfloat

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

sstr

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

propFontProperties

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

anglefloat

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

mtextText

Исходный объект текста для отрисовки.

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

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

Параметры:

gcGraphicsContextBase

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

xfloat

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

yfloat

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

sstr

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

propFontProperties

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

anglefloat

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

ismathbool or "TeX"

Если True, используется парсер mathtext. Если "TeX", используется TeX для отрисовки.

mtextText

Исходный объект текста для отрисовки.

get_canvas_width_height()[source]

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

get_text_width_height_descent(s, prop, ismath)[source]

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

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

option_image_nocomposite()[source]

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

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

option_scale_image()[source]

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

points_to_pixels(points)[source]

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

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

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

Параметры:

pointsfloat или массив

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

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

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

tostring_rgb()[source]

[Устарело]

Примечания

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

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