matplotlib.backends.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, *, bbox_inches_restore=None, metadata=None)[source]

Параметры:

filenamestr или путь или поток

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

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]

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

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) массив-подобный объект 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_transTransform

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

transTransform

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

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_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

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

Примечания

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

Когда вы пытаетесь определить, правильно ли вы получили рамку (что позволяет правильно работать с выкладкой и выравниванием текста), это помогает изменить строку в 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 (True для большинства векторных бэкендов).

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.