matplotlib.backends.backend_ps

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

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

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

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

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

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

Отобразить Figure.

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

filetypes={'eps': 'Encapsulated Postscript', 'ps': 'Postscript'}

fixed_dpi=72

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

Возвращает формат файла по умолчанию для savefig, указанный в 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.RendererPS(width, height, pswriter, imagedpi=72)[исходный код]

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

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

create_hatch(hatch, linewidth)[исходный код]

draw_gouraud_triangles(gc, points, colors, trans)[исходный код]

Нарисовать последовательность треугольников Гуро.

Параметры:

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, можно передать аффинное преобразование (т. е. Affine2DBase) в draw_image. Вектор переноса преобразования задаётся в физических единицах (т. е. точках или пикселях). Обратите внимание, что преобразование не переопределяет 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_mathtext(gc, x, y, s, prop, angle)[исходный код]

Нарисовать математический текст с помощью matplotlib.mathtext.

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_tex(gc, x, y, s, prop, angle, *, mtext=None)[исходный код]

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

Параметры:

gcGraphicsContextBase

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

xfloat

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

yfloat

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

sstr

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

propFontProperties

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

anglefloat

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

mtextText

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

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.

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

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

set_color(r, g, b, store=True)[исходный код]

set_font(fontname, fontsize, store=True)[исходный код]

set_linecap(linecap, store=True)[исходный код]

set_linedash(offset, seq, store=True)[исходный код]

set_linejoin(linejoin, store=True)[исходный код]

set_linewidth(linewidth, store=True)[исходный код]

matplotlib.backends.backend_ps.get_bbox_header(lbrt, rotated=False)[исходный код]

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

Примечания

Устарело с версии 3.9.

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 в инкапсулированный PostScript. Границы файла 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, в котором текст остаётся текстом.