Skip to content

Read STL File

Group (Subgroup)

IO (Input)


This Filter will read a binary STL File and create a Triangle Geometry object in memory. The STL reader is very strict to the STL specification. An explanation of the STL file format can be found on Wikipedia. The structure of the file is as follows:

UINT8[80]     Header
UINT32     Number of triangles

foreach triangle
REAL32[3]     Normal vector
REAL32[3]     Vertex 1
REAL32[3]     Vertex 2
REAL32[3]     Vertex 3
UINT16     Attribute byte count

It is very important that the "Attribute byte Count" is correct as DREAM.3D follows the specification strictly. If you are writing an STL file be sure that the value for the "Attribute byte count" is zero (0). If you chose to encode additional data into a section after each triangle then be sure that the "Attribute byte count" is set correctly. DREAM.3D will obey the value located in the "Attribute byte count".


Name Type Description
STL File File Path The input .stl file path

Required Geometry

Not Applicable

Required Objects


Created Objects

Kind Default Name Type Component Dimensions Description
Data Container TriangleDataContainer N/A N/A Created Data Container name with a Triangle Geometry
Attribute Matrix FaceData Face N/A Created Face Attribute Matrix name
Face Attribute Array FaceNormals double (3) Specifies the normal of each Face

Example Pipelines

Please see the description file distributed with this Plugin

DREAM.3D Mailing Lists

If you need more help with a Filter, please consider asking your question on the DREAM.3D Users Google group!