imageset.h

/*******************************************************************************
 * Copyright (c) 2024 Allied Vision Technologies GmbH
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *******************************************************************************/
 
#ifndef VISIONTRANSFER_IMAGESET_H
#define VISIONTRANSFER_IMAGESET_H
 
#include <cassert>
#include <cstddef>
#include "visiontransfer/common.h"
 
namespace visiontransfer {
 
class VT_EXPORT ImageSet {
 
private:
    // We follow the pimpl idiom
    class Pimpl;
    Pimpl* pimpl;
 
public:
    static const int MAX_SUPPORTED_IMAGES = 4;
    enum ImageFormat {
        FORMAT_8_BIT_MONO,
 
        FORMAT_8_BIT_RGB,
 
        FORMAT_12_BIT_MONO
    };
 
    enum ImageFormat_Deprecated {
        FORMAT_8_BIT =  FORMAT_8_BIT_MONO,
        FORMAT_12_BIT = FORMAT_12_BIT_MONO
    };
 
    enum ImageType {
        IMAGE_UNDEFINED,
        IMAGE_LEFT,
        IMAGE_DISPARITY,
        IMAGE_RIGHT,
 
        IMAGE_COLOR
    };
 
    ImageSet();
 
    ImageSet(const ImageSet& other);
 
    ~ImageSet();
    ImageSet& operator= (ImageSet const& other);
 
    void setWidth(int w);
 
    void setHeight(int h);
 
    void setRowStride(int imageNumber, int stride);
 
    void setPixelFormat(int imageNumber, ImageFormat format);
 
#ifndef DOXYGEN_SHOULD_SKIP_THIS
    DEPRECATED("Use setPixelFormat(int, ImageFormat) instead") void setPixelFormat(int imageNumber, ImageFormat_Deprecated format) {
        setPixelFormat(imageNumber, static_cast<ImageFormat>(format));
    }
#endif
 
    void setPixelData(int imageNumber, unsigned char* pixelData);
 
    void setQMatrix(const float* q);
 
    void setSequenceNumber(unsigned int num);
 
    void setTimestamp(int seconds, int microsec);
 
    void setDisparityRange(int minimum, int maximum);
 
    void setSubpixelFactor(int subpixFact);
 
#ifndef DOXYGEN_SHOULD_SKIP_THIS
 
    DEPRECATED("Only compatible with two-image sets: use setNumberOfImages() and setIndexOf() instead")
    void setImageDisparityPair(bool dispPair);
#endif
 
    int getWidth() const;
 
    int getHeight() const;
 
    int getRowStride(int imageNumber) const;
 
    int getRowStride(ImageType what) const;
 
    ImageFormat getPixelFormat(int imageNumber) const;
 
    ImageFormat getPixelFormat(ImageType what) const;
 
    unsigned char* getPixelData(int imageNumber) const;
 
    unsigned char* getPixelData(ImageType what) const;
 
    const float* getQMatrix() const;
 
    unsigned int getSequenceNumber() const;
 
    void getTimestamp(int& seconds, int& microsec) const;
 
    void getDisparityRange(int& minimum, int& maximum) const;
 
    int getSubpixelFactor() const;
 
    void writePgmFile(int imageNumber, const char* fileName) const;
 
#ifndef DOXYGEN_SHOULD_SKIP_THIS
 
    DEPRECATED("Only compatible with two-image sets: use hasImageType(ImageSet::IMAGE_DISPARITY) instead")
    bool isImageDisparityPair() const {
        return (getNumberOfImages()==2) && hasImageType(IMAGE_DISPARITY);
    }
#endif
 
    void copyTo(ImageSet& dest);
 
    int getBytesPerPixel(int imageNumber) const;
 
    int getBitsPerPixel(int imageNumber) const;
 
    int getBitsPerPixel(ImageType what) const;
 
    static int getBitsPerPixel(ImageFormat format);
 
    static int getBytesPerPixel(ImageFormat format);
 
    int getNumberOfImages() const;
 
    void setNumberOfImages(int number);
 
    ImageType getImageType(int imageNumber) const;
 
    int getIndexOf(ImageType what, bool throwIfNotFound=false) const;
 
    bool hasImageType(ImageType what) const;
 
    void setIndexOf(ImageType what, int idx);
 
 
#ifdef CV_MAJOR_VERSION
 
    inline void toOpenCVImage(int imageNumber, cv::Mat& dest, bool convertRgbToBgr = true);
#endif
 
    void setExposureTime(int timeMicrosec);
 
    int getExposureTime() const;
 
    void setLastSyncPulse(int seconds, int microsec);
 
    void getLastSyncPulse(int& seconds, int& microsec) const;
 
};
 
#ifndef DOXYGEN_SHOULD_SKIP_THIS
// For source compatibility
class DEPRECATED("Use ImageSet instead.") ImagePair: public ImageSet {
};
#endif
 
} // namespace
 
#include "visiontransfer/imageset-opencv.h"
#endif