matplotlib.backends.backend_svg

matplotlib.backends.backend_svg.FigureCanvas[исходный код]

псевдоним для FigureCanvasSVG

classmatplotlib.backends.backend_svg.FigureCanvasSVG(figure=None)[исходный код]

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

draw()[исходный код]

Выполнить отрисовку Figure.

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

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

fixed_dpi=72

get_default_filetype()[исходный код]

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

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

print_svg(filename, *, bbox_inches_restore=None, metadata=None)[исходный код]

Параметры:

filenamestr или объект, похожий на путь или файл

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

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

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

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

• str: 'Coverage', 'Description', 'Format', 'Identifier', 'Language', 'Relation', 'Source', 'Title' и 'Type'.
• str или list of str: 'Contributor', 'Creator', 'Keywords', 'Publisher' и 'Rights'.
• str, date, datetime или tuple из значений того же типа: 'Date'. Если значение имеет тип, отличный от str, оно будет отформатировано в соответствии с ISO 8601.

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

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

print_svgz(filename, **kwargs)[исходный код]

classmatplotlib.backends.backend_svg.RendererSVG(width, height, svgwriter, basename=None, image_dpi=72, *, metadata=None)[исходный код]

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

close_group(s)[исходный код]

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

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

draw_gouraud_triangles(gc, triangles_array, colors_array, transform)[исходный код]

Рисует набор треугольников Гуро.

Параметры:

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)[исходный код]

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

Параметры:

gcGraphicsContextBase

Графический контекст с информацией об обрезке.

xfloat

Расстояние в физических единицах (то есть в точках или пикселях) от левого края холста.

yfloat

Расстояние в физических единицах (то есть в точках или пикселях) от нижнего края холста.

imмассив формы (N, M, 4) из numpy.uint8

Массив пикселей RGBA.

transformAffine2DBase

Если и только если конкретный бэкенд реализован так, что option_scale_image возвращает True, в draw_image можно передать аффинное преобразование (то есть Affine2DBase). Вектор переноса преобразования задаётся в физических единицах (то есть в точках или пикселях). Обратите внимание, что преобразование не переопределяет x и y и должно применяться до переноса результата на x и y (этого можно добиться, добавив x и y к вектору переноса, заданному параметром transform).

draw_markers(gc, marker_path, marker_trans, path, trans, rgbFace=None)[исходный код]

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

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

Параметры:

gcGraphicsContextBase

Графический контекст.

marker_pathPath

Контур маркера.

marker_transTransform

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

pathPath

Места, в которых нужно нарисовать маркеры.

transTransform

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

rgbFaceцвет, необязательно

draw_path(gc, path, transform, rgbFace=None)[исходный код]

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

draw_path_collection(gc, master_transform, paths, all_transforms, offsets, offset_trans, facecolors, edgecolors, linewidths, linestyles, antialiaseds, urls, offset_position)[исходный код]

Рисует коллекцию 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)[исходный код]

Рисует текстовый объект.

Параметры:

gcGraphicsContextBase

Графический контекст.

xfloat

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

yfloat

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

sstr

Текстовая строка.

propFontProperties

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

anglefloat

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

ismathbool или "TeX"

Если True, использовать парсер mathtext.

mtextText

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

Примечания

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

RendererBase.draw_text также поддерживает передачу значения "TeX" параметру ismath для использования отрисовки TeX, но это не является обязательным для бэкендов фактической отрисовки; многие встроенные бэкенды эту возможность не поддерживают. Вместо этого отрисовка TeX предоставляется методом draw_tex.

finalize()[исходный код]

flipy()[исходный код]

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

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

get_canvas_width_height()[исходный код]

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

get_image_magnification()[исходный код]

Возвращает коэффициент увеличения изображений, передаваемых в draw_image. Позволяет бэкенду использовать для изображений разрешение, отличающееся от разрешения других artist-объектов.

get_text_width_height_descent(s, prop, ismath)[исходный код]

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

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

open_group(s, gid=None)[исходный код]

Открывает группирующий элемент с меткой s и, если задан, идентификатором gid.

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

option_image_nocomposite()[исходный код]

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

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

option_scale_image()[исходный код]

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

classmatplotlib.backends.backend_svg.XMLWriter(file)[исходный код]

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

Параметры:

fileтекстовый объект, подобный файлу, доступный для записи

close(id)[исходный код]

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

Параметры:

id

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

comment(comment)[исходный код]

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

Параметры:

commentstr

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

data(text)[исходный код]

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

Параметры:

textstr

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

element(tag, text=None, attrib={}, **extra)[исходный код]

Добавить элемент целиком. Это эквивалентно последовательному вызову методов start(), data() и end(). Аргумент text можно опустить.

end(tag=None, indent=True)[исходный код]

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

Параметры:

tag

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

indentbool, по умолчанию: True

flush()[исходный код]

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

start(tag, attrib={}, **extra)[исходный код]

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

Параметры:

tag

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

attrib

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

Возвращает:

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