Metadata-Version: 2.1
Name: stl-stretch
Version: 0.1
Summary: Stretches just part of an stl file
Home-page: https://github.com/thatch/stl_stretch
Author: Tim Hatch
Author-email: tim@timhatch.com
License: BSD
Platform: UNKNOWN
Description-Content-Type: text/markdown

# STL Stretch

This script lets you modify stl files by scaling them, including by scaling just
a section along an axis.

Requirements:

* Python 2.7+ including Python 3.x
* Nose in order to run the tests

## How does it work?

For example, let's say you have this file, but want it to be wider:

![original](docs/a.png)

You coud scale it by a fixed amount through the whole way, but that will make
the circles out of round, which you might need for screws or something else:

![scale by 1.6 in x](docs/b.png)

To use this script, you need to find (or guess and iterate) on the coordinates
the bound where you want to modify, for example to stretch between X=9 and X=15,
the script divides it into 3 segments:

![3 segments](docs/c.png)

The no-op change would be `python stl.py --stretch "X 9 15 0" -o new.stl
old.stl`.  Note the `0`.  If you want to expand this region by 7.5 units
(typically mm by convention) then change the `0` to `7.5`.

![middle segment stretched](docs/d.png)

The resulting file is one without gaps, those are just for illustration.


