AtlasEngine.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/SurfaceMesh.h>
#include <lagrange/xatlas/Options.h>
#include <lagrange/xatlas/api.h>
 
#include <memory>
 
#include <atomic>
#include <cstddef>
#include <cstdint>
#include <functional>
#include <string>
#include <string_view>
 
namespace lagrange::xatlas {

template <typename Scalar, typename Index>
class AtlasEngine
{
public:
    using Mesh = SurfaceMesh<Scalar, Index>;
    using NotificationFunc = std::function<void(const std::string&, float)>;
 
    AtlasEngine();
    ~AtlasEngine();
    AtlasEngine(const AtlasEngine&) = delete;
    AtlasEngine& operator=(const AtlasEngine&) = delete;
    AtlasEngine(AtlasEngine&&) noexcept;
    AtlasEngine& operator=(AtlasEngine&&) noexcept;

    void add_mesh(const Mesh& mesh, const UnwrapOptions& options = {});

    void add_uv_mesh(const Mesh& mesh, const RepackOptions& options = {});

    void clear();

    void compute_charts(const ChartOptions& opts = {});

    void pack_charts(const PackOptions& opts);

    void generate(const ChartOptions& chart_opts, const PackOptions& pack_opts);

    void generate(const UnwrapOptions& opts);

    Mesh extract_mesh(
        size_t mesh_index,
        MultiAtlasPolicy multi_atlas_policy,
        std::string_view output_uv_attribute_name,
        std::string_view output_atlas_attribute_name,
        std::string_view output_chart_attribute_name) const;

    size_t mesh_count() const;

    uint32_t atlas_width() const;

    uint32_t atlas_height() const;

    uint32_t atlas_count() const;

    uint32_t chart_count() const;

    float texels_per_unit() const;

    float utilization(uint32_t atlas_index) const;

    void set_notification_func(NotificationFunc func);

    void set_cancel(const std::atomic_bool* cancel);
 
private:
    struct Impl;
    std::unique_ptr<Impl> m_impl;
};
 
} // namespace lagrange::xatlas