IO_dupli_persistent_id.hh

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2020 Blender Authors
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */
#pragma once
 
#include "BKE_duplilist.hh"
 
#include "DNA_object_types.h" /* For MAX_DUPLI_RECUR */
 
#include <array>
#include <iosfwd>
#include <string>
 
namespace blender::io {
 
/* Wrapper for DupliObject::persistent_id that can act as a map key. */
class PersistentID {
 protected:
  constexpr static int array_length_ = MAX_DUPLI_RECUR;
  using PIDArray = std::array<int, array_length_>;
  PIDArray persistent_id_;
 
  explicit PersistentID(const PIDArray &persistent_id_values);
 
 public:
  PersistentID();
  explicit PersistentID(const DupliObject *dupli_ob);
 
  /* Return true if the persistent IDs are the same, ignoring the first digit. */
  bool is_from_same_instancer_as(const PersistentID &other) const;
 
  /* Construct the persistent ID of this instance's instancer. */
  PersistentID instancer_pid() const;
 
  /* Construct a string representation by reversing the persistent ID.
   * In case of a duplicator that is duplicated itself as well, this
   * results in strings like:
   * "3" for the duplicated duplicator, and
   * "3-0", "3-1", etc. for its duplis. */
  std::string as_object_name_suffix() const;
 
  friend bool operator==(const PersistentID &persistent_id_a, const PersistentID &persistent_id_b);
  friend bool operator<(const PersistentID &persistent_id_a, const PersistentID &persistent_id_b);
  friend std::ostream &operator<<(std::ostream &os, const PersistentID &persistent_id);
 
 private:
  void copy_values_from(const PIDArray &persistent_id_values);
};
 
}  // namespace blender::io