MayaFlux 0.2.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
SpatialRegionProcessor.cpp
Go to the documentation of this file.
2
6
7namespace MayaFlux::Kakshya {
8
9void SpatialRegionProcessor::on_attach(const std::shared_ptr<SignalSourceContainer>& container)
10{
11 if (!container) {
12 error<std::invalid_argument>(
15 std::source_location::current(),
16 "SpatialRegionProcessor: container must not be null");
17 }
18
19 const auto& dims = container->get_structure().dimensions;
20 const bool has_spatial = std::ranges::any_of(dims, [](const DataDimension& d) {
24 });
25
26 if (!has_spatial) {
27 error<std::invalid_argument>(
30 std::source_location::current(),
31 "SpatialRegionProcessor: container must have at least one spatial dimension");
32 }
33
34 m_auto_caching = false;
35
37
39 "SpatialRegionProcessor attached ({} region(s) across {} group(s))",
41 container->get_all_region_groups().size());
42}
43
44void SpatialRegionProcessor::on_detach(const std::shared_ptr<SignalSourceContainer>& container)
45{
47}
48
49// =========================================================================
50// organize_container_data
51// =========================================================================
52
54 const std::shared_ptr<SignalSourceContainer>& container)
55{
56 m_organized_regions.clear();
57
58 const auto groups = container->get_all_region_groups();
59
60 for (const auto& [group_name, group] : groups) {
61 for (size_t i = 0; i < group.regions.size(); ++i) {
62 OrganizedRegion org(group_name, static_cast<uint32_t>(i));
63
64 std::ranges::copy(group.attributes,
65 std::inserter(org.attributes, org.attributes.end()));
66 std::ranges::copy(group.regions[i].attributes,
67 std::inserter(org.attributes, org.attributes.end()));
68
69 org.attributes["group_name"] = group_name;
70 org.attributes["region_index"] = i;
71
72 org.segments.emplace_back(group.regions[i]);
74
75 m_organized_regions.push_back(std::move(org));
76 }
77 }
78}
79
80// =========================================================================
81// process
82// =========================================================================
83
84void SpatialRegionProcessor::process(const std::shared_ptr<SignalSourceContainer>& container)
85{
86 if (!container) {
88 "SpatialRegionProcessor::process — null container");
89 return;
90 }
91
92 auto& processed = container->get_processed_data();
93
94 if (processed.empty()) {
96 "SpatialRegionProcessor: processed_data empty, no readback available");
97 container->update_processing_state(ProcessingState::IDLE);
98 return;
99 }
100
101 const auto* full_surface = std::get_if<std::vector<uint8_t>>(&processed[0]);
102 if (!full_surface || full_surface->empty()) {
104 "SpatialRegionProcessor: processed_data[0] empty, skipping extraction");
105 container->update_processing_state(ProcessingState::IDLE);
106 return;
107 }
108
109 if (m_organized_regions.empty()) {
110 container->update_processing_state(ProcessingState::IDLE);
111 return;
112 }
113
114 m_is_processing.store(true, std::memory_order_release);
115 container->update_processing_state(ProcessingState::PROCESSING);
116
117 const auto& dims = container->get_structure().dimensions;
118 const std::span<const uint8_t> src { full_surface->data(), full_surface->size() };
119
120 std::vector<DataVariant> extracts;
121 extracts.reserve(m_organized_regions.size());
122
123 for (auto& org : m_organized_regions) {
124 if (org.segments.empty()) {
126 "SpatialRegionProcessor: OrganizedRegion '{}[{}]' has no segments, skipping",
127 org.group_name, org.region_index);
128 continue;
129 }
130
131 org.state = RegionState::ACTIVE;
132
133 try {
134 extracts.emplace_back(
135 extract_nd_region<uint8_t>(src, org.segments[0].source_region, dims));
136 org.state = RegionState::READY;
137 } catch (const std::exception& e) {
139 "SpatialRegionProcessor: extraction failed for '{}[{}]' — {}",
140 org.group_name, org.region_index, e.what());
141 org.state = RegionState::IDLE;
142 }
143 }
144
145 processed = std::move(extracts);
146
147 m_is_processing.store(false, std::memory_order_release);
148 container->update_processing_state(ProcessingState::PROCESSED);
149}
150
151// =========================================================================
152// refresh
153// =========================================================================
154
156{
157 if (auto container = m_container_weak.lock()) {
158 organize_container_data(container);
159
161 "SpatialRegionProcessor: refreshed ({} region(s))",
162 m_organized_regions.size());
163 }
164}
165
166} // namespace MayaFlux::Kakshya
#define MF_INFO(comp, ctx,...)
#define MF_RT_WARN(comp, ctx,...)
#define MF_RT_ERROR(comp, ctx,...)
#define MF_RT_TRACE(comp, ctx,...)
std::vector< OrganizedRegion > m_organized_regions
void on_detach(const std::shared_ptr< SignalSourceContainer > &container) override
Detach this processor from its container.
void on_attach(const std::shared_ptr< SignalSourceContainer > &container) override
Attach this processor to a signal source container.
std::weak_ptr< SignalSourceContainer > m_container_weak
void organize_container_data(const std::shared_ptr< SignalSourceContainer > &container) override
Build m_organized_regions from get_all_region_groups().
void process(const std::shared_ptr< SignalSourceContainer > &container) override
Extract all active regions from processed_data[0] in parallel.
void refresh()
Re-sync m_organized_regions from the container's current group map.
void on_attach(const std::shared_ptr< SignalSourceContainer > &container) override
Attach to a spatial container.
void on_detach(const std::shared_ptr< SignalSourceContainer > &container) override
Detach; delegates to RegionProcessorBase::on_detach.
@ ContainerProcessing
Container operations (Kakshya - file/stream/region processing)
@ Kakshya
Containers[Signalsource, Stream, File], Regions, DataProcessors.
@ IDLE
Container is inactive with no data or not ready for processing.
@ PROCESSING
Container is actively being processed.
@ PROCESSED
Container has completed processing and results are available.
@ ACTIVE
Currently being processed.
@ READY
Ready for processing.
@ IDLE
Not being processed.
@ SPATIAL_X
Spatial X axis (images, tensors)
Role role
Semantic hint for common operations.
Definition NDData.hpp:191
Minimal dimension descriptor focusing on structure only.
Definition NDData.hpp:139
std::unordered_map< std::string, std::any > attributes
Extensible metadata.
std::vector< RegionSegment > segments
Audio segments in this region.
A structured audio region with metadata and transition information.