How to use IO file formats ​

This page explains how to use OpenGeode file formats in your code.

What to do? ​

You just need to add the following lines to your executable or code, depending on your needs:

  geode::OpenGeodeMeshLibrary::initialize();

  geode::OpenGeodeMeshLibrary::initialize();

and/or

geode::detail::initialize_model_io();

geode::detail::initialize_model_io();

These functions are declared in the files include/geode/io/mesh/detail/common.h and include/geode/io/model/detail/common.h. Make sure to include the appropriate file in your code. You can find examples in the OpenGeode-IO tests.

Why do I have to do that? ​

The reason is quite simple. Take a look at the file OpenGeode-IO/src/geode/io/mesh/common.cpp.

In this file, you can see that supported file formats for meshes are registered when the OpenGeode_IO_mesh library is loaded. However, the I/O code is not directly called in the executable (see tests for examples). As a consequence, the OpenGeode_IO_mesh library is not loaded. This is called lazy loading of dependencies. By calling the function detail::initialize_mesh_io(), the library is loaded, the file formats are registered, and you can use our supported file formats.