matplotlib.backends.backend_pdf

Модуль matplotlib.backends.backend_pdf, backend для работы с PDF-файлами. Автор: Jouni K Seppänen <jks@iki.fi>

matplotlib.backends.backend_pdf.FigureCanvas

Псевдоним для FigureCanvasPdf

class matplotlib.backends.backend_pdf.FigureCanvasPdf(figure)

Базовый класс: matplotlib.backend_bases.FigureCanvasBase

Поверхность, на которую отрисовывается фигура. Вызывает методы draw и print fig, создаёт рендереры и т. д.

Атрибуты

figure

(matplotlib.figure.Figure) Экземпляр класса Figure

draw()

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

fixed_dpi = 72

get_default_filetype()

print_pdf(filename, **kwargs)

matplotlib.backends.backend_pdf.FigureManager

Псевдоним для FigureManagerPdf

class matplotlib.backends.backend_pdf.FigureManagerPdf(canvas, num)

Базовый класс: matplotlib.backend_bases.FigureManagerBase

class matplotlib.backends.backend_pdf.GraphicsContextPdf(file)

Базовый класс: matplotlib.backend_bases.GraphicsContextBase

alpha_cmd(alpha, forced, effective_alphas)

capstyle_cmd(style)

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

clip_cmd(cliprect, clippath)

Устанавливает прямоугольник обрезки. Вызывает 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(other)

Копирует свойства из другого объекта в текущий.

dash_cmd(dashes)

delta(other)

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

fill(*args)

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

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

fillcolor_cmd(rgb)

finalize()

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

hatch_cmd(hatch, hatch_color)

joinstyle_cmd(style)

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

linewidth_cmd(width)

paint()

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

pop()

push()

rgb_cmd(rgb)

stroke()

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

class matplotlib.backends.backend_pdf.Name(name)

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

Объект имени в формате PDF.

static hexify(match)

name

pdfRepr()

class matplotlib.backends.backend_pdf.Operator(op)

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

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

op

pdfRepr()

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

Bases: object

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

addGouraudTriangles(points, colors)

alphaState(alpha)

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

beginStream(id, len, extra=None, png=None)

close()

Очищает все буферы и освобождает все ресурсы.

createType1Descriptor(t1font, fontfile)

dviFontName(dvifont)

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

embedTTF(filename, characters)

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

endStream()

finalize()

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

fontName(fontprop)

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

hatchPattern(hatch_style)

imageObject(image)

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

markerObject(path, trans, fill, stroke, lw, joinstyle, capstyle)

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

newPage(width, height)

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

output(*data)

pathCollectionObject(gc, path, trans, padding, filled, stroked)

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

recordXref(id)

reserveObject(name='')

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

texFontMap

write(data)

writeFonts()

writeGouraudTriangles()

writeHatches()

writeImages()

writeInfoDict()

Запись словаря информации, проверка его правильности.

writeMarkers()

writeObject(object, contents)

writePath(path, transform, clip=False, sketch=None)

writePathCollectionTemplates()

writeTrailer()

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

writeXref()

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

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

Bases: 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, необязательно Если установлено в False, пустые файлы pdf будут автоматически удалены при закрытии. metadata : словарь, необязательно Объект словаря информации (см. раздел 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(text, positionRect=[-100, -100, 0, 0])

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

close()

Завершает работу с объектом, делая из исходного файла завершённый PDF-файл.

get_pagecount()

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

infodict()

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

keep_empty

savefig(figure=None, **kwargs)

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

Любые другие ключевые аргументы передаются в savefig().

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

class matplotlib.backends.backend_pdf.Reference(id)

Bases: object

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

pdfRepr()

write(contents, file)

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

Базы: matplotlib.backend_bases.RendererBase

afm_font_cache = {}

check_gc(gc, fillcolor=None)

draw_gouraud_triangle(gc, points, colors, trans)

draw_gouraud_triangles(gc, points, colors, trans)

draw_image(gc, x, y, im, transform=None)

draw_markers(gc, marker_path, marker_trans, path, trans, rgbFace=None)

draw_mathtext(gc, x, y, s, prop, angle)

draw_path(gc, path, transform, rgbFace=None)

draw_path_collection(gc, master_transform, paths, all_transforms, offsets, offsetTrans, facecolors, edgecolors, linewidths, linestyles, antialiaseds, urls, offset_position)

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

draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)

encode_string(s, fonttype)

finalize()

flipy()

get_canvas_width_height()

get_image_magnification()

get_text_width_height_descent(s, prop, ismath)

merge_used_characters(other)

new_gc()

option_image_nocomposite()

Возвращает, следует ли генерировать составное изображение из нескольких изображений на наборе осей

option_scale_image()

Поддержка произвольного масштабирования изображений в формате PDF.

track_characters(font, s)

Отслеживает, какие символы требуются из каждого шрифта.

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

Базы: object

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

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

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

compressobj

end()

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

extra

file

id

len

pdfFile

pos

write(data)

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

class matplotlib.backends.backend_pdf.Verbatim(x)

Базы: object

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

pdfRepr()

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

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

matplotlib.backends.backend_pdf.pdfRepr(obj)

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