read.fs.surface.stl.ascii: Read surface mesh in STL ASCII format.

View source: R/read_fs_surface.R

read.fs.surface.stl.asciiR Documentation

Read surface mesh in STL ASCII format.

Description

The STL format is a mesh format that is often used for 3D printing, it stores geometry information. It is known as stereolithography format. A binary and an ASCII version exist. This function reads the ASCII version.

Usage

read.fs.surface.stl.ascii(filepath, digits = 6L)

Arguments

filepath

full path to surface mesh file in STL format.

digits

the precision (number of digits after decimal separator) to use when determining whether two x,y,z coords define the same vertex. This is used when the polygon soup is turned into an indexed mesh.

Value

an ‘fs.surface' instance. The normals are available in the ’metadata' property.

Note

The STL format does not use indices into a vertex list to define faces, instead it repeats vertex coords in each face ('polygon soup'). Therefore, the mesh needs to be reconstructed, which requires the 'misc3d' package.

References

See https://en.wikipedia.org/wiki/STL_(file_format) for a format description.


freesurferformats documentation built on May 29, 2024, 5:29 a.m.