На этом шаге мы перечислим функции, используемые для управления.
Все инструменты, которые предоставляет Mayavi для управления сценой, располагаются в пакете mayavi.mlab.
- Функция clf(). Выполняет очистку сцены. Прототип функции:
clf(figure=None)Параметры функции:
- figure
- Сцена, содержимое которой необходимо очистить. Если значение равно None, то будет очищена текущая сцена.
- Функция close(). Закрывает сцену. Прототип функции:
close(scene=None, all=False)
Параметры функции:
- scene
- Идентификатор фигуры, которую нужно закрыть, может быть числом, строкой либо объектом Scene. Если значение равно None, то будет закрыта текущая сцена.
- all
- Если параметр равен True, то будут закрыты все существующие сцены.
- Функция draw(). Выполняет принудительную перерисовку сцены. Прототип функции:
draw(figure=None)Параметры функции:
- figure
- Сцена, которую нужно перерисовать. Если значение равно None, то будет перерисована текущая сцена.
- Функция gcf(). Возвращает указатель на текущую сцену. Прототип функции:
gcf(engine=None)Параметры функции:
- engine
- Движок, из которого будет получена сцена, используется если вы работаете с несколькими движками.
- Функция savefig(). Сохраняет содержимое сцены в виде изображения. Функция предоставляет возможность сохранить изображение в одном
из следующих форматов: png, jpg, bmp, tiff, ps, eps, pdf, rib (renderman), oogl (geomview), iv (Openlnventor), vrml, obj (wavefront).
Прототип функции:
savefig(filename, size=None, figure=None, magnification='auto', **kwargs)
Параметры функции:
- filename
- Имя файла для сохранения.
- size
- Размер сохраняемого изображения.
- figure
- Сцена, которую нужно сохранить как изображение.
- magnification
- Масштабный коэффициент для перевода изображения с экрана в сохраняемое изображение.
- Функция screenshot(). Возвращает содержимое сцены (изображение) как массив. Прототип функции:
screenshot(figure=None, mode='rgb', antialiased=False)
Параметры функции:
- figure
- Сцена, изображение с которой будет взято.
- mode
- Цветовой режим изображения: {'rgb', 'rgba'}.
- Antialiased
- Если значение равно True, то при рендеринге скриншота будет использоваться антиализинг.
- Функция figure(). Создаёт новую сцену или возвращает текущую. Прототип функции:
figure(figure=None, bgcolor=None, fgcolor=None, engine=None, size=(400, 350))
Параметры функции:
- figure
- Если параметр равен None, то будет возвращена текущая сцена, иначе будет создана новая.
- bgcolor
- Цвет заднего фона сцены.
- fgcolor
- Цвет текстовых элементов на сцене.
- engine
- Движок Mayavi для управления фигурой.
- size
- Размер сцены. Значение по умолчанию (400, 350).
На следующем шаге мы закончим изучение этого вопроса.
