Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fogleman/fauxgl
Software-only 3D renderer written in Go.
https://github.com/fogleman/fauxgl
3d go graphics opengl rendering
Last synced: 6 days ago
JSON representation
Software-only 3D renderer written in Go.
- Host: GitHub
- URL: https://github.com/fogleman/fauxgl
- Owner: fogleman
- License: mit
- Created: 2017-01-18T02:15:55.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-04-18T22:13:46.000Z (over 1 year ago)
- Last Synced: 2024-12-29T22:13:27.133Z (13 days ago)
- Topics: 3d, go, graphics, opengl, rendering
- Language: Go
- Homepage:
- Size: 8.79 MB
- Stars: 874
- Watchers: 25
- Forks: 68
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-golang-repositories - fauxgl - only 3D renderer written in Go. (Repositories)
README
# FauxGL
3D software rendering in pure Go. No OpenGL, no C extensions, no nothin'.
### About
It's like OpenGL, but it's not. It's FauxGL.
It doesn't use your graphics card, only your CPU. So it's slow and unsuitable for realtime rendering. But it's still pretty fast. It works the same way OpenGL works - rasterizing.
### Features
- STL, OBJ, PLY, 3DS file formats
- triangle rasterization
- vertex and fragment "shaders"
- view volume clipping
- face culling
- alpha blending
- textures
- triangle & line meshes
- depth biasing
- wireframe rendering
- built-in shapes (plane, sphere, cube, cylinder, cone)
- anti-aliasing (via supersampling)
- voxel rendering
- parallel processing
### Performance
FauxGL uses all of your CPU cores. But none of your GPU.
Rendering the Stanford Dragon shown above (871306 triangles) at 1920x1080px takes about 150 milliseconds on my machine. With 4x4=16x supersampling, it takes about 950 milliseconds. This is the time to render a frame and does not include loading the mesh from disk.
### Go Get
go get -u github.com/fogleman/fauxgl
### Go Run
cd go/src/github.com/fogleman/fauxgl
go run examples/hello.go
### Go Doc
https://godoc.org/github.com/fogleman/fauxgl
### Complete Example
```go
package main
import (
. "github.com/fogleman/fauxgl"
"github.com/nfnt/resize"
)
const (
scale = 1 // optional supersampling
width = 1920 // output width in pixels
height = 1080 // output height in pixels
fovy = 30 // vertical field of view in degrees
near = 1 // near clipping plane
far = 10 // far clipping plane
)
var (
eye = V(-3, 1, -0.75) // camera position
center = V(0, -0.07, 0) // view center position
up = V(0, 1, 0) // up vector
light = V(-0.75, 1, 0.25).Normalize() // light direction
color = HexColor("#468966") // object color
)
func main() {
// load a mesh
mesh, err := LoadOBJ("examples/dragon.obj")
if err != nil {
panic(err)
}
// fit mesh in a bi-unit cube centered at the origin
mesh.BiUnitCube()
// smooth the normals
mesh.SmoothNormalsThreshold(Radians(30))
// create a rendering context
context := NewContext(width*scale, height*scale)
context.ClearColorBufferWith(HexColor("#FFF8E3"))
// create transformation matrix and light direction
aspect := float64(width) / float64(height)
matrix := LookAt(eye, center, up).Perspective(fovy, aspect, near, far)
// use builtin phong shader
shader := NewPhongShader(matrix, light, eye)
shader.ObjectColor = color
context.Shader = shader
// render
context.DrawMesh(mesh)
// downsample image for antialiasing
image := context.Image()
image = resize.Resize(width, height, image, resize.Bilinear)
// save image
SavePNG("out.png", image)
}
```
