test/source/blender/freestyle/intern/view_map/Interface1D.h

/* SPDX-FileCopyrightText: 2023 Blender Authors
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */

#pragma once

/** \file
 * \ingroup freestyle
 * \brief Interface 1D and related tools definitions
 */

#include <float.h>
#include <iostream>
#include <string>

#include "Functions0D.h"

#include "../system/Id.h"
#include "../system/Precision.h"

#include "../winged_edge/Nature.h"

#ifdef WITH_CXX_GUARDEDALLOC
#  include "MEM_guardedalloc.h"
#endif

using namespace std;

namespace Freestyle {

// Integration method
/**
 * The different integration methods that can be invoked to integrate into a single value the set
 * of values obtained from each 0D element of a 1D element.
 */
typedef enum {
  /**
   * The value computed for the 1D element is the mean of the values obtained for the 0D elements.
   */
  MEAN,
  /**
   * The value computed for the 1D element is the minimum of the values obtained for the 0D
   * elements.
   */
  MIN,
  /**
   * The value computed for the 1D element is the maximum of the values obtained for the 0D
   * elements.
   */
  MAX,
  /**
   * The value computed for the 1D element is the first of the values obtained for the 0D
   *  elements.
   */
  FIRST,
  /**
   * The value computed for the 1D element is the last of the values obtained for the 0D
   * elements.
   */
  LAST,
} IntegrationType;

/**
 * Returns a single value from a set of values evaluated at each 0D element of this 1D element.
 *
 * \param fun: The UnaryFunction0D used to compute a value at each Interface0D.
 * \param it: The Interface0DIterator used to iterate over the 0D elements of this 1D element.
 * The integration will occur over the 0D elements starting from the one pointed by it.
 * \param it_end: The Interface0DIterator pointing the end of the 0D elements of the 1D element.
 * \param integration_type: The integration method used to compute a single value from a set of
 * values.
 * \return the single value obtained for the 1D element.
 */
template<class T>
T integrate(UnaryFunction0D<T> &fun,
            Interface0DIterator it,
            Interface0DIterator it_end,
            IntegrationType integration_type = MEAN)
{
  T res;
  uint size;
  switch (integration_type) {
    case MIN:
      fun(it);
      res = fun.result;
      ++it;
      for (; !it.isEnd(); ++it) {
        fun(it);
        if (fun.result < res) {
          res = fun.result;
        }
      }
      break;
    case MAX:
      fun(it);
      res = fun.result;
      ++it;
      for (; !it.isEnd(); ++it) {
        fun(it);
        if (fun.result > res) {
          res = fun.result;
        }
      }
      break;
    case FIRST:
      fun(it);
      res = fun.result;
      break;
    case LAST:
      fun(--it_end);
      res = fun.result;
      break;
    case MEAN:
    default:
      fun(it);
      res = fun.result;
      ++it;
      for (size = 1; !it.isEnd(); ++it, ++size) {
        fun(it);
        res += fun.result;
      }
      res /= (size ? size : 1);
      break;
  }
  return res;
}

//
// Interface1D
//
//////////////////////////////////////////////////

/** Base class for any 1D element. */
class Interface1D {
 public:
  /** Default constructor */
  Interface1D()
  {
    _timeStamp = 0;
  }

  /** Destructor */
  virtual ~Interface1D(){};

  /** Returns the string "Interface1D". */
  virtual string getExactTypeName() const
  {
    return "Interface1D";
  }

  // Iterator access

  /** Returns an iterator over the Interface1D vertices, pointing to the first vertex. */
  virtual Interface0DIterator verticesBegin();

  /** Returns an iterator over the Interface1D vertices, pointing after the last vertex. */
  virtual Interface0DIterator verticesEnd();

  /** Returns an iterator over the Interface1D points, pointing to the first point. The difference
   * with verticesBegin() is that here we can iterate over points of the 1D element at a any given
   * sampling. Indeed, for each iteration, a virtual point is created.
   *
   * \param t: The sampling with which we want to iterate over points of this 1D element.
   */
  virtual Interface0DIterator pointsBegin(float t = 0.0f);

  /** Returns an iterator over the Interface1D points, pointing after the last point. The
   * difference with verticesEnd() is that here we can iterate over points of the 1D element at a
   * any given sampling. Indeed, for each iteration, a virtual point is created.
   *
   * \param t: The sampling with which we want to iterate over points of this 1D element.
   */
  virtual Interface0DIterator pointsEnd(float t = 0.0f);

  // Data access methods

  /** Returns the 2D length of the 1D element. */
  virtual real getLength2D() const;

  /** Returns the Id of the 1D element. */
  virtual Id getId() const;

  // FIXME: ce truc n'a rien a faire la...(c une requete complexe qui doit etre ds les Function1D)
  /** Returns the nature of the 1D element. */
  virtual Nature::EdgeNature getNature() const;

  /** Returns the time stamp of the 1D element. Mainly used for selection. */
  virtual uint getTimeStamp() const
  {
    return _timeStamp;
  }

  /** Sets the time stamp for the 1D element. */
  inline void setTimeStamp(uint iTimeStamp)
  {
    _timeStamp = iTimeStamp;
  }

 protected:
  uint _timeStamp;

#ifdef WITH_CXX_GUARDEDALLOC
  MEM_CXX_CLASS_ALLOC_FUNCS("Freestyle:Interface1D")
#endif
};

} /* namespace Freestyle */