STLA_IO
Read and Write Routines
ASCII STL 3D Graphics Files

STLA_IO is a library of MATLAB routines, using double precision arithmetic, which includes routines to read or write the 3D graphics information stored in an ASCII STL (stereolithography) file.

Especially if you are reading large ASCII STL files, you might want to consider the STLA_SIZE_FAST and STLA_READ_FAST routines, provided by Bill Seufzer of NASA Langley. These will run more quickly in MATLAB than the routines STLA_SIZE and STLA_READ.

Related Data and Programs:

IVCON is an executable C++ program which can convert graphics information between ASCII STL and other formats.

IVREAD is an executable FORTRAN90 program which can convert graphics information between ASCII STL and other formats.

STLA is a data directory which contains some examples of ASCII STL files.

STLA_DISPLAY is a MATLAB program which can read an ASCII STL file and display it on the screen.

STLA_IO is also available in a C++ version and a FORTRAN90 version.

Reference:

1. 3D Systems, Inc,
   Stereolithography Interface Specification,
   October 1989.

Tar File:

A GZIP'ed TAR file of the contents of this directory is available. This is only done as a convenience for users who want ALL the files, and don't want to download them individually. This is not a convenience for me, so don't be surprised if the tar file is somewhat out of date.

• stla_io_m_src.tar.csh the commands used to create the GZIP'ed TAR file.
• stla_io_m_src.tar.gz the GZIP'ed TAR file.

Source Code:

• ch_cap.m capitalizes a character.
• ch_eqi.m case-insensitive comparison of two characters.
• ch_is_digit.m is true if a character represents a digit.
• ch_to_digit.m converts a character to the digit it represents.
• r8vec_cross_3d.m computes the cross product of two vectors in 3D.
• s_cat.m concatenates two strings to make a third string.
• s_eqi.m is a case insensitive comparison of two strings for equality.
• s_len_trim.m returns the length of a string to the last nonblank.
• s_to_r8.m reads an R8 from a string.
• stla_check.m checks an ASCII STL file.
• stla_face_node_print.m prints the nodes making up each face in an ASCII STL file.
• stla_face_normal_compute.m computes normal vectors for an ASCII STL file.
• stla_face_normal_print.m prints normal vectors for an ASCII STL file.
• stla_node_xyz_print.m prints the node coordinates.
• stla_read.m reads graphics information from an ASCII STL file.
• stla_read_fast.m reads graphics information from an ASCII STL file; this routine should run much faster than stla_read.
• stla_size.m determines sizes associated with an ASCII STL file.
• stla_size_fast.m determines sizes associated with an ASCII STL file; this routine should run much faster than stla_size.
• stla_size_print.m prints sizes associated with an ASCII STL file.
• stla_write.m writes graphics information to an ASCII STL file.
• timestamp.m prints the current YMDHMS date as a time stamp.
• word_next_read.m "reads" words from a string, one at a time.

Examples and Tests:

• stla_io_test.m, commands to run all the tests.
• stla_io_test01.m, tests STLA_CHECK.
• stla_io_test02.m, tests STLA_SIZE.
• stla_io_test03.m, tests STLA_READ.
• stla_io_test04.m, tests STLA_WRITE.
• stla_io_test05.m, tests STLA_FACE_NORMAL_COMPUTE.
• stla_io_test06.m, calls MATLAB's TRIMESH routine to make an image of an ASCII STL file.
• stla_io_test07.m, compares the time required by STLA_SIZE and STLA_SIZE_FAST.
• stla_io_test08.m, compares the time required by STLA_READ and STLA_READ_FAST.
• cube.stla, a simple ASCII STL file that describes a cube.
• cube_new.stla, an ASCII STL file describing a cube, written by STLA_WRITE.
• cube.png, a PNG image of the cube, create by MATLAB's TRIMESH routine.
• sphere.stla, an ASCII STL file that describes a sphere.
• teapot.stla, an ASCII STL file that describes a teapot.
• stla_io_test.out, the output from a run of the sample program.

You can go up one level to the MATLAB source codes.