Blender V5.3
gpu_texture_pool_private.hh
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2025 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
8
9#pragma once
10
11#include "GPU_texture_pool.hh"
13
14namespace blender::gpu {
15
21 protected:
23 int mip_len,
24 GPUTextureType type,
25 TextureFormat format,
27 const char *name = nullptr) = 0;
28
29 public:
31 int mip_len,
32 TextureFormat format,
33 eGPUTextureUsage usage,
34 const char *name = nullptr) override
35 {
36 return acquire_texture_impl({extent, 0, 0}, mip_len, GPU_TEXTURE_1D, format, usage, name);
37 }
39 int layer_len,
40 int mip_len,
41 TextureFormat format,
42 eGPUTextureUsage usage,
43 const char *name = nullptr) override
44 {
46 {extent, layer_len, 0}, mip_len, GPU_TEXTURE_1D_ARRAY, format, usage, name);
47 }
49 int mip_len,
50 TextureFormat format,
51 eGPUTextureUsage usage,
52 const char *name = nullptr) override
53 {
55 {extent.x, extent.y, 0}, mip_len, GPU_TEXTURE_2D, format, usage, name);
56 }
58 int layer_len,
59 int mip_len,
60 TextureFormat format,
61 eGPUTextureUsage usage,
62 const char *name = nullptr) override
63 {
65 {extent.x, extent.y, layer_len}, mip_len, GPU_TEXTURE_2D_ARRAY, format, usage, name);
66 }
68 int mip_len,
69 TextureFormat format,
70 eGPUTextureUsage usage,
71 const char *name = nullptr) override
72 {
73 return acquire_texture_impl(extent, mip_len, GPU_TEXTURE_3D, format, usage, name);
74 }
76 int mip_len,
77 TextureFormat format,
78 eGPUTextureUsage usage,
79 const char *name = nullptr) override
80 {
82 {extent, extent, 0}, mip_len, GPU_TEXTURE_CUBE, format, usage, name);
83 }
85 int layer_len,
86 int mip_len,
87 TextureFormat format,
88 eGPUTextureUsage usage,
89 const char *name = nullptr) override
90 {
92 {extent, extent, layer_len}, mip_len, GPU_TEXTURE_CUBE_ARRAY, format, usage, name);
93 }
94};
95
101 /* Defer deallocation enough cycles to avoid interleaved calls to different viewport render
102 * functions (selection / display) causing constant allocation / deallocation (See #113024). */
103 static constexpr int max_unused_cycles_ = 8;
104
105 /* Internal packet for texture, which supports set insertion. */
106 struct TextureHandle {
108 /* Counter to track texture acquire/retain mismatches in `acquire_`. */
109 int users_count = 1;
110 /* Counter to track the number of unused cycles before deallocation in `pool_`. */
111 int unused_cycles_count = 0;
112
113 /* We use the pointer as hash/comparator, as a texture cannot be acquired twice. */
114 uint64_t hash() const
115 {
117 }
118
119 bool operator==(const TextureHandle &o) const
120 {
121 return texture == o.texture;
122 }
123 };
124
125 /* Pool of textures ready to be reused. */
127 /* Set of textures currently in use. */
128 Set<TextureHandle> acquired_;
129
130 protected:
132 int mip_len,
133 GPUTextureType type,
134 TextureFormat format,
136 const char *name = nullptr) override;
137
138 public:
139 ~TexturePoolImpl() override;
140
141 void release_texture(Texture *tex) override;
142
143 void reset(bool force_free = false) override;
144
145 void offset_users_count(Texture *tex, int offset) override;
146};
147
148} // namespace blender::gpu
Texture * acquire_texture_cube(int extent, int mip_len, TextureFormat format, eGPUTextureUsage usage, const char *name=nullptr) override
Texture * acquire_texture_1d_array(int extent, int layer_len, int mip_len, TextureFormat format, eGPUTextureUsage usage, const char *name=nullptr) override
Texture * acquire_texture_1d(int extent, int mip_len, TextureFormat format, eGPUTextureUsage usage, const char *name=nullptr) override
Texture * acquire_texture_3d(int3 extent, int mip_len, TextureFormat format, eGPUTextureUsage usage, const char *name=nullptr) override
Texture * acquire_texture_cube_array(int extent, int layer_len, int mip_len, TextureFormat format, eGPUTextureUsage usage, const char *name=nullptr) override
virtual Texture * acquire_texture_impl(int3 extent, int mip_len, GPUTextureType type, TextureFormat format, eGPUTextureUsage usage=GPU_TEXTURE_USAGE_GENERAL, const char *name=nullptr)=0
Texture * acquire_texture_2d(int2 extent, int mip_len, TextureFormat format, eGPUTextureUsage usage, const char *name=nullptr) override
Texture * acquire_texture_2d_array(int2 extent, int layer_len, int mip_len, TextureFormat format, eGPUTextureUsage usage, const char *name=nullptr) override
void offset_users_count(Texture *tex, int offset) override
void release_texture(Texture *tex) override
Texture * acquire_texture_impl(int3 extent, int mip_len, GPUTextureType type, TextureFormat format, eGPUTextureUsage usage=GPU_TEXTURE_USAGE_GENERAL, const char *name=nullptr) override
void reset(bool force_free=false) override
TEX_TEMPLATE DataVec texture(T, FltCoord, float=0.0f) RET
bool operator==(const GPUState &a, const GPUState &b)
unsigned __int64 uint64_t
Definition BKE_text.h:91
VecBase< int32_t, 2 > int2
VecBase< int32_t, 3 > int3
@ GPU_TEXTURE_USAGE_GENERAL
constexpr uint64_t get_default_hash(const T &v, const Args &...args)
Definition BLI_hash.hh:252
#define hash
Definition noise_c.cc:156