Skip to content
/ pb_Stl Public

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

License

MIT, Unknown licenses found

Licenses found

MIT
LICENSE
Unknown
LICENSE.meta
Notifications You must be signed in to change notification settings

karl-/pb_Stl

Repository files navigation

pb_Stl

An STL importer/exporter for Unity.

pb_Stl is the exporter used in ProBuilder to save STL model files.

stanford_dragon

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
  2. 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.
  2. In the file menu, Edit > Export > STL (Ascii).
  3. 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.

About

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

Topics

Resources

License

MIT, Unknown licenses found

Licenses found

MIT
LICENSE
Unknown
LICENSE.meta

Stars

Watchers

Forks

Packages

No packages published

Languages