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': 'Encapsulated 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]
-
[Устарело] Отрисовка треугольника с заливкой по методу Гуро.
- Параметры:
-
-
gc
GraphicsContextBase -
Контекст графики.
- points(3, 2) массив-подобный объект
-
Массив точек (x, y) для треугольника.
- colors(3, 4) массив-подобный объект
-
Цвета RGBA для каждой точки треугольника.
-
transform
Transform -
Аффинное преобразование, применяемое к точкам.
-
gc
Примечания
Устарело начиная с версии 3.7: Используйте draw_gouraud_triangles вместо этого.
- draw_gouraud_triangles(gc, points, colors, trans)[source]
-
Отрисовка набора треугольников с заливкой по методу Гуро.
- Параметры:
-
-
gc
GraphicsContextBase -
Контекст графики.
- triangles_array(N, 3, 2) массив-подобный объект
-
Массив из N точек (x, y) для треугольников.
- colors_array(N, 3, 4) массив-подобный объект
-
Массив из N цветов RGBA для каждой точки треугольников.
-
transform
Transform -
Аффинное преобразование, применяемое к точкам.
-
gc
- draw_image(gc, x, y, im, transform=None)[source]
-
Отрисовка изображения в формате RGBA.
- Параметры:
-
-
gc
GraphicsContextBase -
Контекст графики с информацией о обрезке.
- xскаляр
-
Расстояние в физических единицах (точках или пикселях) от левой стороны холста.
- yскаляр
-
Расстояние в физических единицах (точках или пикселях) от нижней стороны холста.
- im(N, M, 4) массив-подобный объект np.uint8
-
Массив пикселей RGBA.
-
transform
matplotlib.transforms.Affine2DBase -
Если и только если конкретный бэкенд написан так, что
option_scale_imageвозвращаетTrue, может быть передано аффинное преобразование (т.е.,Affine2DBase) может быть передано вdraw_image. Вектор смещения преобразования задан в физических единицах (точках или пикселях). Обратите внимание, что преобразование не переопределяет x и y и должно быть применено до преобразования результата на x и y (это можно сделать, добавив x и y к вектору смещения, определенному transform).
-
gc
- draw_markers(gc, marker_path, marker_trans, path, trans, rgbFace=None)[source]
-
Отрисовка маркера в каждой вершине path (исключая контрольные точки).
Основная (по умолчанию) реализация выполняет несколько вызовов
draw_path. Бэкенды могут переопределить этот метод, чтобы нарисовать маркер только один раз и использовать его несколько раз.- Параметры:
-
-
gc
GraphicsContextBase -
Контекст графики.
-
marker_trans
Transform -
Аффинное преобразование, применяемое к маркеру.
-
trans
Transform -
Аффинное преобразование, применяемое к пути.
-
gc
- 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 сейчас не используется, но аргумент сохраняется для обратной совместимости.
Базовая (по умолчанию) реализация выполняет несколько вызовов
draw_path. Бэкэнды могут переопределить это, чтобы отобразить каждый набор данных пути только один раз, а затем обратиться к этому пути несколько раз с различными смещениями, цветами, стилями и т.д. Методы-генераторы_iter_collection_raw_pathsи_iter_collectionпредназначены для помощи (и стандартизации) реализации в разных бэкендах. Настоятельно рекомендуется использовать эти генераторы, чтобы изменения в поведенииdraw_path_collectionможно было внести глобально.
- draw_tex(gc, x, y, s, prop, angle, *, mtext=None)[source]
-
Отобразить объект TeX.
- Параметры:
-
-
gc
GraphicsContextBase -
Контекст графики.
- xfloat
-
Положение x текста в координатах отображения.
- yfloat
-
Положение y базовой линии текста в координатах отображения.
- sstr
-
Строка текста TeX.
-
prop
FontProperties -
Свойства шрифта.
- anglefloat
-
Угол поворота против часовой стрелки в градусах.
-
mtext
Text -
Исходный объект текста для отрисовки.
-
gc
- draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)[source]
-
Отобразить объект текста.
- Параметры:
-
-
gc
GraphicsContextBase -
Контекст графики.
- xfloat
-
Положение x текста в координатах отображения.
- yfloat
-
Положение y базовой линии текста в координатах отображения.
- sstr
-
Строка текста.
-
prop
FontProperties -
Свойства шрифта.
- anglefloat
-
Угол поворота против часовой стрелки в градусах.
- ismathbool or "TeX"
-
Если True, использовать анализатор mathtext. Если "TeX", использовать tex для отрисовки.
-
mtext
Text -
Исходный объект текста для отрисовки.
-
gc
Примечания
Примечание для разработчиков бэкэндов:
При попытке определить, правильно ли вы рассчитали область обрезки (что позволяет правильно выполнить выравнивание и расположение текста), полезно изменить строку в 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.convert_psfrags(tmpfile, psfrags, font_preamble, custom_preamble, paper_width, paper_height, orientation)[source]
-
[Устаревшее]
Примечания
Устарело начиная с версии 3.6:
- 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 в вложенный PostScript. Границы прямоугольника (bbox) eps-файла будут заменены заданным значением bbox. Если None, используется исходный bbox.
- matplotlib.backends.backend_ps.quote_ps_string(s)[source]
-
[Устаревшее] Цитатирование опасных символов в строке S для использования в константе строки PostScript.
Примечания
Устарело начиная с версии 3.6: Используйте вместо этого адаптированную копию этой функции.
- matplotlib.backends.backend_ps.xpdf_distill(tmpfile, eps=False, ptype='letter', bbox=None, rotated=False)[source]
-
Использование ps2pdf Ghostscript и pdftops/xpdf (или Poppler) для дистилляции файла. Это позволяет получить более компактные файлы без незаконных операторов вложенного PostScript. Этот дистиллятор предпочтительнее, генерируя PostScript высокого уровня, обрабатывающий текст как текст.
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.7.5/api/backend_ps_api.html