mesh_CSG_compiler.h

/*
 *  Copyright (c) 2000-2025 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 H_GEOGRAM_MESH_MESH_CSG_COMPILER_H
#define H_GEOGRAM_MESH_MESH_CSG_COMPILER_H
 
#include <geogram/basic/common.h>
#include <geogram/mesh/mesh_CSG_builder.h>
 
#include <filesystem>
#include <map>
 
namespace GEO {
 
    class ProgressTask;
 
    class GEOGRAM_API CSGCompiler {
    public:
 
    typedef GEOCSG::Value Value;
    typedef GEOCSG::ArgList ArgList;
 
    CSGCompiler();
 
    std::shared_ptr<Mesh> compile_file(
        const std::filesystem::path& input_filename
    );
    std::shared_ptr<Mesh> compile_string(const std::string& source);
 
    void set_verbose(bool x) {
        builder_->set_verbose(x);
    }
 
    void set_detailed_verbose(bool x) {
        builder_->set_detailed_verbose(x);
    }
 
    CSGBuilder& builder() {
        return *builder_;
    }
 
    const CSGBuilder& builder() const {
        return *builder_;
    }
 
    protected:
 
    /***** Parser *******************************************/
 
    void    parse_instruction_or_object();
    void    parse_object();
    void    parse_instruction();
    ArgList parse_arg_list();
    Value   parse_value();
    Value   parse_array();
    bool    is_object(const std::string& id) const;
    bool    is_instruction(const std::string& id) const;
 
    bool is_modifier(int toktype) const;
 
    /***** Parser internals ********************************/
 
    struct Token {
        Token();
        std::string to_string() const;
        int type;
        std::string str_val;
        int int_val;
        double double_val;
        bool boolean_val;
    };
 
    void next_token_check(char c);
 
    Token next_token();
 
    Token lookahead_token();
 
    Token next_token_internal();
 
    int lines() const;
 
    int line() const;
 
    [[noreturn]] void syntax_error(const char* msg);
 
    [[noreturn]] void syntax_error(const char* msg, const Token& tok);
 
    protected:
    void compute_lines() const;
 
    private:
    std::filesystem::path filename_;
    void* lex_;
    Token lookahead_token_;
    ProgressTask* progress_;
    std::shared_ptr<CSGBuilder> builder_;
    mutable index_t lines_;
    mutable index_t line_;
    mutable const char* line_ptr_;
    };
 
}
 
#endif