backend_svg

matplotlib.backends.backend_svg.FigureCanvas[source]

псевдоним FigureCanvasSVG

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

Базы: FigureCanvasBase

draw()[source]

Отображение Figure.

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

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

fixed_dpi=72

get_default_filetype()[source]

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

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

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

Параметры:

filenamestr или path-like или file-like

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

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

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

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

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

Значения заданы заранее для 'Creator', 'Date', 'Format', и 'Type'. Их можно удалить, установив их в None.

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

print_svgz(filename, *args, **kwargs)[source]

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

Bases: 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 для каждой точки треугольника.

transformmatplotlib.transforms.Transform

Аффинное преобразование, применяемое к точкам.

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

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

Параметры:

points(N, 3, 2) массив-подобный объект

Массив из N точек (x, y) для треугольников.

colors(N, 3, 4) массив-подобный объект

Массив из N цветов RGBA для каждой точки треугольников.

transformmatplotlib.transforms.Transform

Аффинное преобразование, применяемое к точкам.

draw_image(gc, x, y, im, transform=None)[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, trans, rgbFace=None)[source]

Отрисовка маркера в каждой вершине path (за исключением контрольных точек).

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

Параметры:

gcGraphicsContextBase

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

marker_transmatplotlib.transforms.Transform

Аффинное преобразование, применяемое к маркеру.

transmatplotlib.transforms.Transform

Аффинное преобразование, применяемое к пути.

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 (списке матриц (3, 3)), а затем с помощью master_transform. Затем они переводятся на соответствующую запись в offsets, которая предварительно преобразуется с помощью offset_trans.

facecolors, edgecolors, linewidths, linestyles и antialiased — списки, задающие соответствующие свойства.

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

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

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

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, и тогда вместе с текстом будет нарисован и фактический прямоугольник.

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.

open_group(s, gid=None)[source]

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

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

option_image_nocomposite()[source]

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

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

option_scale_image()[source]

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

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

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

flush()[source]

Сбросить выходной поток.

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

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

Параметры:

tag

Тэг элемента.

attrib

Словарь атрибутов. Также атрибуты могут быть заданы в качестве именованных аргументов.

Возвращает:

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

matplotlib.backends.backend_svg.escape_attrib(s)[source]

[Устарело]

Примечания

Устарело начиная с версии 3.6: Используйте вместо него унаследованную копию _escape_attrib.

matplotlib.backends.backend_svg.escape_cdata(s)[source]

[Устарело]

Примечания

Устарело начиная с версии 3.6: Используйте вместо него унаследованную копию _escape_cdata.

matplotlib.backends.backend_svg.escape_comment(s)[source]

[Устарело]

Примечания

Устарело начиная с версии 3.6: Используйте вместо него унаследованную копию _escape_comment.

matplotlib.backends.backend_svg.generate_css(attrib=None)[source]

[Устаревшее]

Примечания

Устарело начиная с версии 3.6:

matplotlib.backends.backend_svg.generate_transform(transform_list=None)[source]

[Устаревшее]

Примечания

Устарело начиная с версии 3.6:

matplotlib.backends.backend_svg.short_float_fmt(x)[source]

[Устаревшее]

Примечания

Устарело начиная с версии 3.6: Используйте переданную копию _short_float_fmt.