matplotlib.backends.backend_pdf

PDF-backend для matplotlib. Автор: Jouni K Seppänen <jks@iki.fi>

matplotlib.backends.backend_pdf.FigureCanvas

Псевдоним для matplotlib.backends.backend_pdf.FigureCanvasPdf

class matplotlib.backends.backend_pdf.FigureCanvasPdf(figure) [source]

Наследуется от matplotlib.backend_bases.FigureCanvasBase

Поверхность холста, на которую отрисовывается изображение. Вызывает методы draw и print_fig, создаёт рендереры и т.д...

Атрибуты:	figure : matplotlib.figure.Figure Объект Figure высокого уровня

draw(self) [source]

Отрисовка Figure.

filetypes = {'pdf': 'Portable Document Format'}

fixed_dpi = 72

get_default_filetype(self) [source]

Получить значение по умолчанию для формата сохранения изображения, указанное в rcParam savefig.format. Возвращаемая строка не включает точку. Переопределяется в тех backend'ах, которые поддерживают только один тип файла.

print_pdf(self, filename, *, dpi=72, bbox_inches_restore=None, metadata=None, **kwargs) [source]

class matplotlib.backends.backend_pdf.GraphicsContextPdf(file) [source]

Наследуется от matplotlib.backend_bases.GraphicsContextBase

alpha_cmd(self, alpha, forced, effective_alphas) [source]

capstyle_cmd(self, style) [source]

capstyles = {'butt': 0, 'projecting': 2, 'round': 1}

clip_cmd(self, cliprect, clippath) [source]

Установка области обрезки. Вызывает self.pop() и self.push().

commands = ((('_cliprect', '_clippath'), <function GraphicsContextPdf.clip_cmd>), (('_alpha', '_forced_alpha', '_effective_alphas'), <function GraphicsContextPdf.alpha_cmd>), (('_capstyle',), <function GraphicsContextPdf.capstyle_cmd>), (('_fillcolor',), <function GraphicsContextPdf.fillcolor_cmd>), (('_joinstyle',), <function GraphicsContextPdf.joinstyle_cmd>), (('_linewidth',), <function GraphicsContextPdf.linewidth_cmd>), (('_dashes',), <function GraphicsContextPdf.dash_cmd>), (('_rgb',), <function GraphicsContextPdf.rgb_cmd>), (('_hatch', '_hatch_color'), <function GraphicsContextPdf.hatch_cmd>))

copy_properties(self, other) [source]

Копирует свойства из other в self.

dash_cmd(self, dashes) [source]

delta(self, other) [source]

Копирует свойства из other в self и возвращает PDF-команды, необходимые для преобразования self в other.

fill(self, *args) [source]

Предикат: нужно ли заполнять контур?

Необязательный аргумент может быть использован для задания альтернативного цвета заполнения, как требуется для RendererPdf.draw_markers.

fillcolor_cmd(self, rgb) [source]

finalize(self) [source]

Убеждается, что все открытые графические состояния закрыты.

hatch_cmd(self, hatch, hatch_color) [source]

joinstyle_cmd(self, style) [source]

joinstyles = {'bevel': 2, 'miter': 0, 'round': 1}

linewidth_cmd(self, width) [source]

paint(self) [source]

Возвращает соответствующий PDF-оператор, чтобы нарисовать контур, заполнить область или сделать и то, и другое.

pop(self) [source]

push(self) [source]

rgb_cmd(self, rgb) [source]

stroke(self) [source]

Предикат: нужно ли рисовать контур?

class matplotlib.backends.backend_pdf.Name(name) [source]

Наследуется от object

Объект имени в PDF.

static hexify(match) [source]

name

pdfRepr(self) [source]

class matplotlib.backends.backend_pdf.Operator(op) [source]

Bases: object

Объект оператора PDF.

op

pdfRepr(self) [source]

class matplotlib.backends.backend_pdf.PdfFile(filename, metadata=None) [source]

Bases: object

Объект файла PDF.

addGouraudTriangles(self, points, colors) [source]

alphaState(self, alpha) [source]

Возвращает имя ExtGState, устанавливающего альфа-значение.

beginStream(self, id, len, extra=None, png=None) [source]

close(self) [source]

Очистить все буферы и освободить все ресурсы.

createType1Descriptor(self, t1font, fontfile) [source]

dviFontName(self, dvifont) [source]

Учитывая объект шрифта dvi, возвращает имя, подходящее для Op.selectfont. Если информация о шрифте не зарегистрирована, она регистрируется в self.dviFontInfo.

embedTTF(self, filename, characters) [source]

Встраивает шрифт TTF из указанного файла в документ.

endStream(self) [source]

finalize(self) [source]

Записывает различные отложенные объекты и заключительные данные PDF.

fontName(self, fontprop) [source]

Выбирает шрифт на основе fontprop и возвращает имя, подходящее для Op.selectfont. Если fontprop — строка, она интерпретируется как имя файла шрифта.

hatchPattern(self, hatch_style) [source]

imageObject(self, image) [source]

Возвращает имя XObject изображения, представляющего данное изображение.

markerObject(self, path, trans, fill, stroke, lw, joinstyle, capstyle) [source]

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

newPage(self, width, height) [source]

newTextnote(self, text, positionRect=[-100, -100, 0, 0]) [source]

output(self, *data) [source]

pathCollectionObject(self, gc, path, trans, padding, filled, stroked) [source]

static pathOperations(path, transform, clip=None, simplify=None, sketch=None) [source]

recordXref(self, id) [source]

reserveObject(self, name='') [source]

Зарезервировать идентификатор для косвенного объекта. Имя используется для отладки на случай, если мы забудем вывести объект с помощью writeObject.

texFontMap

write(self, data) [source]

writeFonts(self) [source]

writeGouraudTriangles(self) [source]

writeHatches(self) [source]

writeImages(self) [source]

writeInfoDict(self) [source]

Записать словарь info, проверив его на корректность.

writeMarkers(self) [source]

writeObject(self, object, contents) [source]

writePath(self, path, transform, clip=False, sketch=None) [source]

writePathCollectionTemplates(self) [source]

writeTrailer(self) [source]

Записать трейлер PDF.

writeXref(self) [source]

Записать таблицу xref.

class matplotlib.backends.backend_pdf.PdfPages(filename, keep_empty=True, metadata=None) [source]

Основы: object

Файл PDF с несколькими страницами.

Примечания

На самом деле PdfPages — это тонкий обертка над PdfFile, чтобы избежать путаницы при использовании savefig() и забывании аргумента формата.

Примеры

>>> import matplotlib.pyplot as plt
>>> # Initialize:
>>> with PdfPages('foo.pdf') as pdf:
...     # As many times as you like, create a figure fig and save it:
...     fig = plt.figure()
...     pdf.savefig(fig)
...     # When no figure is specified the current figure is saved
...     pdf.savefig()

Создание нового объекта PdfPages.

Параметры:

filename : str Графики, использующие PdfPages.savefig(), будут записаны в этом месте. Файл открывается сразу, и любой более ранний файл с тем же именем перезаписывается. keep_empty : bool, optional Если установлено в значение False, пустые файлы pdf будут автоматически удаляться при закрытии. metadata : dictionary, optional Объект словаря информации (см. раздел 10.2.1 «Словарь информации о документе» справки по PDF), например: {'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome fig'} Стандартные ключи — 'Title', 'Author', 'Subject', 'Keywords', 'Creator', 'Producer', 'CreationDate', 'ModDate', и 'Trapped'. Значения предопределены для 'Creator', 'Producer' и 'CreationDate'. Их можно удалить, установив их в None.

attach_note(self, text, positionRect=[-100, -100, 0, 0]) [source]

Добавить новую текстовую заметку на страницу, которая должна быть сохранена дальше. Необязательный параметр positionRect указывает положение новой заметки на странице. По умолчанию он находится вне страницы, чтобы убедиться, что он не отображается на распечатках.

close(self) [source]

Завершить этот объект, сделав файл подлежащий файлом PDF.

get_pagecount(self) [source]

Возвращает текущее количество страниц в файле многостраничного pdf.

infodict(self) [source]

Возвращает изменяемый объект словаря информации (см. раздел 10.2.1 «Словарь информации о документе» справки по PDF).

keep_empty

savefig(self, figure=None, **kwargs) [source]

Сохраняет Figure в этом файле как новую страницу.

Все остальные ключевые аргументы передаются в savefig().

Параметры:	figure : Figure or int, optional Указывает, какая фигура сохраняется в файл. Если не указано, сохраняется активная фигура. Если предоставлен экземпляр Figure, сохраняется эта фигура. Если указано целое число, ищется экземпляр фигуры по номеру.

class matplotlib.backends.backend_pdf.Reference(id) [source]

Основы: object

Объект ссылки PDF. Используйте PdfFile.reserveObject(), чтобы создать ссылки.

pdfRepr(self) [source]

write(self, contents, file) [source]

class matplotlib.backends.backend_pdf.RendererPdf(file, image_dpi, height, width) [source]

Базы: matplotlib.backends._backend_pdf_ps.RendererPDFPSBase

afm_font_cache

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

Примечания

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

check_gc(self, gc, fillcolor=None) [source]

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

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

Параметры:	points : array_like, shape=(3, 2) Массив точек (x, y) для треугольника. colors : array_like, shape=(3, 4) RGBA цвета для каждой точки треугольника. transform : matplotlib.transforms.Transform Аффинное преобразование, применяемое к точкам.

draw_gouraud_triangles(self, gc, points, colors, trans) [source]

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

Параметры:	points : array_like, shape=(N, 3, 2) Массив из N точек (x, y) для треугольников. colors : array_like, shape=(N, 3, 4) Массив из N RGBA цветов для каждой точки треугольников. transform : matplotlib.transforms.Transform Аффинное преобразование, применяемое к точкам.

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

Отрисовка RGBA изображения.

Параметры:

gc : GraphicsContextBase Контекст графики с информацией о обрезке. x : scalar Расстояние в физических единицах (точках или пикселях) от левой стороны холста. y : scalar Расстояние в физических единицах (точках или пикселях) от нижней стороны холста. im : array_like, shape=(N, M, 4), dtype=np.uint8 Массив RGBA пикселей. transform : matplotlib.transforms.Affine2DBase Если и только если конкретный бэкэнд написан таким образом, что option_scale_image() возвращает True, аффинное преобразование может быть передано в draw_image(). Оно принимает вид экземпляра Affine2DBase. Вектор переноса преобразования задается в физических единицах (точках или пикселях). Обратите внимание, что преобразование не переопределяет x и y, и должно быть применено перед переводом результата на x и y (это можно сделать, добавив x и y к вектору переноса, определенному transform).

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

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

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

Параметры:	gc : GraphicsContextBase Контекст графики marker_trans : matplotlib.transforms.Transform Аффинное преобразование, применяемое к маркеру. trans : matplotlib.transforms.Transform Аффинное преобразование, применяемое к пути.

draw_mathtext(self, gc, x, y, s, prop, angle) [source]

draw_path(self, gc, path, transform, rgbFace=None) [source]

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

draw_path_collection(self, 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", в зависимости от пространства, в котором находятся смещения.

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

draw_tex(self, gc, x, y, s, prop, angle, ismath='TeX!', mtext=None) [source]

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

Отрисовка экземпляра текста.

Параметры:	gc : GraphicsContextBase Контекст графики. x : scalar Позиция x текста в координатах отображения. y : scalar Позиция y базовой линии текста в координатах отображения. s : str Строка текста. prop : matplotlib.font_manager.FontProperties Свойства шрифта. angle : scalar Угол поворота в градусах. mtext : matplotlib.text.Text Исходный объект текста для отображения.

Примечания

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

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

if 0: bbox_artist(self, renderer)

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

encode_string(self, s, fonttype) [source]

finalize(self) [source]

get_image_magnification(self) [source]

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

merge_used_characters(self, other) [source]

new_gc(self) [source]

Возвращает экземпляр GraphicsContextBase.

track_characters(self, font, s) [source]

Отслеживает необходимые символы из каждого шрифта.

class matplotlib.backends.backend_pdf.Stream(id, len, file, extra=None, png=None) [source]

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

Объект потока PDF.

У него нет метода pdfRepr. Вместо этого вызовите begin(), затем выведите содержимое потока, вызвав write(), и, наконец, вызовите end().

id: идентификатор объекта потока; len: неиспользуемый объект Reference для длины потока или None (для использования буфера памяти); file: файл PdfFile; extra: словарь дополнительных пар ключ-значение для включения в заголовок потока; png: если данные уже сжаты в png, параметры декодирования

compressobj

end(self) [source]

Завершить поток.

extra

file

id

len

pdfFile

pos

write(self, data) [source]

Записать данные в поток.

class matplotlib.backends.backend_pdf.Verbatim(x) [source]

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

Сохраняет содержимое команд PDF в формате verbatim для последующего включения в поток.

pdfRepr(self) [source]

matplotlib.backends.backend_pdf.fill(strings, linelen=75) [source]

Создать одну строку из последовательности строк с пробелами между ними. Пробелы выбираются таким образом, чтобы строки имели не более linelen символов, если это возможно.

matplotlib.backends.backend_pdf.pdfRepr(obj) [source]

Преобразовать объекты Python в синтаксис PDF.