ipcamerasettings.h

/**************************************************************************
 *
 * File: ipcamerasettings.h
 *
 *
 * Description: Contains the wrapper class definition for the IP camera API.
 * The IP Camera API allows you to send and receive commands to a IP Camera that supports
 * the ISO17215 standard. This simplifies handling and communication with IP cameras.
 *
 * Copyright (C) 2018 CrossControl AB
 * All rights reserved.
 * Contact: CrossControl AB (info@crosscontrol.com)
 *
**************************************************************************/

#ifndef IPCAMERASETTINGS_H
#define IPCAMERASETTINGS_H

/*************************************************************************
 * Include Files
 *************************************************************************/
#include <string>
#include <vector>
#include "camtypes.h"

/*************************************************************************
 * Manifest constants, macros
 *************************************************************************/
#ifndef MAX_WAIT_TIME_MS
#define MAX_WAIT_TIME_MS 1500
#endif

class CameraSettings;

namespace CrossControl {

/*************************************************************************
 * Class definition
 *************************************************************************/
class IPCameraSettings
{
public:

    IPCameraSettings();

    IPCameraSettings(std::string ipAddress, int portNum, int clientID = 1);

    IPCameraSettings(IPCameraSettings &other) = delete;

    ~IPCameraSettings();

    IPCamStatus open();

    IPCamStatus open(std::string ipAddress, int portNum);

    IPCamStatus openServiceDiscovery(std::vector<std::string> multicastGroups, int portNumber);

    IPCamStatus openServiceDiscovery(int portNumber);

    IPCamStatus close();

    IPCamStatus closeServiceDiscoverySocket();

    IPCamStatus getDatasheet(Datasheet &datasheet, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus getCamStatus(CamStatus &camStatus, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus setCamExclusive(const int expireTimeSeconds = 5, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus eraseCamExclusive(const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus setRegionOfInterest(const RegionOfInterest regionOfInterest, const uint32_t roiIndex, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus getRegionOfInterest(RegionOfInterest &regionOfInterest, const uint32_t roiIndex, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus getRegionsOfInterest(std::vector<uint32_t> &roiIndices, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus eraseRegionOfInterest(const uint32_t roiIndex, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus subscribeROIVideo(const uint32_t roiIndex = 0, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus subscribeROIVideo(VideoContent &videoContent, const uint32_t roiIndex = 0, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus unsubscribeROIVideo(const uint32_t roiIndex, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus setBrightnessControl(const SignedControl sControl, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus getBrightnessControl(SignedControl &sControl, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus setSaturationControl(const UnsignedControl uControl, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus getSaturationControl(UnsignedControl &uControl, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus setGammaControl(const UnsignedControl uControl, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus getGammaControl(UnsignedControl &uControl, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus setHeaterControl(const UnsignedControl uControl, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus getHeaterControl(UnsignedControl &uControl, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus setCamRegister(const ImagerRegister imagerRegister, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus setCamRegister(const uint16_t regAddress, const uint16_t regValue, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus setCamRegisters(const std::vector<ImagerRegister> &imagerRegisters, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus getCamRegister(const uint16_t regAddress, uint16_t &regValue, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus getCamRegisters(const std::vector<uint16_t> &addressList, std::vector<ImagerRegister> &imagerRegisters, const int maxWaitTimeMs = MAX_WAIT_TIME_MS);

    IPCamStatus sendMessageNoResponse(const unsigned char *data, const size_t messageLength) const;

    IPCamStatus sendMessageWithResponse(const unsigned char * data, const size_t messageLength, unsigned char * responseData, size_t &responseLength, const int maxWaitTimeMs = MAX_WAIT_TIME_MS) const;

    IPCamStatus serviceDiscoveryGetIPv4(IPv4Option &option);

    uint16_t getSessionID() const;

    void setSessionID(uint16_t arg);

    uint16_t getClientID() const;

    void setClientID(uint16_t arg);

    static std::string stringifyIPCamStatus(const IPCamStatus camStatus);

private:
    CameraSettings* m_cameraSettings;
};
}

#endif // IPCAMERASETTINGS_H