peak_buffer.hpp

Go to the documentation of this file.

 
#pragma once
 
#include <peak_common/types/peak_common_iimageview.hpp>
#include <peak_common_c/detail/peak_common_defines.h>
 
#include <peak/backend/peak_backend.h>
#include <peak/buffer/peak_buffer_chunk.hpp>
#include <peak/buffer/peak_buffer_part.hpp>
#include <peak/common/peak_common_structs.hpp>
#include <peak/common/peak_event_supporting_module.hpp>
#include <peak/dll_interface/peak_dll_interface_util.hpp>
#include <peak/image_view/peak_image_view.hpp>
 
#include <cstddef>
#include <cstdint>
#include <memory>
#include <string>
#include <vector>
 
 
namespace peak
{
 
namespace core
{

enum class BufferPayloadType
{
    Unknown,
    Image,
    RawData,
    File,
    Chunk,
    JPEG,
    JPEG2000,
    H264,
    ChunkOnly,
    DeviceSpecific,
    MultiPart,
 
    Custom = 1000
};

enum class PixelFormatNamespace
{
    GEV = 1,
    IIDC,
    PFNC16Bit,
    PFNC32Bit,
 
    Custom = 1000
};
 
class DataStream;
class NodeMap;

class Buffer
    : public EventSupportingModule
    , public std::enable_shared_from_this<Buffer>
{
public:
    Buffer() = delete;
    ~Buffer() override = default;
    Buffer(const Buffer& other) = delete;
    Buffer& operator=(const Buffer& other) = delete;
    Buffer(Buffer&& other) = delete;
    Buffer& operator=(Buffer&& other) = delete;

    PEAK_COMMON_NO_DISCARD ImageView ToImageView();
 

    PEAK_COMMON_NO_DISCARD ImageView ToImageView(MetadataExtractionMode mode);


    PEAK_COMMON_NO_DISCARD RawInformation Info(int32_t infoCommand) const;

    PEAK_COMMON_NO_DISCARD std::string TLType() const;

    PEAK_COMMON_NO_DISCARD void* BasePtr() const;

    PEAK_COMMON_NO_DISCARD size_t Size() const;

    PEAK_COMMON_NO_DISCARD void* UserPtr() const;

    PEAK_COMMON_NO_DISCARD BufferPayloadType PayloadType() const;

    PEAK_COMMON_NO_DISCARD uint64_t PixelFormat() const;

    PEAK_COMMON_NO_DISCARD peak::common::PixelFormatInfo PixelFormatInfo() const;

    PEAK_COMMON_NO_DISCARD peak::core::PixelFormatNamespace PixelFormatNamespace() const;

    PEAK_COMMON_NO_DISCARD Endianness PixelEndianness() const;

    PEAK_COMMON_NO_DISCARD size_t ExpectedDataSize() const;

    PEAK_COMMON_NO_DISCARD size_t DeliveredDataSize() const;

    PEAK_COMMON_NO_DISCARD uint64_t FrameID() const;

    PEAK_COMMON_NO_DISCARD size_t ImageOffset() const;

    PEAK_COMMON_NO_DISCARD size_t DeliveredImageHeight() const;

    PEAK_COMMON_NO_DISCARD size_t DeliveredChunkPayloadSize() const;

    PEAK_COMMON_NO_DISCARD uint64_t ChunkLayoutID() const;

    PEAK_COMMON_NO_DISCARD std::string FileName() const;

    PEAK_COMMON_NO_DISCARD size_t Width() const;

    PEAK_COMMON_NO_DISCARD size_t Height() const;

    PEAK_COMMON_NO_DISCARD peak::common::Size ImageSize() const;

    PEAK_COMMON_NO_DISCARD size_t XOffset() const;

    PEAK_COMMON_NO_DISCARD size_t YOffset() const;

    PEAK_COMMON_NO_DISCARD size_t XPadding() const;

    PEAK_COMMON_NO_DISCARD size_t YPadding() const;

    PEAK_COMMON_NO_DISCARD uint64_t Timestamp_ticks() const;

    PEAK_COMMON_NO_DISCARD uint64_t Timestamp_ns() const;

    PEAK_COMMON_NO_DISCARD bool IsQueued() const;

    PEAK_COMMON_NO_DISCARD bool IsAcquiring() const;

    PEAK_COMMON_NO_DISCARD bool IsIncomplete() const;

    PEAK_COMMON_NO_DISCARD bool HasNewData() const;

    PEAK_COMMON_NO_DISCARD bool HasImage() const;

    PEAK_COMMON_NO_DISCARD bool HasChunks() const;

    PEAK_COMMON_NO_DISCARD bool HasParts() const;
 

    PEAK_COMMON_NO_DISCARD uint64_t SystemTimestamp_ns() const;


    PEAK_COMMON_NO_DISCARD std::vector<std::shared_ptr<BufferChunk>> Chunks();

    PEAK_COMMON_NO_DISCARD std::vector<std::shared_ptr<BufferPart>> Parts();

    PEAK_COMMON_NO_DISCARD std::shared_ptr<DataStream> ParentDataStream() const;
 
private:
    PEAK_COMMON_NO_DISCARD PEAK_MODULE_HANDLE ModuleHandle() const override;
    PEAK_COMMON_NO_DISCARD PEAK_EVENT_SUPPORTING_MODULE_HANDLE EventSupportingModuleHandle() const override;
 
    void Revoke();
 
    friend NodeMap;
    friend ClassCreator<Buffer>;
    Buffer(PEAK_BUFFER_HANDLE bufferHandle, const std::weak_ptr<DataStream>& parentDataStream);
    PEAK_BUFFER_HANDLE m_backendHandle;
 
    std::weak_ptr<DataStream> m_parentDataStream;
 
    friend class DataStream;
};
 
} /* namespace core */
} /* namespace peak */
 
/* Implementation */
namespace peak
{
namespace core
{
 
inline std::string ToString(BufferPayloadType entry)
{
    std::string entryString;
 
    if (entry == BufferPayloadType::Unknown)
    {
        entryString = "Unknown";
    }
    else if (entry == BufferPayloadType::Image)
    {
        entryString = "Image";
    }
    else if (entry == BufferPayloadType::RawData)
    {
        entryString = "RawData";
    }
    else if (entry == BufferPayloadType::File)
    {
        entryString = "File";
    }
    else if (entry == BufferPayloadType::Chunk)
    {
        entryString = "Chunk";
    }
    else if (entry == BufferPayloadType::JPEG)
    {
        entryString = "JPEG";
    }
    else if (entry == BufferPayloadType::JPEG2000)
    {
        entryString = "JPEG2000";
    }
    else if (entry == BufferPayloadType::H264)
    {
        entryString = "H264";
    }
    else if (entry == BufferPayloadType::ChunkOnly)
    {
        entryString = "ChunkOnly";
    }
    else if (entry == BufferPayloadType::DeviceSpecific)
    {
        entryString = "DeviceSpecific";
    }
    else if (entry == BufferPayloadType::MultiPart)
    {
        entryString = "MultiPart";
    }
    else if (entry >= BufferPayloadType::Custom)
    {
        entryString = "Custom";
    }
 
    return entryString;
}
 
inline std::string ToString(PixelFormatNamespace entry)
{
    std::string entryString;
 
    if (entry == PixelFormatNamespace::GEV)
    {
        entryString = "GEV";
    }
    else if (entry == PixelFormatNamespace::IIDC)
    {
        entryString = "IIDC";
    }
    else if (entry == PixelFormatNamespace::PFNC16Bit)
    {
        entryString = "PFNC16Bit";
    }
    else if (entry == PixelFormatNamespace::PFNC32Bit)
    {
        entryString = "PFNC32Bit";
    }
    else if (entry >= PixelFormatNamespace::Custom)
    {
        entryString = "Custom";
    }
 
    return entryString;
}
 
inline Buffer::Buffer(PEAK_BUFFER_HANDLE bufferHandle, const std::weak_ptr<DataStream>& parentDataStream)
    : m_backendHandle(bufferHandle)
    , m_parentDataStream(parentDataStream)
{}
 
inline ImageView Buffer::ToImageView()
{
    return ImageView(shared_from_this());
}
 
inline ImageView Buffer::ToImageView(MetadataExtractionMode mode)
{
    return ImageView(shared_from_this(), mode);
}
 
 
inline RawInformation Buffer::Info(int32_t infoCommand) const
{
    return QueryRawInformationFromCInterfaceFunction([&](int32_t* dataType, uint8_t* buffer, size_t* bufferSize) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetInfo(m_backendHandle, infoCommand, dataType, buffer, bufferSize);
    });
}
 
inline std::string Buffer::TLType() const
{
    return QueryStringFromCInterfaceFunction([&](char* tlType, size_t* tlTypeSize) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetTLType(m_backendHandle, tlType, tlTypeSize);
    });
}
 
inline void* Buffer::BasePtr() const
{
    return QueryNumericFromCInterfaceFunction<void*>(
        [&](void** basePtr) { return PEAK_C_ABI_PREFIX PEAK_Buffer_GetBasePtr(m_backendHandle, basePtr); });
}
 
inline size_t Buffer::Size() const
{
    return QueryNumericFromCInterfaceFunction<size_t>(
        [&](size_t* size) { return PEAK_C_ABI_PREFIX PEAK_Buffer_GetSize(m_backendHandle, size); });
}
 
inline void* Buffer::UserPtr() const
{
    return QueryNumericFromCInterfaceFunction<void*>(
        [&](void** userPtr) { return PEAK_C_ABI_PREFIX PEAK_Buffer_GetUserPtr(m_backendHandle, userPtr); });
}
 
inline BufferPayloadType Buffer::PayloadType() const
{
    return static_cast<BufferPayloadType>(
        QueryNumericFromCInterfaceFunction<PEAK_BUFFER_PAYLOAD_TYPE>([&](PEAK_BUFFER_PAYLOAD_TYPE* payloadType) {
            return PEAK_C_ABI_PREFIX PEAK_Buffer_GetPayloadType(m_backendHandle, payloadType);
        }));
}
 
inline uint64_t Buffer::PixelFormat() const
{
    return QueryNumericFromCInterfaceFunction<uint64_t>([&](uint64_t* pixelFormat) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetPixelFormat(m_backendHandle, pixelFormat);
    });
}
 
inline peak::common::PixelFormatInfo Buffer::PixelFormatInfo() const
{
    return peak::common::PixelFormatInfo(static_cast<peak::common::PixelFormat>(PixelFormat()));
}
 
inline peak::core::PixelFormatNamespace Buffer::PixelFormatNamespace() const
{
    return static_cast<peak::core::PixelFormatNamespace>(
        QueryNumericFromCInterfaceFunction<PEAK_PIXEL_FORMAT_NAMESPACE>(
            [&](PEAK_PIXEL_FORMAT_NAMESPACE* pixelFormatNamespace) {
                return PEAK_C_ABI_PREFIX PEAK_Buffer_GetPixelFormatNamespace(
                    m_backendHandle, pixelFormatNamespace);
            }));
}
 
inline Endianness Buffer::PixelEndianness() const
{
    return static_cast<Endianness>(
        QueryNumericFromCInterfaceFunction<PEAK_ENDIANNESS>([&](PEAK_ENDIANNESS* pixelEndianness) {
            return PEAK_C_ABI_PREFIX PEAK_Buffer_GetPixelEndianness(m_backendHandle, pixelEndianness);
        }));
}
 
inline size_t Buffer::ExpectedDataSize() const
{
    return QueryNumericFromCInterfaceFunction<size_t>([&](size_t* expectedDataSize) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetExpectedDataSize(m_backendHandle, expectedDataSize);
    });
}
 
inline size_t Buffer::DeliveredDataSize() const
{
    return QueryNumericFromCInterfaceFunction<size_t>([&](size_t* deliveredDataSize) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetDeliveredDataSize(m_backendHandle, deliveredDataSize);
    });
}
 
inline uint64_t Buffer::FrameID() const
{
    return QueryNumericFromCInterfaceFunction<uint64_t>(
        [&](uint64_t* frameId) { return PEAK_C_ABI_PREFIX PEAK_Buffer_GetFrameID(m_backendHandle, frameId); });
}
 
inline size_t Buffer::ImageOffset() const
{
    return QueryNumericFromCInterfaceFunction<size_t>([&](size_t* imageOffset) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetImageOffset(m_backendHandle, imageOffset);
    });
}
 
inline size_t Buffer::DeliveredImageHeight() const
{
    return QueryNumericFromCInterfaceFunction<size_t>([&](size_t* deliveredImageHeight) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetDeliveredImageHeight(m_backendHandle, deliveredImageHeight);
    });
}
 
inline size_t Buffer::DeliveredChunkPayloadSize() const
{
    return QueryNumericFromCInterfaceFunction<size_t>([&](size_t* deliveredChunkPayloadSize) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetDeliveredChunkPayloadSize(
            m_backendHandle, deliveredChunkPayloadSize);
    });
}
 
inline uint64_t Buffer::ChunkLayoutID() const
{
    return QueryNumericFromCInterfaceFunction<uint64_t>([&](uint64_t* chunkLayoutId) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetChunkLayoutID(m_backendHandle, chunkLayoutId);
    });
}
 
inline std::string Buffer::FileName() const
{
    return QueryStringFromCInterfaceFunction([&](char* fileName, size_t* fileNameSize) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetFileName(m_backendHandle, fileName, fileNameSize);
    });
}
 
inline size_t Buffer::Width() const
{
    return QueryNumericFromCInterfaceFunction<size_t>(
        [&](size_t* width) { return PEAK_C_ABI_PREFIX PEAK_Buffer_GetWidth(m_backendHandle, width); });
}
 
inline size_t Buffer::Height() const
{
    return QueryNumericFromCInterfaceFunction<size_t>(
        [&](size_t* height) { return PEAK_C_ABI_PREFIX PEAK_Buffer_GetHeight(m_backendHandle, height); });
}
 
inline peak::common::Size Buffer::ImageSize() const
{
    return { static_cast<uint32_t>(Width()), static_cast<uint32_t>(Height()) };
}
 
inline size_t Buffer::XOffset() const
{
    return QueryNumericFromCInterfaceFunction<size_t>(
        [&](size_t* xOffset) { return PEAK_C_ABI_PREFIX PEAK_Buffer_GetXOffset(m_backendHandle, xOffset); });
}
 
inline size_t Buffer::YOffset() const
{
    return QueryNumericFromCInterfaceFunction<size_t>(
        [&](size_t* yOffset) { return PEAK_C_ABI_PREFIX PEAK_Buffer_GetYOffset(m_backendHandle, yOffset); });
}
 
inline size_t Buffer::XPadding() const
{
    return QueryNumericFromCInterfaceFunction<size_t>(
        [&](size_t* xPadding) { return PEAK_C_ABI_PREFIX PEAK_Buffer_GetXPadding(m_backendHandle, xPadding); });
}
 
inline size_t Buffer::YPadding() const
{
    return QueryNumericFromCInterfaceFunction<size_t>(
        [&](size_t* yPadding) { return PEAK_C_ABI_PREFIX PEAK_Buffer_GetYPadding(m_backendHandle, yPadding); });
}
 
inline uint64_t Buffer::Timestamp_ticks() const
{
    return QueryNumericFromCInterfaceFunction<uint64_t>([&](uint64_t* timestamp_ticks) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetTimestamp_ticks(m_backendHandle, timestamp_ticks);
    });
}
 
inline uint64_t Buffer::Timestamp_ns() const
{
    return QueryNumericFromCInterfaceFunction<uint64_t>([&](uint64_t* timestamp_ns) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetTimestamp_ns(m_backendHandle, timestamp_ns);
    });
}
 
inline bool Buffer::IsQueued() const
{
    return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* isQueued) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetIsQueued(m_backendHandle, isQueued);
    }) > 0;
}
 
inline bool Buffer::IsAcquiring() const
{
    return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* isAcquiring) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetIsAcquiring(m_backendHandle, isAcquiring);
    }) > 0;
}
 
inline bool Buffer::IsIncomplete() const
{
    return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* isIncomplete) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetIsIncomplete(m_backendHandle, isIncomplete);
    }) > 0;
}
 
inline bool Buffer::HasNewData() const
{
    return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* hasNewData) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetHasNewData(m_backendHandle, hasNewData);
    }) > 0;
}
 
inline bool Buffer::HasImage() const
{
    return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* hasImage) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetHasImage(m_backendHandle, hasImage);
    }) > 0;
}
 
inline bool Buffer::HasChunks() const
{
    return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* hasChunks) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetHasChunks(m_backendHandle, hasChunks);
    }) > 0;
}
 
inline bool Buffer::HasParts() const
{
    return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* hasParts) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetHasParts(m_backendHandle, hasParts);
    }) > 0;
}
 
inline uint64_t Buffer::SystemTimestamp_ns() const
{
    return QueryNumericFromCInterfaceFunction<uint64_t>([&](uint64_t* systemTimestamp_ns) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetSystemTimestamp_ns(m_backendHandle, systemTimestamp_ns);
    });
}
 
inline std::vector<std::shared_ptr<BufferChunk>> Buffer::Chunks()
{
    CallAndCheckCInterfaceFunction([&] { return PEAK_C_ABI_PREFIX PEAK_Buffer_UpdateChunks(m_backendHandle); });
 
    auto numChunks = QueryNumericFromCInterfaceFunction<size_t>([&](size_t* _numChunks) {
        return PEAK_C_ABI_PREFIX PEAK_Buffer_GetNumChunks(m_backendHandle, _numChunks);
    });
 
    std::vector<std::shared_ptr<BufferChunk>> chunks;
    for (size_t x = 0; x < numChunks; ++x)
    {
        auto bufferChunkHandle = QueryNumericFromCInterfaceFunction<PEAK_BUFFER_CHUNK_HANDLE>(
            [&](PEAK_BUFFER_CHUNK_HANDLE* _bufferChunkHandle) {
                return PEAK_C_ABI_PREFIX PEAK_Buffer_GetChunk(m_backendHandle, x, _bufferChunkHandle);
            });
 
        chunks.emplace_back(std::make_shared<ClassCreator<BufferChunk>>(bufferChunkHandle, shared_from_this()));
    }
 
    return chunks;
}
 
inline std::vector<std::shared_ptr<BufferPart>> Buffer::Parts()
{
    CallAndCheckCInterfaceFunction([&] { return PEAK_C_ABI_PREFIX PEAK_Buffer_UpdateParts(m_backendHandle); });
 
    auto numParts = QueryNumericFromCInterfaceFunction<size_t>(
        [&](size_t* _numParts) { return PEAK_C_ABI_PREFIX PEAK_Buffer_GetNumParts(m_backendHandle, _numParts); });
 
    std::vector<std::shared_ptr<BufferPart>> parts;
    for (size_t x = 0; x < numParts; ++x)
    {
        auto bufferPartHandle = QueryNumericFromCInterfaceFunction<PEAK_BUFFER_PART_HANDLE>(
            [&](PEAK_BUFFER_PART_HANDLE* _bufferPartHandle) {
                return PEAK_C_ABI_PREFIX PEAK_Buffer_GetPart(m_backendHandle, x, _bufferPartHandle);
            });
 
        parts.emplace_back(std::make_shared<ClassCreator<BufferPart>>(bufferPartHandle, shared_from_this()));
    }
 
    return parts;
}
 
inline std::shared_ptr<DataStream> Buffer::ParentDataStream() const
{
    return LockOrThrow(m_parentDataStream);
}
 
inline PEAK_MODULE_HANDLE Buffer::ModuleHandle() const
{
    auto moduleHandle = QueryNumericFromCInterfaceFunction<PEAK_MODULE_HANDLE>(
        [&](PEAK_MODULE_HANDLE* _moduleHandle) {
            return PEAK_C_ABI_PREFIX PEAK_Buffer_ToModule(m_backendHandle, _moduleHandle);
        });
 
    return moduleHandle;
}
 
inline PEAK_EVENT_SUPPORTING_MODULE_HANDLE Buffer::EventSupportingModuleHandle() const
{
    auto eventSupportingModuleHandle = QueryNumericFromCInterfaceFunction<PEAK_EVENT_SUPPORTING_MODULE_HANDLE>(
        [&](PEAK_EVENT_SUPPORTING_MODULE_HANDLE* _eventSupportingModuleHandle) {
            return PEAK_C_ABI_PREFIX PEAK_Buffer_ToEventSupportingModule(
                m_backendHandle, _eventSupportingModuleHandle);
        });
 
    return eventSupportingModuleHandle;
}
 
inline void Buffer::Revoke()
{
    m_parentDataStream.reset();
}
 
inline bool NodeMap::HasBufferSupportedChunks(const std::shared_ptr<Buffer>& buffer) const
{
    if (buffer == nullptr)
    {
        throw InvalidArgumentException("The given buffer is a nullptr!");
    }
 
    return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* hasSupportedChunks) {
        return PEAK_C_ABI_PREFIX PEAK_NodeMap_GetHasBufferSupportedChunks(
            m_backendHandle, buffer->m_backendHandle, hasSupportedChunks);
    }) > 0;
}
 
inline void NodeMap::UpdateChunkNodes(const std::shared_ptr<Buffer>& buffer)
{
    if (buffer == nullptr)
    {
        throw InvalidArgumentException("The given buffer is a nullptr!");
    }
 
    CallAndCheckCInterfaceFunction([&] {
        return PEAK_C_ABI_PREFIX PEAK_NodeMap_UpdateChunkNodes(m_backendHandle, buffer->m_backendHandle);
    });
}
 
} /* namespace core */
} /* namespace peak */