Pinhole
3D Wireframe Drawing Library for Go
Install / Use
/learn @tidwall/PinholeREADME
pinhole
<a href="https://godoc.org/github.com/tidwall/pinhole"><img src="https://img.shields.io/badge/api-reference-blue.svg?style=flat-square" alt="GoDoc"></a>
3D Wireframe Drawing Library for Go
<img src="http://i.imgur.com/EhtVA6C.jpg" width="300" height="300" alt="earth"><img src="http://i.imgur.com/fKe1N3E.jpg" width="300" height="300" alt="shapes"> <img src="http://i.imgur.com/qQRqGPe.jpg" width="300" height="300" alt="spiral"><img src="http://i.imgur.com/FbO8tY4.jpg" width="300" height="300" alt="gopher">
Why does this exist?
I needed a CPU based 3D rendering library with a very simple API for visualizing data structures. No bells or whistles, just clean lines and solid colors.
Getting Started
Installing
To start using pinhole, install Go and run go get:
$ go get -u github.com/tidwall/pinhole
This will retrieve the library.
Using
The coordinate space has a locked origin of 0,0,0 with the min/max boundaries of -1,-1,-1 to +1,+1,+1.
The Z coordinate extends from -1 (nearest) to +1 (farthest).
There are four types of shapes; line, cube, circle, and dot.
These can be transformed with the Scale, Rotate, and Translate functions.
Multiple shapes can be transformed by nesting in a Begin/End block.
A simple cube:
p := pinhole.New()
p.DrawCube(-0.3, -0.3, -0.3, 0.3, 0.3, 0.3)
p.SavePNG("cube.png", 500, 500, nil)
Rotate the cube:
p := pinhole.New()
p.DrawCube(-0.3, -0.3, -0.3, 0.3, 0.3, 0.3)
p.Rotate(math.Pi/3, math.Pi/6, 0)
p.SavePNG("cube.png", 500, 500, nil)
Add, rotate, and transform a circle:
p := pinhole.New()
p.DrawCube(-0.3, -0.3, -0.3, 0.3, 0.3, 0.3)
p.Rotate(math.Pi/3, math.Pi/6, 0)
p.Begin()
p.DrawCircle(0, 0, 0, 0.2)
p.Rotate(0, math.Pi/2, 0)
p.Translate(-0.6, -0.4, 0)
p.Colorize(color.RGBA{255, 0, 0, 255})
p.End()
p.SavePNG("cube.png", 500, 500, nil)
Contact
Josh Baker @tidwall
License
pinhole source code is available under the ISC License.
