This introduces `MemoryCount` which can be used across multiple `MemoryCounter`. Generally, `MemoryCount` is expected to live longer (e.g. over the entire life-time of a cache), while `MemoryCounter` is expected to only exists when actually counting the memory.
73 lines
2.1 KiB
C++
73 lines
2.1 KiB
C++
/* SPDX-FileCopyrightText: 2024 Blender Authors
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bli
|
|
*/
|
|
|
|
#include "BLI_function_ref.hh"
|
|
#include "BLI_implicit_sharing_ptr.hh"
|
|
#include "BLI_map.hh"
|
|
#include "BLI_memory_counter_fwd.hh"
|
|
#include "BLI_set.hh"
|
|
#include "BLI_vector_set.hh"
|
|
|
|
namespace blender::memory_counter {
|
|
|
|
class MemoryCount {
|
|
public:
|
|
/**
|
|
* Get the total number of counted bytes.
|
|
*
|
|
* \note This is only a rough estimate of the actual used memory. Often, not every little bit of
|
|
* memory is counted, so this is generally a lower bound. The actual memory usage should not be
|
|
* significantly higher though.
|
|
*/
|
|
int64_t total_bytes = 0;
|
|
|
|
Set<WeakImplicitSharingPtr> handled_shared_data;
|
|
|
|
void reset();
|
|
};
|
|
|
|
/**
|
|
* #MemoryCounter helps counting the amount of memory used in cases where data is shared and should
|
|
* not be double-counted. To achieve that, it counts bytes that are uniquely owned separately from
|
|
* those that are shared.
|
|
*/
|
|
class MemoryCounter : NonCopyable, NonMovable {
|
|
private:
|
|
MemoryCount &count_;
|
|
|
|
public:
|
|
MemoryCounter(MemoryCount &count);
|
|
|
|
/**
|
|
* Add bytes that are uniquely owned, i.e. not shared.
|
|
*/
|
|
void add(const int64_t bytes);
|
|
|
|
/**
|
|
* Add (potentially) shared data which should not be counted twice.
|
|
*
|
|
* \param sharing_info: The sharing info that owns the data. If null, the data is assumed to be
|
|
* uniquely owned.
|
|
* \param count_fn: Function to count the amount of memory used by the shared data. This is only
|
|
* called if the shared memory was not counted before. It's a callback, because sometimes
|
|
* counting the amount of used memory can be a bit more involved.
|
|
*/
|
|
void add_shared(const ImplicitSharingInfo *sharing_info,
|
|
const FunctionRef<void(MemoryCounter &shared_memory)> count_fn);
|
|
|
|
/**
|
|
* Same as above, but takes in the number of bytes directly instead of callback. This is easier
|
|
* to use in cases where computing the number of bytes is very cheap.
|
|
*/
|
|
void add_shared(const ImplicitSharingInfo *sharing_info, const int64_t bytes);
|
|
};
|
|
|
|
} // namespace blender::memory_counter
|