matplotlib.backends.backend_ps

Постскриптовый бэкенд, который может генерировать PostScript .ps и .eps файлы.

matplotlib.backends.backend_ps.FigureCanvas[source]

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

classmatplotlib.backends.backend_ps.FigureCanvasPS(figure=None)[source]

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

draw()[source]

Отображение Figure.

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

filetypes={'eps': 'Векторный PostScript', 'ps': 'PostScript'}

fixed_dpi=72

get_default_filetype()[source]

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

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

print_eps(outfile, *, metadata=None, papertype=None, orientation='portrait', bbox_inches_restore=None, **kwargs)

print_ps(outfile, *, metadata=None, papertype=None, orientation='portrait', bbox_inches_restore=None, **kwargs)

classmatplotlib.backends.backend_ps.PsBackendHelper[source]

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

[Устарело]

Примечания

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

classmatplotlib.backends.backend_ps.RendererPS(width, height, pswriter, imagedpi=72)[source]

Основания: RendererPDFPSBase

Отобразитель обрабатывает все примитивы рисования, используя экземпляр контекста графики, который управляет цветами/стилями.

create_hatch(hatch)[source]

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, points, colors, trans)[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) массив из numpy.uint8

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

transformAffine2DBase

Если и только если конкретный бэкенд написан таким образом, что 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 (исключая контрольные точки).

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

Параметры:

gcGraphicsContextBase

Контекст графики.

marker_pathPath

Путь для маркера.

marker_transTransform

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

pathPath

Расположения для отрисовки маркеров.

transTransform

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

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

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

Отрисовка математического текста с использованием matplotlib.mathtext.

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]

Отрисовать коллекцию путей.

Каждый путь сначала преобразуется соответствующей записью в all_transforms (списке матриц (3, 3)), а затем — master_transform. Затем они сдвигаются на соответствующую запись в offsets, которая предварительно преобразуется с помощью offset_trans.

facecolors, edgecolors, linewidths, linestyles и antialiased — списки, задающие соответствующие свойства.

offset_position сейчас не используется, но аргумент сохраняется для обратной совместимости.

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

draw_tex(gc, x, y, s, prop, angle, *, mtext=None)[source]

Отрисовать элемент TeX.

Параметры:

gcGraphicsContextBase

Контекст графики.

xfloat

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

yfloat

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

sstr

Строка текста TeX.

propFontProperties

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

anglefloat

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

mtextText

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

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, и тогда вместе с текстом будет отображаться фактическая область видимости.

get_image_magnification()[source]

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

set_color(r, g, b, store=True)[source]

set_font(fontname, fontsize, store=True)[source]

set_linecap(linecap, store=True)[source]

set_linedash(offset, seq, store=True)[source]

set_linejoin(linejoin, store=True)[source]

set_linewidth(linewidth, store=True)[source]

matplotlib.backends.backend_ps.get_bbox_header(lbrt, rotated=False)[source]

Возвращает строку заголовка PostScript для заданной рамки lbrt=(l, b, r, t). Также возвращает команду поворота (при необходимости).

matplotlib.backends.backend_ps.gs_distill(tmpfile, eps=False, ptype='letter', bbox=None, rotated=False)[source]

Использует устройство pswrite или epswrite Ghostscript для дистилляции файла. Это позволяет получать более компактные файлы без некорректных операторов вложенного PostScript. Вывод является низкоуровневым, преобразуя текст в контуры.

matplotlib.backends.backend_ps.pstoeps(tmpfile, bbox=None, rotated=False)[source]

Преобразует PostScript в Encapsulated PostScript. Область отображения (bbox) файла EPS будет заменена заданным значением bbox. Если None, будет использована исходная область.

matplotlib.backends.backend_ps.xpdf_distill(tmpfile, eps=False, ptype='letter', bbox=None, rotated=False)[source]

Использует ps2pdf Ghostscript и pdftops xpdf/poppler для дистилляции файла. Получаемые файлы меньше по размеру и не содержат незаконных операторов вложенного PostScript. Этот дистиллятор предпочтительнее, так как генерирует высокоуровневый PostScript, который обрабатывает текст как текст.