https://github.com/karl-/pb_stl

STL import/export for Unity, supporting both ASCII and Binary.
https://github.com/karl-/pb_stl

stl stl-importer unity unity-editor unity-plugin unity3d

Last synced: 1 day ago
JSON representation

STL import/export for Unity, supporting both ASCII and Binary.

• Host: GitHub
• URL: https://github.com/karl-/pb_stl
• Owner: karl-
• License: mit
• Created: 2016-05-25T13:58:40.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-02-26T20:03:26.000Z (10 months ago)
• Last Synced: 2024-12-25T02:06:40.895Z (1 day ago)
• Topics: stl, stl-importer, unity, unity-editor, unity-plugin, unity3d
• Language: C#
• Homepage:
• Size: 6.08 MB
• Stars: 186
• Watchers: 10
• Forks: 46
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# pb_Stl

An STL importer/exporter for Unity.

**pb_Stl** is the exporter used in ProBuilder to save [STL](http://paulbourke.net/dataformats/stl/) model files.

![stanford_dragon](stanford_dragon.png)

## Install

1. In the `Packages` directory of your Unity project, `git clone https://github.com/karl-/pb_Stl.git co.parabox.stl`

or

1. Open `Packages/manifest.json`

1. Add `"co.parabox.stl":"https://github.com/karl-/pb_Stl.git"` to the `"dependencies"` list

## Quick Start

1. Select a `GameObject` in the Scene View with a `MeshFilter` and valid `Mesh`.

1. In the file menu,  `Edit > Export > STL (Ascii)`.

1. View your shiny new STL file.

## Features

- Export and import Binary & ASCII STL files in editor or at runtime.

- Custom AssetPostProcessor automatically creates usable prefabs from any STL imported to Unity.

- Option to convert from left to right handed coordinates (on by default, as per STL spec).

- Automatic merging of multiple selected meshes, including relative transformations.

- Import models with vertex counts larger than Unity max by automatically splitting into multiple meshes.

## Planned Improvements

- Export window with additional options:

    - Swap model axis on import/export.

    - Export as multiple objects or merge (currently always merges).

    - Generate normals on import (with smoothing or no).

    

## Troubleshooting

#### Model is sideways / horizontal / rotated

Unity's coordinate system is left handed, with Y axis as the vertical.  Other 3d modeling programs may have different coordinate systems or axis assignments.  **pb_Stl** exports right handed coordinates by default, but can be modified to retain left handed coordinates.  Support for swapping axes is planned.

## Contributing

If you would like to submit improvements please include NUnit tests for your changes (and make sure they don't break any existing tests).

## License

It's MIT.