Options.h

/*
 * Copyright 2026 Adobe. All rights reserved.
 * This file is licensed to you under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License. You may obtain a copy
 * of the License at http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under
 * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
 * OF ANY KIND, either express or implied. See the License for the specific language
 * governing permissions and limitations under the License.
 */
#pragma once
 
#include <lagrange/AttributeFwd.h>
#include <lagrange/utils/warning.h>
 
#include <Eigen/Core>
 
#include <cstdint>
#include <functional>
#include <map>
#include <string>
#include <variant>
#include <vector>
 
namespace lagrange {
namespace raycasting {

enum class ProjectMode {
    CLOSEST_VERTEX [[deprecated]] = 0, 
    CLOSEST_POINT [[deprecated]] = 1, 
    RAY_CASTING [[deprecated]] = 2, 
    ClosestVertex = 0, 
    ClosestPoint = 1, 
    RayCasting =
        2, 
};

enum class CastMode {
    ONE_WAY [[deprecated]] = 0, 
    BOTH_WAYS [[deprecated]] = 1, 
    OneWay = 0, 
    BothWays = 1, 
};

enum class FallbackMode {
    CONSTANT [[deprecated]] = 0, 
    CLOSEST_VERTEX [[deprecated]] = 1, 
    CLOSEST_POINT [[deprecated]] = 2, 
    Constant = 0, 
    ClosestVertex = 1, 
    ClosestPoint = 2, 
};
 
using WrapMode [[deprecated]] = FallbackMode; 
 
inline const std::map<std::string, ProjectMode>& project_modes()
{
    LA_IGNORE_DEPRECATION_WARNING_BEGIN
    static std::map<std::string, ProjectMode> _modes = {
        {"CLOSEST_VERTEX", ProjectMode::CLOSEST_VERTEX},
        {"CLOSEST_POINT", ProjectMode::CLOSEST_POINT},
        {"RAY_CASTING", ProjectMode::RAY_CASTING},
        {"ClosestVertex", ProjectMode::ClosestVertex},
        {"ClosestPoint", ProjectMode::ClosestPoint},
        {"RayCasting", ProjectMode::RayCasting},
    };
    LA_IGNORE_DEPRECATION_WARNING_END
    return _modes;
}
 
inline const std::map<std::string, CastMode>& cast_modes()
{
    LA_IGNORE_DEPRECATION_WARNING_BEGIN
    static std::map<std::string, CastMode> _modes = {
        {"ONE_WAY", CastMode::ONE_WAY},
        {"BOTH_WAYS", CastMode::BOTH_WAYS},
        {"OneWay", CastMode::OneWay},
        {"BothWays", CastMode::BothWays},
    };
    LA_IGNORE_DEPRECATION_WARNING_END
    return _modes;
}
 
inline const std::map<std::string, FallbackMode>& fallback_modes()
{
    LA_IGNORE_DEPRECATION_WARNING_BEGIN
    static std::map<std::string, FallbackMode> _modes = {
        {"CONSTANT", FallbackMode::CONSTANT},
        {"CLOSEST_VERTEX", FallbackMode::CLOSEST_VERTEX},
        {"CLOSEST_POINT", FallbackMode::CLOSEST_POINT},
        {"Constant", FallbackMode::Constant},
        {"ClosestVertex", FallbackMode::ClosestVertex},
        {"ClosestPoint", FallbackMode::ClosestPoint},
    };
    LA_IGNORE_DEPRECATION_WARNING_END
    return _modes;
}
 
[[deprecated]] inline const std::map<std::string, FallbackMode>& wrap_modes()
{
    return fallback_modes();
}


struct ProjectCommonOptions
{
    std::vector<AttributeId> attribute_ids;

    bool project_vertices = true;

    std::function<bool(uint64_t)> skip_vertex = nullptr;
};

struct ProjectDirectionalOptions : public ProjectCommonOptions
{
    std::variant<std::monostate, Eigen::Vector3f, AttributeId> direction = {};

    CastMode cast_mode = CastMode::BothWays;

    FallbackMode fallback_mode = FallbackMode::Constant;

    double default_value = 0.0;

    std::function<void(uint64_t, bool)> user_callback = nullptr;
};

struct ProjectOptions : ProjectDirectionalOptions
{
    ProjectMode project_mode = ProjectMode::ClosestPoint;
};

 
} // namespace raycasting
} // namespace lagrange