texture_compositing.h

/*
 * Copyright 2025 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/image/Array3D.h>
#include <lagrange/image/View3D.h>
 
#include <optional>
#include <string_view>
#include <utility>
 
namespace lagrange::texproc {


enum class GradientNormalization {
    PerEdge,

    PerTexelSqrt,
};

struct CompositingOptions
{
    double value_weight = 1e3;

    unsigned int quadrature_samples = 6;

    double jitter_epsilon = 1e-4;

    std::optional<std::pair<double, double>> clamp_to_range = std::nullopt;

    GradientNormalization gradient_normalization = GradientNormalization::PerTexelSqrt;

    bool use_direct_solver = false;

    double stiffness_regularization_weight = 1e-9;

    bool smooth_low_weight_areas = false;

    std::optional<bool> sanity_check = std::nullopt;

    struct SolverOptions
    {
        unsigned int num_multigrid_levels = 4;

        unsigned int num_gauss_seidel_iterations = 2;

        unsigned int num_v_cycles = 4;
    } solver;
};

template <typename ValueType>
struct ConstWeightedTextureView
{
    image::experimental::View3D<const ValueType> texture;

    image::experimental::View3D<const float> weights;
};

template <typename Scalar, typename Index, typename ValueType>
image::experimental::Array3D<ValueType> texture_compositing(
    const SurfaceMesh<Scalar, Index>& mesh,
    std::vector<ConstWeightedTextureView<ValueType>> textures,
    const CompositingOptions& options = {});

 
} // namespace lagrange::texproc