karl- / pb_stl

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

pb_Stl

An STL importer/exporter for Unity.

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

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.

pb_stl's Issues

Stl import at runtime

I have a question how should I execute the import script during runtime?

I give the path to the Importer.Import() method but nothing happens.
Is there any other parameter that I should add to the method besides the path?

STL default dimensions

i have a question regarding the default metric unit system when converting to STL.

Import STL file，How to convert from right to left handed coordinates?

When import STL file，How to convert from right to left handed coordinates?

Readme is out of date

To export, you should not use Edit => Export
but Asset => Export Model

The Mesh direction is probably reversed.

The Mesh direction is probably reversed.

User

You maybe train for me user project or example run unity. Thanks.

this sux plez help

i made something in unity and when i exported it with the stl thing and put in my 3d slicer it was covered in the mesh filter object that i chose please help me

Import STL async?

Convert ImportBinary() method to use an byte[]

using (FileStream fs = new FileStream(path, FileMode.Open, FileAccess.Read))
{
using (BinaryReader br = new BinaryReader(fs, new ASCIIEncoding()))
{
while (br.BaseStream.Position < br.BaseStream.Length)
{
}
}
}

Would it be as simple as changing this piece to

using (BinaryWriter bw = new BinaryWriter(new MemoryStream()))
{
bw.Write( * byteArray here * );
using (BinaryReader br = new BinaryReader(bw.BaseStream, new ASCIIEncoding()))
{
while (br.BaseStream.Position < br.BaseStream.Length)
{
}
}
}

How can I get STL file from SkinnedMeshRenderer?

I want to get STL file from a morphed animation.
This animation is created on 3DS MAX and I want to get STL file at any time I want.
Play the animation and stop the animation, then export STL file.
But my model is SkinnedMeshRenderer so this plugin is not working well for my model.
Please help me.
Thank you.

Hi! please, how can I import via script in runtime?

How can I import an STL to a GO in runtime via script? which functions? maybe add the infos to the readme file? THANKS!

Mesh indexformat

With Unity 2017.3 they added the ability to import meshes over 65k vertices by increasing the indexformat to 32 bit. Would it be possible to manually set the indexformat on the stl importer, or have it check for vertice count > 65k and automatically flag it?

Import .stl with IndexFormat.UInt32 lead to 0 triangles

I don't know why but if I import a .stl file with indexFormat option UInt32 the instantiated object with mesh filter has no triangles but all vertices. Does anybody know where this comes from?

Incorrect IndexFormat.UInt32 support

pb_Stl/Runtime/Importer.cs

Line 446 in f13d4ca

indexFormat = indexFormat

"indexFormat = indexFormat" have to be put before "triangles = t", or else it will fail to set indexes.

Importing STL from Fusion 360 results in gigantic mesh

Hi there, thanks for this tool, it'll be super useful for my workflow. I'm wondering about the dimensions of imported files. I've got a 6 meter diameter ring exported from Fusion, but it's absolutely massive in-game. Here's the imported ring with a 1 meter cube inside for scale. The ring had to be scaled down to 0.0005 on all axes to get it to this size - everything is scaled up 1000x compared to Fusion. Is this expected behavior?

I have a question about Mesh.

Hello, it's a good day. I would appreciate it if you could understand that I use a translator because I can't speak English.

Mesh[] mesh = Importer.Import(path);

I created STL file that I want to import through the phrase, with several meshes.

But here, the meshes were divided into several pieces, so is there a standard for dividing the pieces?

I'm wondering if there's a way to bring the whole piece or divide it into the pieces you want. #

Transition to Scripted Importer

2017.1 introduces ScriptedImporter which could make the pb_Stl_AssetPostProcessor obsolete.

https://docs.unity3d.com/Manual/ScriptedImporters.html
https://github.com/karl-/pb_Stl/blob/master/Assets/pb_Stl/Editor/pb_Stl_AssetPostProcessor.cs

Vertice count increases drastically on import

An object which Blender tells me have 12k vertices somehow ends up with 70k vertices after using this script to import it to Unity. With Unity's 65k max vertices count pr mesh this is an obvious problem, not to mention performance in general.

I have a question about importing STL during runtime.

https://stackoverflow.com/questions/46733430/convert-mesh-to-stl-obj-fbx-in-runtime
At the end of the answer at the address above, I confirmed and tried that STL can be fetched during runtime.
But the code didn't work as I expected.
The error appeared from the part called pb_stl.
The following is declared using alt + enter to check whether the related namespace is not called.
using Parabox.Stl;
Nevertheless the code showed an error.
please help me.