mesh_io.h

Go to the documentation of this file.

/*
 *  Copyright (c) 2000-2022 Inria
 *  All rights reserved.
 *
 *  Redistribution and use in source and binary forms, with or without
 *  modification, are permitted provided that the following conditions are met:
 *
 *  * Redistributions of source code must retain the above copyright notice,
 *  this list of conditions and the following disclaimer.
 *  * Redistributions in binary form must reproduce the above copyright notice,
 *  this list of conditions and the following disclaimer in the documentation
 *  and/or other materials provided with the distribution.
 *  * Neither the name of the ALICE Project-Team nor the names of its
 *  contributors may be used to endorse or promote products derived from this
 *  software without specific prior written permission.
 *
 *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 *  POSSIBILITY OF SUCH DAMAGE.
 *
 *  Contact: Bruno Levy
 *
 *     https://www.inria.fr/fr/bruno-levy
 *
 *     Inria,
 *     Domaine de Voluceau,
 *     78150 Le Chesnay - Rocquencourt
 *     FRANCE
 *
 */
 
#ifndef GEOGRAM_MESH_NEW_MESH_IO
#define GEOGRAM_MESH_NEW_MESH_IO
 
#include <geogram/basic/common.h>
#include <geogram/basic/numeric.h>
#include <geogram/basic/factory.h>
#include <geogram/basic/attributes.h>
#include <geogram/mesh/mesh.h>
#include <string>
 
namespace GEO {
 
    class InputGeoFile;
    class OutputGeoFile;
 
    enum MeshAttributesFlags {
        MESH_NO_ATTRIBUTES = 0,
        MESH_VERTEX_REGION = 1,
        MESH_VERTEX_TEX_COORD = 2,
        MESH_VERTEX_COLOR = 4,
        MESH_FACET_REGION = 8,
        MESH_CELL_REGION = 16,
        MESH_EDGE_REGION = 32,
        MESH_ALL_ATTRIBUTES = 255
    };
 
 
    class GEOGRAM_API MeshIOFlags {
    public:
    MeshIOFlags();
 
    coord_index_t dimension() const {
        return dimension_;
    }
 
    void set_dimension(coord_index_t x) {
        dimension_ = x;
    }
 
    MeshAttributesFlags attributes() const {
        return attributes_;
    }
 
    void set_attributes(MeshAttributesFlags x) {
        attributes_ = x;
    }
 
    void set_attribute(MeshAttributesFlags x) {
        attributes_ = MeshAttributesFlags(attributes_ | x);
    }
 
    void reset_attribute(MeshAttributesFlags& x) {
        attributes_ = MeshAttributesFlags(attributes_ & ~x);
    }
 
    bool has_attribute(MeshAttributesFlags x) const {
        return (attributes_ & x) != 0;
    }
 
    MeshElementsFlags elements() const {
        return elements_;
    }
 
    void set_elements(MeshElementsFlags x) {
        elements_ = x;
    }
 
    void set_element(MeshElementsFlags x) {
        elements_ = MeshElementsFlags(elements_ | x);
    }
 
    void reset_element(MeshElementsFlags x) {
        elements_ = MeshElementsFlags(elements_ & ~x);
    }
 
    bool has_element(MeshElementsFlags x) const {
        return (elements_ & x) != 0;
    }
 
    void set_texture_filename(const std::string& x) {
        texture_filename_ = x;
    }
 
    const std::string& get_texture_filename() const {
        return texture_filename_;
    }
 
    void set_verbose(bool x) {
        verbose_ = x;
    }
 
    bool verbose() const {
        return verbose_;
    }
 
    private:
    coord_index_t dimension_;
    MeshAttributesFlags attributes_;
    MeshElementsFlags elements_;
    std::string texture_filename_;
    bool verbose_;
    };
 
 
    bool GEOGRAM_API mesh_load(
        const std::string& filename, Mesh& M,
        const MeshIOFlags& ioflags = MeshIOFlags()
    );
 
    bool GEOGRAM_API mesh_load(
        InputGeoFile& geofile, Mesh& M,
        const MeshIOFlags& ioflags = MeshIOFlags()
    );
 
 
    bool GEOGRAM_API mesh_save(
        const Mesh& M, const std::string& filename,
        const MeshIOFlags& ioflags = MeshIOFlags()
    );
 
    bool GEOGRAM_API mesh_save(
        const Mesh& M, OutputGeoFile& geofile,
        const MeshIOFlags& ioflags = MeshIOFlags()
    );
 
 
    /*************************************************************************/
 
    class GEOGRAM_API MeshIOHandler : public Counted {
    public:
        static MeshIOHandler* create(const std::string& format);
 
        static MeshIOHandler* get_handler(const std::string& filename);
 
        virtual bool load(
            const std::string& filename, Mesh& M,
            const MeshIOFlags& ioflags = MeshIOFlags()
        ) = 0;
 
        virtual bool save(
            const Mesh& M, const std::string& filename,
            const MeshIOFlags& ioflags = MeshIOFlags()
        ) = 0;
 
    protected:
        MeshIOHandler() {
        }
 
        ~MeshIOHandler() override;
 
        virtual void bind_attributes(
            const Mesh& M, const MeshIOFlags& flags, bool create
        );
        virtual void unbind_attributes();
 
    protected:
        Attribute<index_t> vertex_region_;
        Attribute<index_t> edge_region_;
        Attribute<index_t> facet_region_;
        Attribute<index_t> cell_region_;
    };
 
    typedef SmartPointer<MeshIOHandler> MeshIOHandler_var;
 
    typedef Factory0<MeshIOHandler> MeshIOHandlerFactory;
 
#define geo_register_MeshIOHandler_creator(type, name)          \
    geo_register_creator(GEO::MeshIOHandlerFactory, type, name)
 
 
    void GEOGRAM_API mesh_io_initialize() ;
}
 
#endif