matplotlib.backends.backend_svg
-
matplotlib.backends.backend_svg.FigureCanvas -
псевдоним для
matplotlib.backends.backend_svg.FigureCanvasSVG
- класс
matplotlib.backends.backend_svg.FigureCanvasSVG(figure=None)[source] -
Базовый класс:
matplotlib.backend_bases.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, **kwargs)[source] -
Параметры: - filenameстрока или объект пути или объект файла
-
Целевой объект вывода; если строка, откроется файл для записи.
- metadataсловарь[строка, Любой], необязательно
-
Метаданные в файле 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, *args, **kwargs)[source]
-
- class
matplotlib.backends.backend_svg.RendererSVG(width, height, svgwriter, basename=None, image_dpi=72, *, metadata=None)[source] -
Bases:
matplotlib.backend_bases.RendererBase-
close_group(s)[source] -
Закрыть элемент группирования с меткой s.
Используется только рендерером SVG.
-
draw_gouraud_triangle(gc, points, colors, trans)[source] -
Отрисовать треугольник с интерполяцией Гуро.
Параметры: -
gc
GraphicsContextBase -
Контекст графики.
- points(3, 2) массив-подобный объект
-
Массив точек (x, y) для треугольника.
- colors(3, 4) массив-подобный объект
-
Цвета RGBA для каждой точки треугольника.
-
transform
matplotlib.transforms.Transform -
Аффинное преобразование, применяемое к точкам.
-
gc
-
draw_gouraud_triangles(gc, triangles_array, colors_array, transform)[source] -
Отрисовать серию треугольников с интерполяцией Гуро.
Параметры: - points(N, 3, 2) массив-подобный объект
-
Массив N точек (x, y) для треугольников.
- colors(N, 3, 4) массив-подобный объект
-
Массив N цветов RGBA для каждой точки треугольников.
-
transform
matplotlib.transforms.Transform -
Аффинное преобразование, применяемое к точкам.
-
draw_image(gc, x, y, im, transform=None)[source] -
Отрисовать изображение RGBA.
Параметры: -
gc
GraphicsContextBase -
Контекст графики с информацией о обрезке.
- xскаляр
-
Расстояние в физических единицах (точках или пикселях) от левой стороны холста.
- yскаляр
-
Расстояние в физических единицах (точках или пикселях) от нижней стороны холста.
- im(N, M, 4) массив-подобный объект np.uint8
-
Массив пикселей RGBA.
-
transform
matplotlib.transforms.Affine2DBase -
Если и только если конкретный бэкэнд написан таким образом, что
option_scale_image()возвращаетTrue, аффинное преобразование (т.е.,Affine2DBase) *может* быть передано вdraw_image(). Вектор переноса преобразования задается в физических единицах (точках или пикселях). Обратите внимание, что преобразование не переопределяет *x* и *y* и должно быть применено *до* перевода результата на *x* и *y* (это можно сделать, добавив *x* и *y* к вектору переноса, определенному в *transform*).
-
gc
-
draw_markers(gc, marker_path, marker_trans, path, trans, rgbFace=None)[source] -
Отрисовать маркер в каждой из вершин path (исключая контрольные точки).
Это обеспечивает реализацию draw_markers по умолчанию, которая выполняет несколько вызовов
draw_path(). Некоторые бэкэнды могут захотеть переопределить этот метод, чтобы нарисовать маркер только один раз и повторно использовать его несколько раз.Параметры: -
gc
GraphicsContextBase -
Контекст графики.
-
marker_trans
matplotlib.transforms.Transform -
Аффинное преобразование, применяемое к маркеру.
-
trans
matplotlib.transforms.Transform -
Аффинное преобразование, применяемое к пути.
-
gc
-
draw_path(gc, path, transform, rgbFace=None)[source] -
Отрисовать экземпляр
Pathс заданным афинным преобразованием.
-
-
draw_path_collection(gc, master_transform, paths, all_transforms, offsets, offsetTrans, facecolors, edgecolors, linewidths, linestyles, antialiaseds, urls, offset_position)[source] -
Отрисовка набора путей, выбирая свойства отрисовки из списков facecolors, edgecolors, linewidths, linestyles и antialiaseds. offsets — список смещений, применяемых к каждому пути. Смещения из offsets сначала преобразуются с помощью offsetTrans перед применением.
offset_position может быть либо "screen", либо "data", в зависимости от пространства, в котором находятся смещения; "data" устарело.
Это обеспечивает реализацию по умолчанию для
draw_path_collection(), которая делает несколько вызововdraw_path(). Некоторые бэкэнды могут захотеть переопределить это, чтобы отрисовать каждый набор данных путей только один раз, а затем ссылаться на этот путь несколько раз с различными смещениями, цветами, стилями и т. д. Методы-генераторы_iter_collection_raw_paths()и_iter_collection()предназначены для помощи (и стандартизации) реализации в разных бэкендах. Настоятельно рекомендуется использовать эти генераторы, чтобы изменения в поведенииdraw_path_collection()можно было внести глобально.
-
draw_tex(gc, x, y, s, prop, angle, ismath=<deprecated parameter>, mtext=None)[source]
-
draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)[source] -
Отрисовка текстового объекта.
Параметры: -
gc
GraphicsContextBase -
Контекст графики.
- xfloat
-
Позиция x текста в координатах отображения.
- yfloat
-
Позиция y базовой линии текста в координатах отображения.
- sstr
-
Строка текста.
-
prop
matplotlib.font_manager.FontProperties -
Свойства шрифта.
- anglefloat
-
Угол поворота в градусах против часовой стрелки.
-
mtext
matplotlib.text.Text -
Исходный текстовый объект для отрисовки.
Примечания
Примечание для разработчиков бэкендов:
При попытке определить, правильно ли вы рассчитали область (что обеспечивает правильное форматирование и выравнивание текста), полезно изменить строку в text.py:
if 0: bbox_artist(self, renderer)
на if 1, и тогда вместе с текстом будет отображаться и фактическая область.
-
gc
-
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 с
FontPropertiesprop.
- property
mathtext_parser
-
open_group(s, gid=None)[source] -
Открывает элемент группирования с меткой s и gid (если задано) в качестве идентификатора.
Используется только рендерером SVG.
-
option_image_nocomposite()[source] -
Возвращает, нужно ли пропускать композицию изображений Matplotlib.
Бэкэнды растровых изображений обычно должны возвращать False (позволяя C-уровневому растризатору обрабатывать композицию изображений); векторные бэкэнды обычно должны возвращать
not rcParams["image.composite_image"].
-
option_scale_image()[source] -
Возвращает, поддерживаются ли произвольные аффинные преобразования в
draw_image()(True для большинства векторных бэкендов).
-
- class
matplotlib.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]
-
matplotlib.backends.backend_svg.escape_cdata(s)[source]
-
matplotlib.backends.backend_svg.escape_comment(s)[source]
-
matplotlib.backends.backend_svg.generate_css(attrib={})[source]
-
matplotlib.backends.backend_svg.generate_transform(transform_list=[])[source]
-
matplotlib.backends.backend_svg.short_float_fmt(x)[source] -
Создаёт краткое строковое представление числа с плавающей точкой, которое представляет собой форматирование %f с удалением концевых нулей и десятичной точки.
© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.4.3/api/backend_svg_api.html