CreditSystem.h

#pragma once
 
#include <CesiumUtility/Library.h>
 
#include <cstdint>
#include <string>
#include <unordered_map>
#include <utility>
#include <vector>
 
namespace CesiumUtility {
 
struct CESIUMUTILITY_API Credit {
public:
  bool operator==(const Credit& rhs) const noexcept {
    return this->id == rhs.id;
  }
 
private:
  size_t id;
 
  Credit(size_t id_) noexcept : id(id_) {}
 
  friend class CreditSystem;
  friend class CreditReferencer;
};
 
struct CreditsSnapshot {
  std::vector<Credit> currentCredits;
 
  std::vector<Credit> removedCredits;
};
 
class CESIUMUTILITY_API CreditSystem final {
public:
  Credit createCredit(std::string&& html, bool showOnScreen = false);
 
  Credit createCredit(const std::string& html, bool showOnScreen = false);
 
  bool shouldBeShownOnScreen(Credit credit) const noexcept;
 
  void setShowOnScreen(Credit credit, bool showOnScreen) noexcept;
 
  const std::string& getHtml(Credit credit) const noexcept;
 
  void addCreditReference(Credit credit);
 
  void removeCreditReference(Credit credit);
 
  const CreditsSnapshot& getSnapshot() noexcept;
 
private:
  void addBulkReferences(const std::vector<int32_t>& references) noexcept;
  void releaseBulkReferences(const std::vector<int32_t>& references) noexcept;
 
  const std::string INVALID_CREDIT_MESSAGE =
      "Error: Invalid Credit, cannot get HTML string.";
 
  struct CreditRecord {
    std::string html;
    bool showOnScreen;
    int32_t referenceCount;
    bool shownLastSnapshot;
  };
 
  std::vector<CreditRecord> _credits;
  std::vector<Credit> _creditsToNoLongerShowThisSnapshot;
  CreditsSnapshot _snapshot;
 
  friend class CreditReferencer;
};
} // namespace CesiumUtility