Skip to content

Commit b38c348

Browse files
author
Martin Naumann
committed
README added
1 parent 097770b commit b38c348

1 file changed

Lines changed: 26 additions & 0 deletions

File tree

README.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
three-software-renderer
2+
=======================
3+
##Universal Three.js in-memory renderer for node.js and the browser
4+
5+
# What's this for?
6+
The `SoftwareRenderer` is a drop-in renderer for [Three.js](http://www.three.js.org) that can be used on the server and the client,
7+
if you need to be GPU independent.
8+
9+
# What's the drawback?
10+
Primarily performance. As this renderer does not have access to GPU acceleration and GPU shader units, it's much much slower than the CanvasRenderer or WebGLRenderer.
11+
12+
# What are possible use cases?
13+
* Rendering in a web worker, e.g. for static renderings that should happen in the background
14+
* Rendering on the server, e.g. for preview images of 3D models
15+
* Tell me, if you have other ideas
16+
17+
# Which Three.js version is this compatible with?
18+
So far I have tested 0.69 and 0.71. Please tell me if you tried it with other versions as well :-)
19+
20+
# What is this work based on?
21+
First and foremost this is just a modified copy of the SoftwareRenderer found in [the Three.js example sources](https://github.com/mrdoob/three.js/blob/0b07813dc45481f1d16d3b6d2334178664861465/examples/js/renderers/SoftwareRenderer.js).
22+
It also uses the modified [THREE.Projector](https://github.com/mrdoob/three.js/blob/20b77b2785afaa4d00a1ecd222e6de1a3ec76006/examples/js/renderers/Projector.js) from the examples.
23+
24+
# I found a bug, how can I help?
25+
Please help me improve this module by opening an issue on Github. If you have an idea what might cause the problem, I'd be very grateful if you'd try to investigate the bug and make a pull request to this repository.
26+
If you have any questions or need help doing so, let me know via the issues in this project!

0 commit comments

Comments
 (0)