MayaFlux 0.5.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
TextureLoom.cpp
Go to the documentation of this file.
1#include "TextureLoom.hpp"
2
6
8
12
14
16
18
19bool TextureLoom::initialize(const std::shared_ptr<Core::VulkanBackend>& backend)
20{
21 if (s_initialized) {
23 "TextureLoom already initialized (static flag)");
24 return true;
25 }
26
27 if (!backend) {
29 "Cannot initialize TextureLoom with null backend");
30 return false;
31 }
32
33 if (m_backend) {
35 "TextureLoom already initialized");
36 return true;
37 }
38
39 m_backend = backend;
40 m_resource_manager = &m_backend->get_resource_manager();
41 s_initialized = true;
42
44 "TextureLoom initialized");
45 return true;
46}
47
49{
50 if (!s_initialized) {
51 return;
52 }
53
54 if (!m_backend) {
55 return;
56 }
57
59 "Shutting down TextureLoom...");
60
61 for (auto& texture : m_textures) {
62 if (texture && texture->is_initialized()) {
64 }
65 }
66 m_textures.clear();
67 m_sampler_cache.clear();
68 m_resource_manager = nullptr;
69 m_backend = nullptr;
70
71 s_initialized = false;
72
74 "TextureLoom shutdown complete");
75}
76
77//==============================================================================
78// Texture Creation
79//==============================================================================
80
81std::shared_ptr<Core::VKImage> TextureLoom::create_2d(
82 uint32_t width, uint32_t height,
83 ImageFormat format, const void* data, uint32_t mip_levels)
84{
85 if (!is_initialized()) {
87 "TextureLoom not initialized");
88 return nullptr;
89 }
90
91 auto vk_format = to_vulkan_format(format);
92 auto image = std::make_shared<Core::VKImage>(
93 width, height, 1, vk_format,
96 mip_levels, 1,
98
100
101 if (!image->is_initialized()) {
103 "Failed to initialize VKImage");
104 return nullptr;
105 }
106
107 if (data) {
108 size_t data_size = calculate_image_size(width, height, 1, format);
109 upload_data(image, data, data_size);
110 } else {
112 image->get_image(),
113 vk::ImageLayout::eUndefined,
114 vk::ImageLayout::eShaderReadOnlyOptimal,
115 mip_levels, 1, vk::ImageAspectFlagBits::eColor);
116 image->set_current_layout(vk::ImageLayout::eShaderReadOnlyOptimal);
117 }
118
119 m_textures.push_back(image);
121 "Created 2D texture: {}x{}, format: {}, mips: {}",
122 width, height, vk::to_string(vk_format), mip_levels);
123 return image;
124}
125
126std::shared_ptr<Core::VKImage> TextureLoom::create_3d(
127 uint32_t width, uint32_t height, uint32_t depth,
128 ImageFormat format, const void* data)
129{
130 if (!is_initialized()) {
132 "TextureLoom not initialized");
133 return nullptr;
134 }
135
136 auto vk_format = to_vulkan_format(format);
137 auto image = std::make_shared<Core::VKImage>(
138 width, height, depth, vk_format,
142
144
145 if (!image->is_initialized()) {
147 "Failed to initialize 3D VKImage");
148 return nullptr;
149 }
150
151 if (data) {
152 size_t data_size = calculate_image_size(width, height, depth, format);
153 upload_data(image, data, data_size);
154 } else {
156 image->get_image(),
157 vk::ImageLayout::eUndefined,
158 vk::ImageLayout::eShaderReadOnlyOptimal,
159 1, 1, vk::ImageAspectFlagBits::eColor);
160 image->set_current_layout(vk::ImageLayout::eShaderReadOnlyOptimal);
161 }
162
163 m_textures.push_back(image);
165 "Created 3D texture: {}x{}x{}, format: {}",
166 width, height, depth, vk::to_string(vk_format));
167 return image;
168}
169
170std::shared_ptr<Core::VKImage> TextureLoom::create_cubemap(
171 uint32_t size, ImageFormat format, const void* data)
172{
173 if (!is_initialized()) {
175 "TextureLoom not initialized");
176 return nullptr;
177 }
178
179 auto vk_format = to_vulkan_format(format);
180 auto image = std::make_shared<Core::VKImage>(
181 size, size, 1, vk_format,
185
187
188 if (!image->is_initialized()) {
190 "Failed to initialize cubemap VKImage");
191 return nullptr;
192 }
193
194 if (data) {
195 size_t face_size = calculate_image_size(size, size, 1, format);
196 size_t total_size = face_size * 6;
197 upload_data(image, data, total_size);
198 } else {
200 image->get_image(),
201 vk::ImageLayout::eUndefined,
202 vk::ImageLayout::eShaderReadOnlyOptimal,
203 1, 6, vk::ImageAspectFlagBits::eColor);
204 image->set_current_layout(vk::ImageLayout::eShaderReadOnlyOptimal);
205 }
206
207 m_textures.push_back(image);
209 "Created cubemap: {}x{}, format: {}", size, size, vk::to_string(vk_format));
210 return image;
211}
212
213std::shared_ptr<Core::VKImage> TextureLoom::create_2d_array(
214 uint32_t width, uint32_t height, uint32_t layers,
215 ImageFormat format, const void* data)
216{
217 if (!is_initialized()) {
219 "TextureLoom not initialized");
220 return nullptr;
221 }
222
223 if (layers == 0) {
225 "create_2d_array: layers must be > 0");
226 return nullptr;
227 }
228
229 auto vk_format = to_vulkan_format(format);
230 auto image = std::make_shared<Core::VKImage>(
231 width, height, 1, vk_format,
234 1, layers,
236
238
239 if (!image->is_initialized()) {
241 "create_2d_array: failed to initialize VKImage ({}x{} layers={})",
242 width, height, layers);
243 return nullptr;
244 }
245
246 if (data) {
247 const size_t total = calculate_image_size(width, height, 1, format) * layers;
248 upload_data(image, data, total);
249 } else {
251 image->get_image(),
252 vk::ImageLayout::eUndefined,
253 vk::ImageLayout::eShaderReadOnlyOptimal,
254 1, layers, vk::ImageAspectFlagBits::eColor);
255 image->set_current_layout(vk::ImageLayout::eShaderReadOnlyOptimal);
256 }
257
258 m_textures.push_back(image);
260 "Created 2D array texture: {}x{} layers={} format={}",
261 width, height, layers, vk::to_string(vk_format));
262 return image;
263}
264
265std::shared_ptr<Core::VKImage> TextureLoom::create_render_target(
266 uint32_t width, uint32_t height, ImageFormat format)
267{
268 if (!is_initialized()) {
270 "TextureLoom not initialized");
271 return nullptr;
272 }
273
274 auto vk_format = to_vulkan_format(format);
275 auto image = std::make_shared<Core::VKImage>(
276 width, height, 1, vk_format,
280
282
283 if (!image->is_initialized()) {
285 "Failed to initialize render target VKImage");
286 return nullptr;
287 }
288
290 image->get_image(),
291 vk::ImageLayout::eUndefined,
292 vk::ImageLayout::eColorAttachmentOptimal,
293 1, 1, vk::ImageAspectFlagBits::eColor);
294 image->set_current_layout(vk::ImageLayout::eColorAttachmentOptimal);
295
296 m_textures.push_back(image);
298 "Created render target: {}x{}, format: {}",
299 width, height, vk::to_string(vk_format));
300 return image;
301}
302
303std::shared_ptr<Core::VKImage> TextureLoom::create_depth_buffer(
304 uint32_t width, uint32_t height, bool with_stencil)
305{
306 if (!is_initialized()) {
308 "TextureLoom not initialized");
309 return nullptr;
310 }
311
312 vk::Format vk_format = with_stencil
313 ? vk::Format::eD24UnormS8Uint
314 : vk::Format::eD32Sfloat;
315
316 auto image = std::make_shared<Core::VKImage>(
317 width, height, 1, vk_format,
321
323
324 if (!image->is_initialized()) {
326 "Failed to initialize depth buffer VKImage");
327 return nullptr;
328 }
329
330 vk::ImageAspectFlags aspect = with_stencil
331 ? (vk::ImageAspectFlagBits::eDepth | vk::ImageAspectFlagBits::eStencil)
332 : vk::ImageAspectFlagBits::eDepth;
333
335 image->get_image(),
336 vk::ImageLayout::eUndefined,
337 vk::ImageLayout::eDepthStencilAttachmentOptimal,
338 1, 1, aspect);
339 image->set_current_layout(vk::ImageLayout::eDepthStencilAttachmentOptimal);
340
341 m_textures.push_back(image);
343 "Created depth buffer: {}x{}, format: {}, stencil: {}",
344 width, height, vk::to_string(vk_format), with_stencil);
345 return image;
346}
347
348std::shared_ptr<Core::VKImage> TextureLoom::create_storage_image(
349 uint32_t width, uint32_t height, ImageFormat format)
350{
351 if (!is_initialized()) {
353 "TextureLoom not initialized");
354 return nullptr;
355 }
356
357 auto vk_format = to_vulkan_format(format);
358 auto image = std::make_shared<Core::VKImage>(
359 width, height, 1, vk_format,
363
365
366 if (!image->is_initialized()) {
368 "Failed to initialize storage image VKImage");
369 return nullptr;
370 }
371
373 image->get_image(),
374 vk::ImageLayout::eUndefined,
375 vk::ImageLayout::eGeneral,
376 1, 1, vk::ImageAspectFlagBits::eColor);
377 image->set_current_layout(vk::ImageLayout::eGeneral);
378
379 m_textures.push_back(image);
381 "Created storage image: {}x{}, format: {}",
382 width, height, vk::to_string(vk_format));
383 return image;
384}
385
386std::shared_ptr<Core::VKImage> TextureLoom::create_2d(
387 const Kakshya::DataVariant& variant,
388 uint32_t width,
389 uint32_t height,
390 ImageFormat format)
391{
392 if (!is_initialized()) {
394 "TextureLoom not initialized");
395 return nullptr;
396 }
397
398 const auto access = Kakshya::as_texture_access(variant);
399 if (!access) {
400 return nullptr;
401 }
402
403 const size_t expected = calculate_image_size(width, height, 1, format);
404 if (access->byte_count != expected) {
405 error<std::invalid_argument>(
408 std::source_location::current(),
409 "create_2d: byte count mismatch — {} bytes supplied, "
410 "{}x{} format {} requires {}",
411 access->byte_count, width, height, static_cast<int>(format), expected);
412 }
413
414 return create_2d(width, height, format, access->data_ptr, 1);
415}
416
417//==============================================================================
418// Data Upload/Download
419//==============================================================================
420
422 const std::shared_ptr<Core::VKImage>& image, const void* data, size_t size)
423{
424 if (!is_initialized() || !image || !data) {
426 "Invalid parameters for upload_data");
427 return;
428 }
429
431}
432
434 const std::shared_ptr<Core::VKImage>& image,
435 const void* data,
436 size_t size,
437 const std::shared_ptr<Buffers::VKBuffer>& staging,
438 bool deferred)
439{
440 if (!is_initialized() || !image || !data || !staging) {
442 "Invalid parameters for upload_data_streaming");
443 return;
444 }
445
446 m_resource_manager->upload_image_data(image, data, size, staging, deferred);
447}
448
450 const std::shared_ptr<Core::VKImage>& image,
451 void* data,
452 size_t size,
453 const std::shared_ptr<Buffers::VKBuffer>& staging,
454 bool deferred)
455{
456 if (!is_initialized() || !image || !data) {
458 "download_data(staging): invalid parameters");
459 return;
460 }
461
462 m_resource_manager->download_image_data(image, data, size, staging, deferred);
463}
464
466 const std::shared_ptr<Core::VKImage>& image,
467 vk::ImageLayout old_layout,
468 vk::ImageLayout new_layout,
469 uint32_t mip_levels,
470 uint32_t array_layers,
471 vk::ImageAspectFlags aspect_mask)
472{
473 if (!is_initialized() || !image) {
475 "Invalid parameters for transition_vk_image_layout");
476 return;
477 }
478
480 image->get_image(),
481 old_layout,
482 new_layout,
483 mip_levels, array_layers, aspect_mask);
484
485 image->set_current_layout(new_layout);
486}
487
488//==============================================================================
489// Sampler Management
490//==============================================================================
491
493{
494 if (!is_initialized()) {
496 "TextureLoom not initialized");
497 return nullptr;
498 }
499
500 size_t hash = hash_sampler_config(config);
501 auto it = m_sampler_cache.find(hash);
502 if (it != m_sampler_cache.end()) {
503 return it->second;
504 }
505
506 vk::Sampler sampler = create_sampler(config);
507 m_sampler_cache[hash] = sampler;
508 return sampler;
509}
510
512{
513 SamplerConfig config;
514 return get_or_create_sampler(config);
515}
516
526
528{
530 static_cast<vk::Filter>(config.mag_filter),
531 static_cast<vk::SamplerAddressMode>(config.address_mode_u),
532 config.max_anisotropy);
533}
534
536{
537 size_t hash = 0;
538 hash ^= std::hash<int> {}(static_cast<int>(config.mag_filter)) << 0;
539 hash ^= std::hash<int> {}(static_cast<int>(config.min_filter)) << 4;
540 hash ^= std::hash<int> {}(static_cast<int>(config.address_mode_u)) << 8;
541 hash ^= std::hash<int> {}(static_cast<int>(config.address_mode_v)) << 12;
542 hash ^= std::hash<int> {}(static_cast<int>(config.address_mode_w)) << 16;
543 hash ^= std::hash<float> {}(config.max_anisotropy) << 20;
544 hash ^= std::hash<bool> {}(config.enable_mipmaps) << 24;
545 return hash;
546}
547
548//==============================================================================
549// Utilities
550//==============================================================================
551
553{
554 switch (format) {
555 case ImageFormat::R8:
556 return vk::Format::eR8Unorm;
557 case ImageFormat::RG8:
558 return vk::Format::eR8G8Unorm;
560 return vk::Format::eR8G8B8Unorm;
562 return vk::Format::eR8G8B8A8Unorm;
565 return vk::Format::eB8G8R8A8Unorm;
567 return vk::Format::eB8G8R8A8Srgb;
568 return vk::Format::eR8G8B8A8Srgb;
569 case ImageFormat::R16:
570 return vk::Format::eR16Unorm;
572 return vk::Format::eR16G16Unorm;
574 return vk::Format::eR16G16B16A16Unorm;
576 return vk::Format::eR16Sfloat;
578 return vk::Format::eR16G16Sfloat;
580 return vk::Format::eR16G16B16A16Sfloat;
582 return vk::Format::eR32Sfloat;
584 return vk::Format::eR32G32Sfloat;
586 return vk::Format::eR32G32B32A32Sfloat;
588 return vk::Format::eD16Unorm;
590 return vk::Format::eX8D24UnormPack32;
592 return vk::Format::eD32Sfloat;
594 return vk::Format::eD24UnormS8Uint;
595 default:
596 return vk::Format::eR8G8B8A8Unorm;
597 }
598}
599
601{
602 switch (format) {
603 case ImageFormat::R8:
604 return 1;
605 case ImageFormat::RG8:
606 return 2;
608 return 3;
613 return 4;
614 case ImageFormat::R16:
615 return 2;
617 return 4;
619 return 8;
621 return 2;
623 return 4;
625 return 8;
627 return 4;
629 return 8;
631 return 16;
633 return 2;
637 default:
638 return 4;
639 }
640}
641
642std::optional<ImageFormat> TextureLoom::from_vulkan_format(vk::Format vk_format)
643{
644 switch (vk_format) {
645 case vk::Format::eR8Unorm:
646 return ImageFormat::R8;
647 case vk::Format::eR8G8Unorm:
648 return ImageFormat::RG8;
649 case vk::Format::eR8G8B8Unorm:
650 return ImageFormat::RGB8;
651 case vk::Format::eR8G8B8A8Unorm:
652 return ImageFormat::RGBA8;
653 case vk::Format::eR8G8B8A8Srgb:
655 case vk::Format::eB8G8R8A8Unorm:
656 return ImageFormat::BGRA8;
657
658 case vk::Format::eR16Unorm:
659 return ImageFormat::R16;
660 case vk::Format::eR16G16Unorm:
661 return ImageFormat::RG16;
662 case vk::Format::eR16G16B16A16Unorm:
663 return ImageFormat::RGBA16;
664
665 case vk::Format::eR16Sfloat:
666 return ImageFormat::R16F;
667 case vk::Format::eR16G16Sfloat:
668 return ImageFormat::RG16F;
669 case vk::Format::eR16G16B16A16Sfloat:
671
672 case vk::Format::eR32Sfloat:
673 return ImageFormat::R32F;
674 case vk::Format::eR32G32Sfloat:
675 return ImageFormat::RG32F;
676 case vk::Format::eR32G32B32A32Sfloat:
678
679 case vk::Format::eD16Unorm:
681 case vk::Format::eX8D24UnormPack32:
683 case vk::Format::eD32Sfloat:
685 case vk::Format::eD24UnormS8Uint:
687
688 default:
689 return std::nullopt;
690 }
691}
692
694 uint32_t width, uint32_t height, uint32_t depth, ImageFormat format)
695{
696 return static_cast<size_t>(width) * height * depth * get_bytes_per_pixel(format);
697}
698
700{
701 switch (format) {
702 case ImageFormat::R8:
703 case ImageFormat::R16:
706 return 1;
707
708 case ImageFormat::RG8:
712 return 2;
713
715 return 3;
716
723 return 4;
724
728 return 1;
729
731 return 2;
732
733 default:
734 return 0;
735 }
736}
737
738} // namespace MayaFlux::Portal::Graphics
#define MF_INFO(comp, ctx,...)
#define MF_ERROR(comp, ctx,...)
#define MF_WARN(comp, ctx,...)
IO::ImageData image
Definition Decoder.cpp:64
uint32_t width
Definition Decoder.cpp:66
uint32_t height
void cleanup_image(const std::shared_ptr< VKImage > &image)
Cleanup a VKImage (destroy view, image, and free memory)
void download_image_data(std::shared_ptr< VKImage > image, void *data, size_t size, const std::shared_ptr< Buffers::VKBuffer > &staging=nullptr, bool deferred=false, vk::ImageLayout restore_layout=vk::ImageLayout::eShaderReadOnlyOptimal, vk::PipelineStageFlags restore_stage=vk::PipelineStageFlagBits::eFragmentShader)
Download image data to a host pointer.
void initialize_image(const std::shared_ptr< VKImage > &image)
Initialize a VKImage (allocate VkImage, memory, and create image view)
vk::Sampler create_sampler(vk::Filter filter=vk::Filter::eLinear, vk::SamplerAddressMode address_mode=vk::SamplerAddressMode::eRepeat, float max_anisotropy=0.0F)
Create sampler.
void transition_image_layout(vk::Image image, vk::ImageLayout old_layout, vk::ImageLayout new_layout, uint32_t mip_levels=1, uint32_t array_layers=1, vk::ImageAspectFlags aspect_flags=vk::ImageAspectFlagBits::eColor)
Transition image layout using a pipeline barrier.
void upload_image_data(std::shared_ptr< VKImage > image, const void *data, size_t size)
Upload data to an image (creates staging buffer internally)
@ RENDER_TARGET
Color attachment for rendering.
@ STORAGE
Storage image (compute shader read/write)
@ TEXTURE_2D
Sampled texture (shader read)
@ DEPTH_STENCIL
Depth/stencil attachment.
std::shared_ptr< Core::VKImage > create_render_target(uint32_t width, uint32_t height, ImageFormat format=ImageFormat::RGBA8)
Create a render target (color attachment)
std::shared_ptr< Core::VKImage > create_depth_buffer(uint32_t width, uint32_t height, bool with_stencil=false)
Create a depth buffer.
static size_t get_bytes_per_pixel(ImageFormat format)
Get bytes per pixel for a format.
static uint32_t get_channel_count(ImageFormat format)
Get the number of color channels for a given format.
vk::Sampler get_nearest_sampler()
Get a default nearest sampler (for pixel-perfect sampling)
static size_t calculate_image_size(uint32_t width, uint32_t height, uint32_t depth, ImageFormat format)
Calculate image data size.
static vk::Format to_vulkan_format(ImageFormat format)
Convert Portal ImageFormat to Vulkan format.
std::shared_ptr< Core::VKImage > create_storage_image(uint32_t width, uint32_t height, ImageFormat format=ImageFormat::RGBA8)
Create a storage image (compute shader read/write)
void upload_data(const std::shared_ptr< Core::VKImage > &image, const void *data, size_t size)
Upload pixel data to an existing texture.
void download_data(const std::shared_ptr< Core::VKImage > &image, void *data, size_t size, const std::shared_ptr< Buffers::VKBuffer > &staging, bool deferred=false)
Download pixel data from a VKImage, reusing a caller-supplied persistent staging buffer.
bool initialize(const std::shared_ptr< Core::VulkanBackend > &backend)
Initialize texture manager.
vk::Sampler get_or_create_sampler(const SamplerConfig &config)
Get or create a sampler with the given configuration.
void transition_layout(const std::shared_ptr< Core::VKImage > &image, vk::ImageLayout old_layout, vk::ImageLayout new_layout, uint32_t mip_levels=1, uint32_t array_layers=1, vk::ImageAspectFlags aspect_mask=vk::ImageAspectFlagBits::eColor)
Transition a VKImage to a new Vulkan layout via an immediate submission.
std::shared_ptr< Core::VKImage > create_2d_array(uint32_t width, uint32_t height, uint32_t layers, ImageFormat format=ImageFormat::RGBA8, const void *data=nullptr)
Create a 2D texture array.
std::shared_ptr< Core::VulkanBackend > m_backend
std::shared_ptr< Core::VKImage > create_3d(uint32_t width, uint32_t height, uint32_t depth, ImageFormat format=ImageFormat::RGBA8, const void *data=nullptr)
Create a 3D texture (volumetric)
vk::Sampler create_sampler(const SamplerConfig &config)
void shutdown()
Shutdown and cleanup all textures.
static std::optional< ImageFormat > from_vulkan_format(vk::Format vk_format)
Convert Vulkan format to Portal ImageFormat.
Core::BackendResourceManager * m_resource_manager
std::shared_ptr< Core::VKImage > create_2d(uint32_t width, uint32_t height, ImageFormat format=ImageFormat::RGBA8, const void *data=nullptr, uint32_t mip_levels=1)
Create a 2D texture.
static size_t hash_sampler_config(const SamplerConfig &config)
std::vector< std::shared_ptr< Core::VKImage > > m_textures
std::shared_ptr< Core::VKImage > create_cubemap(uint32_t size, ImageFormat format=ImageFormat::RGBA8, const void *data=nullptr)
Create a cubemap texture.
vk::Sampler get_default_sampler()
Get a default linear sampler (for convenience)
std::unordered_map< size_t, vk::Sampler > m_sampler_cache
bool is_initialized() const
Check if manager is initialized.
@ ImageProcessing
Image processing tasks (filters, transformations)
@ Portal
High-level user-facing API layer.
std::variant< std::vector< double >, std::vector< float >, std::vector< uint8_t >, std::vector< uint16_t >, std::vector< uint32_t >, std::vector< std::complex< float > >, std::vector< std::complex< double > >, std::vector< glm::vec2 >, std::vector< glm::vec3 >, std::vector< glm::vec4 >, std::vector< glm::mat4 > > DataVariant
Multi-type data storage for different precision needs.
Definition NDData.hpp:102
@ VOLUMETRIC_3D
3D volumetric data
@ IMAGE_COLOR
2D RGB/RGBA image
@ IMAGE_2D
2D image (grayscale or single channel)
std::optional< TextureAccess > as_texture_access(const DataVariant &variant)
Extract a TextureAccess from a DataVariant.
@ NEAREST
Nearest neighbor (pixelated)
ImageFormat
User-friendly image format enum.
@ DEPTH24_STENCIL8
24-bit depth + 8-bit stencil
@ RG16
Two channel 16-bit unsigned integer.
@ BGRA8
8-bit BGRA unsigned normalized
@ RGBA16
Four channel 16-bit unsigned integer.
@ RGBA32F
Four channel 32-bit float.
@ R16F
Single channel 16-bit float.
@ R16
Single channel 16-bit unsigned integer.
@ RGBA16F
Four channel 16-bit float.
@ RG32F
Two channel 32-bit float.
@ R32F
Single channel 32-bit float.
@ RG16F
Two channel 16-bit float.
@ RGBA8_SRGB
Four channel 8-bit sRGB.