summaryrefslogtreecommitdiff
path: root/README.md
blob: 08b173d060aa2166fb613392678f9a672abaa9c6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

# stlscope

This little program will allow you to view STL files from your terminal. It
uses [Go](https://golang.org/) as the programming language,
[OpenGL](https://www.opengl.org/) to render the graphics and
[GLFW](https://www.glfw.org/) to create a window to display the model. To use
OpenGL and GLFW with the Go language a lot of code is used from the [go-gl
project](https://github.com/go-gl/). At the moment it is only usable via the
command line interface.

![Image is missing](data/example.png "stlscope")

## Usage

It could not be simpler:

```
$ stlscope myfile.stl
```

Have a look at `stlscope -h` to learn about further options.

## Development Milestones

Done (most recent first):
- [x] improve graphics to better display the model (ambient and diffuse
      lighting)
- [x] package for Arch Linux (get a PKGBUILD file from [here](https://cgit.xengineering.eu/pkgbuilds/tree/stlscope))
- [x] implement Makefile to support building
- [x] implement minimal viable product

To do (most important first):
- [ ] add support for ASCII STL format
- [ ] allow window resizing
- [ ] implement controls to modify view
- [ ] improve performance with GPU-based matrix-matrix-multiplication
- [ ] create icon for stlscope
- [ ] add desktop support
- [ ] release version 1.0.0

## Further Ressources

- [Antons OpenGL tutorial](https://antongerdelan.net/opengl/)
- [OpenGL, GLFW and Go tutorial](https://kylewbanks.com/blog/tutorial-opengl-with-golang-part-1-hello-opengl)