pyrender2 0.2.0__tar.gz → 0.2.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {pyrender2-0.2.0 → pyrender2-0.2.2}/PKG-INFO +43 -55
- pyrender2-0.2.2/README.md +80 -0
- pyrender2-0.2.2/pyrender/version.py +1 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender2.egg-info/PKG-INFO +43 -55
- pyrender2-0.2.0/README.md +0 -92
- pyrender2-0.2.0/pyrender/version.py +0 -1
- {pyrender2-0.2.0 → pyrender2-0.2.2}/LICENSE +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyproject.toml +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/__init__.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/camera.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/constants.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/font.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/fonts/OpenSans-Bold.ttf +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/fonts/OpenSans-BoldItalic.ttf +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/fonts/OpenSans-ExtraBold.ttf +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/fonts/OpenSans-ExtraBoldItalic.ttf +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/fonts/OpenSans-Italic.ttf +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/fonts/OpenSans-Light.ttf +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/fonts/OpenSans-LightItalic.ttf +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/fonts/OpenSans-Regular.ttf +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/fonts/OpenSans-Semibold.ttf +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/fonts/OpenSans-SemiboldItalic.ttf +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/light.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/material.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/mesh.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/node.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/offscreen.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/platforms/__init__.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/platforms/base.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/platforms/egl.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/platforms/osmesa.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/platforms/pyglet_platform.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/primitive.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/renderer.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/sampler.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/scene.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shader_program.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/debug_quad.frag +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/debug_quad.vert +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/flat.frag +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/flat.vert +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/mesh.frag +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/mesh.vert +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/mesh_depth.frag +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/mesh_depth.vert +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/segmentation.frag +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/segmentation.vert +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/text.frag +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/text.vert +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/vertex_normals.frag +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/vertex_normals.geom +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/vertex_normals.vert +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/shaders/vertex_normals_pc.geom +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/texture.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/trackball.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/utils.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender/viewer.py +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender2.egg-info/SOURCES.txt +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender2.egg-info/dependency_links.txt +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender2.egg-info/requires.txt +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/pyrender2.egg-info/top_level.txt +0 -0
- {pyrender2-0.2.0 → pyrender2-0.2.2}/setup.cfg +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: pyrender2
|
|
3
|
-
Version: 0.2.
|
|
3
|
+
Version: 0.2.2
|
|
4
4
|
Summary: Easy-to-use Python renderer for 3D visualization
|
|
5
5
|
Author-email: Matthew Matl <matthewcmatl@gmail.com>
|
|
6
6
|
Maintainer-email: Jasper Phelps <jasper.s.phelps@gmail.com>
|
|
@@ -60,26 +60,22 @@ Dynamic: license-file
|
|
|
60
60
|
|
|
61
61
|
# Pyrender
|
|
62
62
|
|
|
63
|
-
[](https://travis-ci.org/mmatl/pyrender)
|
|
64
63
|
[](https://pyrender.readthedocs.io/en/latest/?badge=latest)
|
|
65
|
-
[](https://pepy.tech/project/pyrender)
|
|
64
|
+
[](https://badge.fury.io/py/pyrender2)
|
|
65
|
+
[](https://pepy.tech/project/pyrender2)
|
|
68
66
|
|
|
69
|
-
|
|
70
|
-
|
|
67
|
+
> [!NOTE]
|
|
68
|
+
> This is a fork of [pyrender](https://github.com/mmatl/pyrender) by Matthew Matl, updated for compatibility with numpy v2. Install via `pip install pyrender2`, but you still `import pyrender`, meaning your existing python code will just work if you switch to this fork (`pip uninstall pyrender` -> `pip install pyrender2`).
|
|
69
|
+
|
|
70
|
+
Pyrender is a pure Python 3 library for physically-based rendering and visualization.
|
|
71
71
|
It is designed to meet the [glTF 2.0 specification from Khronos](https://www.khronos.org/gltf/).
|
|
72
72
|
|
|
73
73
|
Pyrender is lightweight, easy to install, and simple to use.
|
|
74
|
-
It comes packaged with both an intuitive scene viewer and a headache-free
|
|
75
|
-
offscreen renderer with support for GPU-accelerated rendering on headless
|
|
76
|
-
servers, which makes it perfect for machine learning applications.
|
|
74
|
+
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.
|
|
77
75
|
|
|
78
76
|
Extensive documentation, including a quickstart guide, is provided [here](https://pyrender.readthedocs.io/en/latest/).
|
|
79
77
|
|
|
80
|
-
For a minimal working example of GPU-accelerated offscreen rendering using EGL,
|
|
81
|
-
check out the [EGL Google CoLab Notebook](https://colab.research.google.com/drive/1pcndwqeY8vker3bLKQNJKr3B-7-SYenE?usp=sharing).
|
|
82
|
-
|
|
78
|
+
For a minimal working example of GPU-accelerated offscreen rendering using EGL, check out the [EGL Google CoLab Notebook](https://colab.research.google.com/drive/1pcndwqeY8vker3bLKQNJKr3B-7-SYenE?usp=sharing).
|
|
83
79
|
|
|
84
80
|
<p align="center">
|
|
85
81
|
<img width="48%" src="https://github.com/mmatl/pyrender/blob/master/docs/source/_static/rotation.gif?raw=true" alt="GIF of Viewer"/>
|
|
@@ -90,63 +86,55 @@ check out the [EGL Google CoLab Notebook](https://colab.research.google.com/driv
|
|
|
90
86
|
You can install pyrender directly from pip.
|
|
91
87
|
|
|
92
88
|
```bash
|
|
93
|
-
pip install
|
|
89
|
+
pip install pyrender2
|
|
94
90
|
```
|
|
95
91
|
|
|
96
92
|
## Features
|
|
97
93
|
|
|
98
94
|
Despite being lightweight, pyrender has lots of features, including:
|
|
99
95
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
* Metallic-roughness materials for physically-based rendering, including several
|
|
108
|
-
types of texture and normal mapping.
|
|
109
|
-
* Transparency.
|
|
110
|
-
* Depth and color image generation.
|
|
96
|
+
- Simple interoperation with the amazing [trimesh](https://github.com/mikedh/trimesh) project, which enables out-of-the-box support for dozens of mesh types, including OBJ, STL, DAE, OFF, PLY, and GLB.
|
|
97
|
+
- An easy-to-use scene viewer with support for animation, showing face and vertex normals, toggling lighting conditions, and saving images and GIFs.
|
|
98
|
+
- An offscreen rendering module that supports OSMesa and EGL backends.
|
|
99
|
+
- Shadow mapping for directional and spot lights.
|
|
100
|
+
- Metallic-roughness materials for physically-based rendering, including several types of texture and normal mapping.
|
|
101
|
+
- Transparency.
|
|
102
|
+
- Depth and color image generation.
|
|
111
103
|
|
|
112
104
|
## Sample Usage
|
|
113
105
|
|
|
114
|
-
For sample usage, check out the [quickstart
|
|
115
|
-
guide](https://pyrender.readthedocs.io/en/latest/examples/index.html) or one of
|
|
116
|
-
the Google CoLab Notebooks:
|
|
106
|
+
For sample usage, check out the [quickstart guide](https://pyrender.readthedocs.io/en/latest/examples/index.html) or one of the Google CoLab Notebooks:
|
|
117
107
|
|
|
118
|
-
|
|
108
|
+
- [EGL Google CoLab Notebook](https://colab.research.google.com/drive/1pcndwqeY8vker3bLKQNJKr3B-7-SYenE?usp=sharing)
|
|
119
109
|
|
|
120
110
|
## Viewer Keyboard and Mouse Controls
|
|
121
111
|
|
|
122
112
|
When using the viewer, the basic controls for moving about the scene are as follows:
|
|
123
113
|
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
114
|
+
- To rotate the camera about the center of the scene, hold the left mouse button and drag the cursor.
|
|
115
|
+
- To rotate the camera about its viewing axis, hold `CTRL` left mouse button and drag the cursor.
|
|
116
|
+
- To pan the camera, do one of the following:
|
|
117
|
+
- Hold `SHIFT`, then hold the left mouse button and drag the cursor.
|
|
118
|
+
- Hold the middle mouse button and drag the cursor.
|
|
119
|
+
- To zoom the camera in or out, do one of the following:
|
|
120
|
+
- Scroll the mouse wheel.
|
|
121
|
+
- Hold the right mouse button and drag the cursor.
|
|
132
122
|
|
|
133
123
|
The available keyboard commands are as follows:
|
|
134
124
|
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
As a note, displaying shadows significantly slows down rendering, so if you're
|
|
151
|
-
experiencing low framerates, just kill shadows or reduce the number of lights in
|
|
152
|
-
your scene.
|
|
125
|
+
- `a`: Toggles rotational animation mode.
|
|
126
|
+
- `c`: Toggles backface culling.
|
|
127
|
+
- `f`: Toggles fullscreen mode.
|
|
128
|
+
- `h`: Toggles shadow rendering.
|
|
129
|
+
- `i`: Toggles axis display mode (no axes, world axis, mesh axes, all axes).
|
|
130
|
+
- `l`: Toggles lighting mode (scene lighting, Raymond lighting, or direct lighting).
|
|
131
|
+
- `m`: Toggles face normal visualization.
|
|
132
|
+
- `n`: Toggles vertex normal visualization.
|
|
133
|
+
- `o`: Toggles orthographic camera mode.
|
|
134
|
+
- `q`: Quits the viewer.
|
|
135
|
+
- `r`: Starts recording a GIF, and pressing again stops recording and opens a file dialog.
|
|
136
|
+
- `s`: Opens a file dialog to save the current view as an image.
|
|
137
|
+
- `w`: Toggles wireframe mode (scene default, flip wireframes, all wireframe, or all solid).
|
|
138
|
+
- `z`: Resets the camera to the default view.
|
|
139
|
+
|
|
140
|
+
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.
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# Pyrender
|
|
2
|
+
|
|
3
|
+
[](https://pyrender.readthedocs.io/en/latest/?badge=latest)
|
|
4
|
+
[](https://badge.fury.io/py/pyrender2)
|
|
5
|
+
[](https://pepy.tech/project/pyrender2)
|
|
6
|
+
|
|
7
|
+
> [!NOTE]
|
|
8
|
+
> This is a fork of [pyrender](https://github.com/mmatl/pyrender) by Matthew Matl, updated for compatibility with numpy v2. Install via `pip install pyrender2`, but you still `import pyrender`, meaning your existing python code will just work if you switch to this fork (`pip uninstall pyrender` -> `pip install pyrender2`).
|
|
9
|
+
|
|
10
|
+
Pyrender is a pure Python 3 library for physically-based rendering and visualization.
|
|
11
|
+
It is designed to meet the [glTF 2.0 specification from Khronos](https://www.khronos.org/gltf/).
|
|
12
|
+
|
|
13
|
+
Pyrender is lightweight, easy to install, and simple to use.
|
|
14
|
+
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.
|
|
15
|
+
|
|
16
|
+
Extensive documentation, including a quickstart guide, is provided [here](https://pyrender.readthedocs.io/en/latest/).
|
|
17
|
+
|
|
18
|
+
For a minimal working example of GPU-accelerated offscreen rendering using EGL, check out the [EGL Google CoLab Notebook](https://colab.research.google.com/drive/1pcndwqeY8vker3bLKQNJKr3B-7-SYenE?usp=sharing).
|
|
19
|
+
|
|
20
|
+
<p align="center">
|
|
21
|
+
<img width="48%" src="https://github.com/mmatl/pyrender/blob/master/docs/source/_static/rotation.gif?raw=true" alt="GIF of Viewer"/>
|
|
22
|
+
<img width="48%" src="https://github.com/mmatl/pyrender/blob/master/docs/source/_static/damaged_helmet.png?raw=true" alt="Damaged Helmet"/>
|
|
23
|
+
</p>
|
|
24
|
+
|
|
25
|
+
## Installation
|
|
26
|
+
You can install pyrender directly from pip.
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
pip install pyrender2
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Features
|
|
33
|
+
|
|
34
|
+
Despite being lightweight, pyrender has lots of features, including:
|
|
35
|
+
|
|
36
|
+
- Simple interoperation with the amazing [trimesh](https://github.com/mikedh/trimesh) project, which enables out-of-the-box support for dozens of mesh types, including OBJ, STL, DAE, OFF, PLY, and GLB.
|
|
37
|
+
- An easy-to-use scene viewer with support for animation, showing face and vertex normals, toggling lighting conditions, and saving images and GIFs.
|
|
38
|
+
- An offscreen rendering module that supports OSMesa and EGL backends.
|
|
39
|
+
- Shadow mapping for directional and spot lights.
|
|
40
|
+
- Metallic-roughness materials for physically-based rendering, including several types of texture and normal mapping.
|
|
41
|
+
- Transparency.
|
|
42
|
+
- Depth and color image generation.
|
|
43
|
+
|
|
44
|
+
## Sample Usage
|
|
45
|
+
|
|
46
|
+
For sample usage, check out the [quickstart guide](https://pyrender.readthedocs.io/en/latest/examples/index.html) or one of the Google CoLab Notebooks:
|
|
47
|
+
|
|
48
|
+
- [EGL Google CoLab Notebook](https://colab.research.google.com/drive/1pcndwqeY8vker3bLKQNJKr3B-7-SYenE?usp=sharing)
|
|
49
|
+
|
|
50
|
+
## Viewer Keyboard and Mouse Controls
|
|
51
|
+
|
|
52
|
+
When using the viewer, the basic controls for moving about the scene are as follows:
|
|
53
|
+
|
|
54
|
+
- To rotate the camera about the center of the scene, hold the left mouse button and drag the cursor.
|
|
55
|
+
- To rotate the camera about its viewing axis, hold `CTRL` left mouse button and drag the cursor.
|
|
56
|
+
- To pan the camera, do one of the following:
|
|
57
|
+
- Hold `SHIFT`, then hold the left mouse button and drag the cursor.
|
|
58
|
+
- Hold the middle mouse button and drag the cursor.
|
|
59
|
+
- To zoom the camera in or out, do one of the following:
|
|
60
|
+
- Scroll the mouse wheel.
|
|
61
|
+
- Hold the right mouse button and drag the cursor.
|
|
62
|
+
|
|
63
|
+
The available keyboard commands are as follows:
|
|
64
|
+
|
|
65
|
+
- `a`: Toggles rotational animation mode.
|
|
66
|
+
- `c`: Toggles backface culling.
|
|
67
|
+
- `f`: Toggles fullscreen mode.
|
|
68
|
+
- `h`: Toggles shadow rendering.
|
|
69
|
+
- `i`: Toggles axis display mode (no axes, world axis, mesh axes, all axes).
|
|
70
|
+
- `l`: Toggles lighting mode (scene lighting, Raymond lighting, or direct lighting).
|
|
71
|
+
- `m`: Toggles face normal visualization.
|
|
72
|
+
- `n`: Toggles vertex normal visualization.
|
|
73
|
+
- `o`: Toggles orthographic camera mode.
|
|
74
|
+
- `q`: Quits the viewer.
|
|
75
|
+
- `r`: Starts recording a GIF, and pressing again stops recording and opens a file dialog.
|
|
76
|
+
- `s`: Opens a file dialog to save the current view as an image.
|
|
77
|
+
- `w`: Toggles wireframe mode (scene default, flip wireframes, all wireframe, or all solid).
|
|
78
|
+
- `z`: Resets the camera to the default view.
|
|
79
|
+
|
|
80
|
+
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.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
__version__ = '0.2.2'
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: pyrender2
|
|
3
|
-
Version: 0.2.
|
|
3
|
+
Version: 0.2.2
|
|
4
4
|
Summary: Easy-to-use Python renderer for 3D visualization
|
|
5
5
|
Author-email: Matthew Matl <matthewcmatl@gmail.com>
|
|
6
6
|
Maintainer-email: Jasper Phelps <jasper.s.phelps@gmail.com>
|
|
@@ -60,26 +60,22 @@ Dynamic: license-file
|
|
|
60
60
|
|
|
61
61
|
# Pyrender
|
|
62
62
|
|
|
63
|
-
[](https://travis-ci.org/mmatl/pyrender)
|
|
64
63
|
[](https://pyrender.readthedocs.io/en/latest/?badge=latest)
|
|
65
|
-
[](https://pepy.tech/project/pyrender)
|
|
64
|
+
[](https://badge.fury.io/py/pyrender2)
|
|
65
|
+
[](https://pepy.tech/project/pyrender2)
|
|
68
66
|
|
|
69
|
-
|
|
70
|
-
|
|
67
|
+
> [!NOTE]
|
|
68
|
+
> This is a fork of [pyrender](https://github.com/mmatl/pyrender) by Matthew Matl, updated for compatibility with numpy v2. Install via `pip install pyrender2`, but you still `import pyrender`, meaning your existing python code will just work if you switch to this fork (`pip uninstall pyrender` -> `pip install pyrender2`).
|
|
69
|
+
|
|
70
|
+
Pyrender is a pure Python 3 library for physically-based rendering and visualization.
|
|
71
71
|
It is designed to meet the [glTF 2.0 specification from Khronos](https://www.khronos.org/gltf/).
|
|
72
72
|
|
|
73
73
|
Pyrender is lightweight, easy to install, and simple to use.
|
|
74
|
-
It comes packaged with both an intuitive scene viewer and a headache-free
|
|
75
|
-
offscreen renderer with support for GPU-accelerated rendering on headless
|
|
76
|
-
servers, which makes it perfect for machine learning applications.
|
|
74
|
+
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.
|
|
77
75
|
|
|
78
76
|
Extensive documentation, including a quickstart guide, is provided [here](https://pyrender.readthedocs.io/en/latest/).
|
|
79
77
|
|
|
80
|
-
For a minimal working example of GPU-accelerated offscreen rendering using EGL,
|
|
81
|
-
check out the [EGL Google CoLab Notebook](https://colab.research.google.com/drive/1pcndwqeY8vker3bLKQNJKr3B-7-SYenE?usp=sharing).
|
|
82
|
-
|
|
78
|
+
For a minimal working example of GPU-accelerated offscreen rendering using EGL, check out the [EGL Google CoLab Notebook](https://colab.research.google.com/drive/1pcndwqeY8vker3bLKQNJKr3B-7-SYenE?usp=sharing).
|
|
83
79
|
|
|
84
80
|
<p align="center">
|
|
85
81
|
<img width="48%" src="https://github.com/mmatl/pyrender/blob/master/docs/source/_static/rotation.gif?raw=true" alt="GIF of Viewer"/>
|
|
@@ -90,63 +86,55 @@ check out the [EGL Google CoLab Notebook](https://colab.research.google.com/driv
|
|
|
90
86
|
You can install pyrender directly from pip.
|
|
91
87
|
|
|
92
88
|
```bash
|
|
93
|
-
pip install
|
|
89
|
+
pip install pyrender2
|
|
94
90
|
```
|
|
95
91
|
|
|
96
92
|
## Features
|
|
97
93
|
|
|
98
94
|
Despite being lightweight, pyrender has lots of features, including:
|
|
99
95
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
* Metallic-roughness materials for physically-based rendering, including several
|
|
108
|
-
types of texture and normal mapping.
|
|
109
|
-
* Transparency.
|
|
110
|
-
* Depth and color image generation.
|
|
96
|
+
- Simple interoperation with the amazing [trimesh](https://github.com/mikedh/trimesh) project, which enables out-of-the-box support for dozens of mesh types, including OBJ, STL, DAE, OFF, PLY, and GLB.
|
|
97
|
+
- An easy-to-use scene viewer with support for animation, showing face and vertex normals, toggling lighting conditions, and saving images and GIFs.
|
|
98
|
+
- An offscreen rendering module that supports OSMesa and EGL backends.
|
|
99
|
+
- Shadow mapping for directional and spot lights.
|
|
100
|
+
- Metallic-roughness materials for physically-based rendering, including several types of texture and normal mapping.
|
|
101
|
+
- Transparency.
|
|
102
|
+
- Depth and color image generation.
|
|
111
103
|
|
|
112
104
|
## Sample Usage
|
|
113
105
|
|
|
114
|
-
For sample usage, check out the [quickstart
|
|
115
|
-
guide](https://pyrender.readthedocs.io/en/latest/examples/index.html) or one of
|
|
116
|
-
the Google CoLab Notebooks:
|
|
106
|
+
For sample usage, check out the [quickstart guide](https://pyrender.readthedocs.io/en/latest/examples/index.html) or one of the Google CoLab Notebooks:
|
|
117
107
|
|
|
118
|
-
|
|
108
|
+
- [EGL Google CoLab Notebook](https://colab.research.google.com/drive/1pcndwqeY8vker3bLKQNJKr3B-7-SYenE?usp=sharing)
|
|
119
109
|
|
|
120
110
|
## Viewer Keyboard and Mouse Controls
|
|
121
111
|
|
|
122
112
|
When using the viewer, the basic controls for moving about the scene are as follows:
|
|
123
113
|
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
114
|
+
- To rotate the camera about the center of the scene, hold the left mouse button and drag the cursor.
|
|
115
|
+
- To rotate the camera about its viewing axis, hold `CTRL` left mouse button and drag the cursor.
|
|
116
|
+
- To pan the camera, do one of the following:
|
|
117
|
+
- Hold `SHIFT`, then hold the left mouse button and drag the cursor.
|
|
118
|
+
- Hold the middle mouse button and drag the cursor.
|
|
119
|
+
- To zoom the camera in or out, do one of the following:
|
|
120
|
+
- Scroll the mouse wheel.
|
|
121
|
+
- Hold the right mouse button and drag the cursor.
|
|
132
122
|
|
|
133
123
|
The available keyboard commands are as follows:
|
|
134
124
|
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
As a note, displaying shadows significantly slows down rendering, so if you're
|
|
151
|
-
experiencing low framerates, just kill shadows or reduce the number of lights in
|
|
152
|
-
your scene.
|
|
125
|
+
- `a`: Toggles rotational animation mode.
|
|
126
|
+
- `c`: Toggles backface culling.
|
|
127
|
+
- `f`: Toggles fullscreen mode.
|
|
128
|
+
- `h`: Toggles shadow rendering.
|
|
129
|
+
- `i`: Toggles axis display mode (no axes, world axis, mesh axes, all axes).
|
|
130
|
+
- `l`: Toggles lighting mode (scene lighting, Raymond lighting, or direct lighting).
|
|
131
|
+
- `m`: Toggles face normal visualization.
|
|
132
|
+
- `n`: Toggles vertex normal visualization.
|
|
133
|
+
- `o`: Toggles orthographic camera mode.
|
|
134
|
+
- `q`: Quits the viewer.
|
|
135
|
+
- `r`: Starts recording a GIF, and pressing again stops recording and opens a file dialog.
|
|
136
|
+
- `s`: Opens a file dialog to save the current view as an image.
|
|
137
|
+
- `w`: Toggles wireframe mode (scene default, flip wireframes, all wireframe, or all solid).
|
|
138
|
+
- `z`: Resets the camera to the default view.
|
|
139
|
+
|
|
140
|
+
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.
|
pyrender2-0.2.0/README.md
DELETED
|
@@ -1,92 +0,0 @@
|
|
|
1
|
-
# Pyrender
|
|
2
|
-
|
|
3
|
-
[](https://travis-ci.org/mmatl/pyrender)
|
|
4
|
-
[](https://pyrender.readthedocs.io/en/latest/?badge=latest)
|
|
5
|
-
[](https://coveralls.io/github/mmatl/pyrender?branch=master)
|
|
6
|
-
[](https://badge.fury.io/py/pyrender)
|
|
7
|
-
[](https://pepy.tech/project/pyrender)
|
|
8
|
-
|
|
9
|
-
Pyrender is a pure Python (2.7, 3.4, 3.5, 3.6) library for physically-based
|
|
10
|
-
rendering and visualization.
|
|
11
|
-
It is designed to meet the [glTF 2.0 specification from Khronos](https://www.khronos.org/gltf/).
|
|
12
|
-
|
|
13
|
-
Pyrender is lightweight, easy to install, and simple to use.
|
|
14
|
-
It comes packaged with both an intuitive scene viewer and a headache-free
|
|
15
|
-
offscreen renderer with support for GPU-accelerated rendering on headless
|
|
16
|
-
servers, which makes it perfect for machine learning applications.
|
|
17
|
-
|
|
18
|
-
Extensive documentation, including a quickstart guide, is provided [here](https://pyrender.readthedocs.io/en/latest/).
|
|
19
|
-
|
|
20
|
-
For a minimal working example of GPU-accelerated offscreen rendering using EGL,
|
|
21
|
-
check out the [EGL Google CoLab Notebook](https://colab.research.google.com/drive/1pcndwqeY8vker3bLKQNJKr3B-7-SYenE?usp=sharing).
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
<p align="center">
|
|
25
|
-
<img width="48%" src="https://github.com/mmatl/pyrender/blob/master/docs/source/_static/rotation.gif?raw=true" alt="GIF of Viewer"/>
|
|
26
|
-
<img width="48%" src="https://github.com/mmatl/pyrender/blob/master/docs/source/_static/damaged_helmet.png?raw=true" alt="Damaged Helmet"/>
|
|
27
|
-
</p>
|
|
28
|
-
|
|
29
|
-
## Installation
|
|
30
|
-
You can install pyrender directly from pip.
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
pip install pyrender
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
## Features
|
|
37
|
-
|
|
38
|
-
Despite being lightweight, pyrender has lots of features, including:
|
|
39
|
-
|
|
40
|
-
* Simple interoperation with the amazing [trimesh](https://github.com/mikedh/trimesh) project,
|
|
41
|
-
which enables out-of-the-box support for dozens of mesh types, including OBJ,
|
|
42
|
-
STL, DAE, OFF, PLY, and GLB.
|
|
43
|
-
* An easy-to-use scene viewer with support for animation, showing face and vertex
|
|
44
|
-
normals, toggling lighting conditions, and saving images and GIFs.
|
|
45
|
-
* An offscreen rendering module that supports OSMesa and EGL backends.
|
|
46
|
-
* Shadow mapping for directional and spot lights.
|
|
47
|
-
* Metallic-roughness materials for physically-based rendering, including several
|
|
48
|
-
types of texture and normal mapping.
|
|
49
|
-
* Transparency.
|
|
50
|
-
* Depth and color image generation.
|
|
51
|
-
|
|
52
|
-
## Sample Usage
|
|
53
|
-
|
|
54
|
-
For sample usage, check out the [quickstart
|
|
55
|
-
guide](https://pyrender.readthedocs.io/en/latest/examples/index.html) or one of
|
|
56
|
-
the Google CoLab Notebooks:
|
|
57
|
-
|
|
58
|
-
* [EGL Google CoLab Notebook](https://colab.research.google.com/drive/1pcndwqeY8vker3bLKQNJKr3B-7-SYenE?usp=sharing)
|
|
59
|
-
|
|
60
|
-
## Viewer Keyboard and Mouse Controls
|
|
61
|
-
|
|
62
|
-
When using the viewer, the basic controls for moving about the scene are as follows:
|
|
63
|
-
|
|
64
|
-
* To rotate the camera about the center of the scene, hold the left mouse button and drag the cursor.
|
|
65
|
-
* To rotate the camera about its viewing axis, hold `CTRL` left mouse button and drag the cursor.
|
|
66
|
-
* To pan the camera, do one of the following:
|
|
67
|
-
* Hold `SHIFT`, then hold the left mouse button and drag the cursor.
|
|
68
|
-
* Hold the middle mouse button and drag the cursor.
|
|
69
|
-
* To zoom the camera in or out, do one of the following:
|
|
70
|
-
* Scroll the mouse wheel.
|
|
71
|
-
* Hold the right mouse button and drag the cursor.
|
|
72
|
-
|
|
73
|
-
The available keyboard commands are as follows:
|
|
74
|
-
|
|
75
|
-
* `a`: Toggles rotational animation mode.
|
|
76
|
-
* `c`: Toggles backface culling.
|
|
77
|
-
* `f`: Toggles fullscreen mode.
|
|
78
|
-
* `h`: Toggles shadow rendering.
|
|
79
|
-
* `i`: Toggles axis display mode (no axes, world axis, mesh axes, all axes).
|
|
80
|
-
* `l`: Toggles lighting mode (scene lighting, Raymond lighting, or direct lighting).
|
|
81
|
-
* `m`: Toggles face normal visualization.
|
|
82
|
-
* `n`: Toggles vertex normal visualization.
|
|
83
|
-
* `o`: Toggles orthographic camera mode.
|
|
84
|
-
* `q`: Quits the viewer.
|
|
85
|
-
* `r`: Starts recording a GIF, and pressing again stops recording and opens a file dialog.
|
|
86
|
-
* `s`: Opens a file dialog to save the current view as an image.
|
|
87
|
-
* `w`: Toggles wireframe mode (scene default, flip wireframes, all wireframe, or all solid).
|
|
88
|
-
* `z`: Resets the camera to the default view.
|
|
89
|
-
|
|
90
|
-
As a note, displaying shadows significantly slows down rendering, so if you're
|
|
91
|
-
experiencing low framerates, just kill shadows or reduce the number of lights in
|
|
92
|
-
your scene.
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
__version__ = '0.2.0'
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|