caiyu/gmio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
606 Commits 1 Branch 0 Tags 1.9 MiB
C 73.8%
C++ 19.6%
CMake 5.6%
Batchfile 0.5%
Shell 0.3%
Other 0.2%
fdfb87af4c
Go to file
Hugues Delorme fdfb87af4c appveyor: explicitly build tests targets
2016-03-09 10:19:15 +01:00
benchmarks Fix typo 2016-03-08 15:24:48 +01:00
doc README: add logo 2015-11-25 09:53:20 +01:00
examples Introduce GMIO_STL_FORMAT_TAG_BINARY 2016-03-08 10:29:49 +01:00
src gmio_core: fix compilation errors with fallback gmio_snprintf() 2016-03-08 18:22:12 +01:00
tests Add target for "examples" 2016-03-07 17:48:33 +01:00
.gitignore git: ignore any subdirs inside benchmark_other 2015-12-18 10:53:11 +01:00
.travis.yml travis: cmake options implicitly set to OFF when not specified 2016-01-14 09:36:36 +01:00
appveyor.yml appveyor: explicitly build tests targets 2016-03-09 10:19:15 +01:00
CMakeLists.txt gmio_core/internal: add portable snprintf() wrapper 2016-03-08 17:28:43 +01:00
LICENSE_en.txt Rename license files 2015-03-03 16:55:25 +01:00
LICENSE_fr.txt Rename license files 2015-03-03 16:55:25 +01:00
README.md README: credits to Erik Yin 2015-11-27 11:39:27 +01:00
travis-build-script.sh travis: build examples and benchmark_gmio 2016-03-08 10:14:40 +01:00

README.md

gmio_logo ======================================================

Build Status Build status Coverity Scan Build Status Coverage Status License

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 (ISO-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 kind of device can be used (memory, file, socket, ...)
  • Operations can be easily aborted
  • Buffering of input/ouput for efficient device usage
  • 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 :

  • Binary(little/big endian) and ASCII formats
  • Header data and "attribute byte count" for binary format
  • Name of solid for ASCII format
  • Detection of the input data format
  • Ability to specify the text formatting to represent float values

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 geometry data
  • No dynamic memory allocations
  • Extended support of OpenCascade's StlMesh_Mesh

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.

Before reporting a bug, please use the bug-tracker's search functions to see if the issue is already known.

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

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