matplotlib.backends.backend_svg

matplotlib.backends.backend_svg.FigureCanvas[source]: псевдоним FigureCanvasSVG

classmatplotlib.backends.backend_svg.FigureCanvasSVG(figure=None)[source]

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

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

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

filetypes={'svg': 'Scalable Vector Graphics', 'svgz': 'Scalable Vector Graphics'}

fixed_dpi=72

get_default_filetype()[source]

Возвращает стандартный формат сохранения файла, как указано в rcParams["savefig.format"] (по умолчанию: 'png').

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

print_svg(filename, *, bbox_inches_restore=None, metadata=None)[source]

Параметры:

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

Целевой объект вывода; если строка, будет открыт файл для записи.

metadatadict[str, Any], необязательно

Метаданные в файле SVG, определённые как пары ключ-значение строк, дат времени или списков строк, например, {'Creator': 'My software', 'Contributor': ['Me', 'My Friend'], 'Title': 'Awesome'}.

Стандартные ключи и их типы значений:

строка: 'Coverage', 'Description', 'Format', 'Identifier', 'Language', 'Relation', 'Source', 'Title', и 'Type'.
строка или список строк: 'Contributor', 'Creator', 'Keywords', 'Publisher', и 'Rights'.
строка, дата, дата и время или кортеж того же: 'Date'. Если не строка, то будет отформатирован как ISO 8601.

Значения предварительно определены для 'Creator', 'Date', 'Format', и 'Type'. Они могут быть удалены, установив их в None.

Информация закодирована как метаданные Dublin Core.

print_svgz(filename, **kwargs)[source]

classmatplotlib.backends.backend_svg.RendererSVG(width, height, svgwriter, basename=None, image_dpi=72, *, metadata=None)[source]

END_OF_DOCUMENT_MARKER

Основы: RendererBase

close_group(s)[source]

Закрыть элемент группировки с меткой s.

Используется только рендерером SVG.

draw_gouraud_triangle(gc, points, colors, trans)[source]

[Устарело] Рисование треугольника с интерполяцией цвета Гуро.

Параметры:

gcGraphicsContextBase: Контекст графики.
points(3, 2) массив-подобный объект: Массив точек (x, y) для треугольника.
colors(3, 4) массив-подобный объект: RGBA цвета для каждой точки треугольника.
transformTransform: Аффинное преобразование, применяемое к точкам.

Примечания

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

draw_gouraud_triangles(gc, triangles_array, colors_array, transform)[source]

Рисуем набор треугольников с интерполяцией цвета Гуро.

Параметры:

gcGraphicsContextBase: Контекст графики.
triangles_array(N, 3, 2) массив-подобный объект: Массив из N точек (x, y) для треугольников.
colors_array(N, 3, 4) массив-подобный объект: Массив из N RGBA цветов для каждой точки треугольников.
transformTransform: Аффинное преобразование, применяемое к точкам.

draw_image(gc, x, y, im, transform=None)[source]

Рисуем RGBA изображение.

Параметры:

gcGraphicsContextBase: Контекст графики с информацией о обрезке.
xскаляр: Расстояние в физических единицах (точках или пикселях) от левой стороны холста.
yскаляр: Расстояние в физических единицах (точках или пикселях) от нижней стороны холста.
im(N, M, 4) массив из numpy.uint8: Массив RGBA пикселей.
transformAffine2DBase: Если и только если конкретный бэкэнд написан таким образом, что option_scale_image возвращает True, может быть передано аффинное преобразование (т. е., Affine2DBase) может быть передано в draw_image. Вектор сдвига преобразования задается в физических единицах (точках или пикселях). Обратите внимание, что преобразование не переопределяет x и y и должно быть применено до преобразования результата на x и y (это можно сделать, добавив x и y к вектору сдвига, определенному с помощью transform).

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

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

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

Параметры:

gcGraphicsContextBase: Контекст графики.
marker_pathPath: Путь для маркера.
marker_transTransform: Аффинное преобразование, применяемое к маркеру.
pathPath: Позиции для отображения маркеров.
transTransform: Аффинное преобразование, применяемое к пути.
rgbFaceцвет, необязательно

draw_path(gc, path, transform, rgbFace=None)[source]: Отображение экземпляра Path с заданным афинным преобразованием.

draw_path_collection(gc, master_transform, paths, all_transforms, offsets, offset_trans, facecolors, edgecolors, linewidths, linestyles, antialiaseds, urls, offset_position)[source]

Отобразить коллекцию paths.

Каждый путь сначала преобразуется с помощью соответствующей записи в all_transforms (список матриц 3x3), а затем с помощью master_transform. Затем они переводятся с помощью соответствующей записи в offsets, которая сначала преобразуется с помощью offset_trans.

facecolors, edgecolors, linewidths, linestyles и antialiased — списки, которые устанавливают соответствующие свойства.

offset_position сейчас не используется, но аргумент сохраняется для обратной совместимости.

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

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

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

Параметры:

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

Примечания

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

При попытке определить, правильно ли вы рассчитали прямоугольник (что позволяет правильно расположить и выровнять текст), поможет изменение строки в text.py:

if 0: bbox_artist(self, renderer)

на if 1, и тогда прямоугольник отобразится вместе с текстом.

finalize()[source]

flipy()[source]

Возвращает, увеличиваются ли значения y сверху вниз.

Обратите внимание, что это влияет только на отображение текста.

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

get_image_magnification()[source]: Получить коэффициент увеличения изображений, переданных в draw_image. Позволяет вектору отображать изображения с различным разрешением по сравнению с другими элементами.

get_text_width_height_descent(s, prop, ismath)[source]

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

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

open_group(s, gid=None)[source]

Открыть элемент группирования с меткой s и gid (если задано) как id.

Используется только в модуле SVG.

option_image_nocomposite()[source]

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

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

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

classmatplotlib.backends.backend_svg.XMLWriter(file)[source]

Bases: object

Параметры:

fileобъект текстового файла для записи

close(id)[source]

Закрыть открытые элементы, до (и включая) элемент, идентифицированный заданным идентификатором.

Параметры:

id: Идентификатор элемента, возвращённый методом start().

comment(comment)[source]

Добавить комментарий в поток вывода.

Параметры:

commentstr: Текст комментария.

data(text)[source]

Добавить символьные данные в поток вывода.

Параметры:

textstr: Символьные данные.

element(tag, text=None, attrib={}, **extra)[source]: Добавить целый элемент. Это то же самое, что вызов start(), data() и end() последовательно. Аргумент text можно опустить.

end(tag=None, indent=True)[source]

Закрыть текущий элемент (открытый последним вызовом start()).

Параметры:

tag: Тег элемента. Если указан, тег должен совпадать с открывающим тегом. Если опущен, текущий элемент закрывается.
indentbool, по умолчанию: True

flush()[source]: Очистить поток вывода.

start(tag, attrib={}, **extra)[source]

Открыть новый элемент. Атрибуты могут быть заданы в виде ключевых аргументов или в виде строки/словаря строк. Метод возвращает неявный идентификатор, который может быть передан методу close() для закрытия всех открытых элементов до и включая этот.

Параметры:

tag: Тег элемента.
attrib: Словарь атрибутов. Альтернативно, атрибуты могут быть заданы в виде ключевых аргументов.

Возвращает:

Идентификатор элемента.