https://github.com/sshirokov/stltwalker

Scriptable .STL 3D model processor
https://github.com/sshirokov/stltwalker

Last synced: about 2 months ago
JSON representation

Scriptable .STL 3D model processor

• Host: GitHub
• URL: https://github.com/sshirokov/stltwalker
• Owner: sshirokov
• License: mit
• Created: 2012-11-21T21:07:57.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2014-02-05T19:05:20.000Z (over 10 years ago)
• Last Synced: 2024-07-12T19:00:48.035Z (2 months ago)
• Language: C
• Homepage:
• Size: 317 KB
• Stars: 33
• Watchers: 9
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
A scriptable interface for STL transformation and accumilation.

## Quickstart

```bash

$ git clone https://github.com/sshirokov/stltwalker.git

$ cd stltwalker

$ make

$ ./stltwalker -h

./stltwalker [-options] {file0 [--operations]..}..{fileN [--operations]..}

	v0.0.3

Options:

	-h	Show help

	-I	Copy maximum 1 input object to output memory directly.

	-L 	Maximum result object length

	-W 	Maximum result object width

	-H 	Maximum result object height

	-p	Pack input objects automatically

	-b 	Set packing margin

	-o filename	Output the resulting composite object to `filename'

	-r	Do not center and raise object above the Z plane on load

	-R	Do not center and raise the result object above the Z plane

	-Z	Apply all pending transforms and place the current model on the Z plane

	-D	Increase the detail with which the result is described

Transforms:

	--scale=	Scale the model by a constant factor

	--rotateX=	Rotate the model around the X axis (degrees)

	--rotateY=	Rotate the model around the Y axis (degrees)

	--rotateZ=	Rotate the model around the Z axis (degrees)

	--translate=	Translate the model along a vector 

```

`-L`, `-W`, and `-H` will change the exit status of the application to non-zero as well as printing the failure.

## Eyedropping Demo With Special Effects

### Packing

The `-p` option asks stltwalker to pack the input objects on the build platform.

The packing margin can be adjusted with `-b 25.0`

```bash

$ ./stltwalker -p data/jaws.stl --rotateZ=45.0 \

                  data/jaws.stl                \

                  data/jaws.stl                \

                  -o /tmp/packed.stl

```

Which should result in something like this:

![stltwalker packing composite](http://cl.ly/image/3L2p13000R32/Image%202012.12.18%201:49:05%20AM.png)

### Compositing

By default, the inputs are transformed and added to the build platform.

```bash

$ ./stltwalker data/jaws.stl --rotateZ=10                      \

               data/jaws.stl --translate=0,30,0                \

               data/jaws.stl --translate=0,-30,0 --rotateZ=180 \

               -o /tmp/out.stl

[INFO] (src/stltwalker.c:114) Loaded: data/jaws.stl

[INFO] (src/stltwalker.c:114) Loaded: data/jaws.stl

[INFO] (src/stltwalker.c:114) Loaded: data/jaws.stl

[INFO] (src/stltwalker.c:147) Output contains 840 facets

[INFO] (src/stltwalker.c:152) Writing result object to: '/tmp/out.stl'

```

Which should produce something like [this](http://cl.ly/image/3i1L2l39330H) when rendered or printed:

![stltwalker jaws composite](http://f.cl.ly/items/2J1U2F360Z3J2S0A0B1P/Image%202012.11.24%2011:51:35%20PM.png)

### Licence

[MIT](http://opensource.org/licenses/MIT)