as_normalised_float()

std::span< const float > MayaFlux::Kakshya::TextureContainer::as_normalised_float

(

uint32_t

layer = 0

)

const

Layer pixel data as a normalised float span.

uint8_t source is divided by 255.0f. uint16_t by 65535.0f. float source is zero-copy into the variant's own storage. Returns empty span if layer is out of range or the variant holds a non-pixel type.

Result is cached per layer and reused until set_pixels() or from_image() invalidates it for that layer.

Parameters

layer

Array layer index. Defaults to 0.

Returns

Normalised float span, w * h * channels elements.

Definition at line 635 of file TextureContainer.cpp.

{
    if (layer >= m_data.size())
        return {};
 
    ensure_cpu(layer);
 
    if (!m_normalised_dirty[layer].load(std::memory_order_acquire) && !m_normalised_cache[layer].empty())
        return { m_normalised_cache[layer] };
 
    std::span<const float> result;
    seqlock_read_void(m_slot_locks[layer], 8, [&] {
        result = Kakshya::as_normalised_float(m_data[layer], m_normalised_cache[layer]);
    });
 
    if (!result.empty())
        m_normalised_dirty[layer].store(false, std::memory_order_release);
 
    return result;
}

References MayaFlux::Kakshya::as_normalised_float(), ensure_cpu(), m_data, m_normalised_cache, m_normalised_dirty, m_slot_locks, and MayaFlux::store().

Here is the call graph for this function: