======================================================

C library for geometry input/output

gmio is a reusable C library whose purpose is to provide complete I/O support for various CAD file formats (eg. STL)

gmio aims to be fast, portable (C90 conformance) and feature-rich. Main highlights:

• "Abstract" streams that does not tie the user to C stream (FILE*)

gmio provides a general stream structure based on callbacks, so that any API can be used (C++ streams, QFile, ...)

• Buffering of input/ouput for efficient device usage
• Operations can be easily aborted
• Progress report about the I/O operation
• Available under the CeCILL-B license, which is fully BSD compatible

Supported CAD files format

Current version only supports the STL file format (STereoLithography), but support is complete :

• ASCII format: Case-insensitive reading
• ASCII format: Output format(%f, %e, ...) and precision of floats support
• Binary format: Little/big endian support
• Binary format: 80-byte header and facet "attribute byte count" support
• Detection of the input format
• Retrieval of infomations about contents(facet count, solid name, ...)

In addition, the STL module has the following advatanges:

• The user keeps its own geometry data structures, no conversion needed

This reduces the effort so that the user just specifies callbacks for retrieval/creation of mesh data

• Constant memory footprint

Memory consumption is indenpendant of the mesh size ie. the amount of memory used remains constant during the I/O operation

• Extended support of OpenCascade

  StlMesh_Mesh objects can be used seamlessly with gmio

Building gmio

gmio can be built with CMake, by default a static library is generated.

Read the Build instructions

How to report a bug

If you think you have found a bug in gmio, we would like to hear about it so that we can fix it. The gmio bug tracking system is open to the public at https://github.com/fougue/gmio/issues.

Always include the following information in your bug report: the name and version number of your compiler; the name and version number of your operating system; the version of gmio you are using, and what configure options it was compiled with.

If the problem you are reporting is only visible at run-time, try to create a small test program that shows the problem when run.

License

This software is governed by the CeCILL-B license under French law and abiding by the rules of distribution of free software. You can use, modify and/ or redistribute the software under the terms of the CeCILL-B license as circulated by CEA, CNRS and INRIA at the following URL http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html

Credits

"gmio" logo rendered with Prism font (thanks to Erik Yin !)