Pyrender
Pyrender is a pure Python (2.7, 3.4, 3.5, 3.6) library for physically-based
rendering and visualization.
It is designed to meet the glTF 2.0 specification from Khronos.
Pyrender is lightweight, easy to install, and simple to use.
It comes packaged with both an intuitive scene viewer and a headache-free
offscreen renderer with support for GPU-accelerated rendering on headless
servers, which makes it perfect for machine learning applications.
Extensive documentation, including a quickstart guide, is provided here.
For a minimal working example of offscreen rendering using OSMesa,
check out the OSMesa Google CoLab Notebook.
For a minimal working example of GPU-accelerated offscreen rendering using EGL,
check out the EGL Google CoLab Notebook.
Installation
You can install pyrender directly from pip.
pip install pyrender
Features
Despite being lightweight, pyrender has lots of features, including:
- Simple interoperation with the amazing trimesh project,
which enables out-of-the-box support for dozens of mesh types, including OBJ,
STL, DAE, OFF, PLY, and GLB. - An easy-to-use scene viewer with support for animation, showing face and vertex
normals, toggling lighting conditions, and saving images and GIFs. - An offscreen rendering module that supports OSMesa and EGL backends.
- Shadow mapping for directional and spot lights.
- Metallic-roughness materials for physically-based rendering, including several
types of texture and normal mapping. - Transparency.
- Depth and color image generation.
Sample Usage
For sample usage, check out the quickstart
guide or one of
the Google CoLab Notebooks:
Viewer Keyboard and Mouse Controls
When using the viewer, the basic controls for moving about the scene are as follows:
- To rotate the camera about the center of the scene, hold the left mouse button and drag the cursor.
- To rotate the camera about its viewing axis, hold
CTRLleft mouse button and drag the cursor. - To pan the camera, do one of the following:
- Hold
SHIFT, then hold the left mouse button and drag the cursor. - Hold the middle mouse button and drag the cursor.
- Hold
- To zoom the camera in or out, do one of the following:
- Scroll the mouse wheel.
- Hold the right mouse button and drag the cursor.
The available keyboard commands are as follows:
a: Toggles rotational animation mode.c: Toggles backface culling.f: Toggles fullscreen mode.h: Toggles shadow rendering.i: Toggles axis display mode (no axes, world axis, mesh axes, all axes).l: Toggles lighting mode (scene lighting, Raymond lighting, or direct lighting).m: Toggles face normal visualization.n: Toggles vertex normal visualization.o: Toggles orthographic camera mode.q: Quits the viewer.r: Starts recording a GIF, and pressing again stops recording and opens a file dialog.s: Opens a file dialog to save the current view as an image.w: Toggles wireframe mode (scene default, flip wireframes, all wireframe, or all solid).z: Resets the camera to the default view.
As a note, displaying shadows significantly slows down rendering, so if you're
experiencing low framerates, just kill shadows or reduce the number of lights in
your scene.