caiyu/gmio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
625 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%
64b1acd310
Go to file
Hugues Delorme 64b1acd310 Update README |skip_ci]
2016-03-16 12:26:11 +01:00
benchmarks benchmark_opencascade: fix crash 2016-03-16 12:25:54 +01:00
doc doc: rename mainpage.c -> mainpage.dox 2016-03-14 17:41:56 +01:00
examples Rename gmio_vec3 structs 2016-03-14 17:07:05 +01:00
src gmio_core: fix fallback of gmio_powf() 2016-03-14 17:35:18 +01:00
tests Rename gmio_vec3 structs 2016-03-14 17:07:05 +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: specify config in "cmake --build" commands 2016-03-09 10:33:01 +01:00
CMakeLists.txt Add more C99 compat functions 2016-03-14 17:07:06 +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 Update README |skip_ci] 2016-03-16 12:26:11 +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 (C90 conformance) and feature-rich.

Main highlights:

  • "Abstract" streams that does not tie the user to C stream(FILE*)
  • 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, ...)
  • Multiple solids from stream(eg. 4 solids in STL ascii file)

In addition, the STL module has the following advatanges:

  • The user keeps its own geometry data structures, no mesh conversion needed
  • Fixed memory consumption and independant of the mesh size
  • Seamless use of OpenCascade StlMesh_Mesh in gmio(see gmio_support)

Building gmio

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

Read the Build instructions

How to report a bug

The gmio bug tracking system is open to the public at https://github.com/fougue/gmio/issues.

If you think you have found a bug in gmio, we would like to hear about it so that we can fix it.

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
  • 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

Credits

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