itkVideoIOBase.h

Go to the documentation of this file.

/*=========================================================================
 *
 *  Copyright NumFOCUS
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *         https://www.apache.org/licenses/LICENSE-2.0.txt
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *
 *=========================================================================*/
#ifndef itkVideoIOBase_h
#define itkVideoIOBase_h
 
#include "itkImageIOBase.h"
#include "ITKVideoIOExport.h"
#include "vnl/vnl_vector.h"
 
#include <string>
 
namespace itk
{
class VideoIOBaseEnums
{
public:
  enum class ReadFrom : uint8_t
  {
    ReadFromFile,
    ReadFromCamera
  };
};
// Define how to print enumeration
extern ITKVideoIO_EXPORT std::ostream &
                         operator<<(std::ostream & out, const VideoIOBaseEnums::ReadFrom value);

class ITKVideoIO_EXPORT VideoIOBase : public ImageIOBase
{
public:
  ITK_DISALLOW_COPY_AND_MOVE(VideoIOBase);

  using Self = VideoIOBase;
  using Superclass = ImageIOBase;
  using Pointer = SmartPointer<Self>;
  using SizeValueType = itk::SizeValueType;

  using TemporalOffsetType = double;
  using FrameOffsetType = SizeValueType;
  using TemporalRatioType = double;

  using CameraIDType = SizeValueType;

  itkOverrideGetNameOfClassMacro(VideoIOBase);

  virtual void
  FinishReadingOrWriting() = 0;
 
  /*-------- This part of the interface deals with reading data. ------ */
 
  using ReadFromEnum = VideoIOBaseEnums::ReadFrom;
#if !defined(ITK_LEGACY_REMOVE)
  // We need to expose the enum values at the class level
  // for backwards compatibility
  static constexpr ReadFromEnum ReadFromFile = ReadFromEnum::ReadFromFile;
  static constexpr ReadFromEnum ReadFromCamera = ReadFromEnum::ReadFromCamera;
#endif

  virtual void
  SetReadFromFile() = 0;

  virtual void
  SetReadFromCamera() = 0;

  ReadFromEnum
  GetReadFrom()
  {
    return this->m_ReadFrom;
  }

  virtual bool
  CanReadCamera(CameraIDType cameraID) const = 0;

  virtual bool
  SetNextFrameToRead(FrameOffsetType frameNumber) = 0;

  virtual TemporalOffsetType
  GetPositionInMSec() const = 0;
  virtual TemporalRatioType
  GetRatio() const = 0;
  virtual FrameOffsetType
  GetFrameTotal() const = 0;
  virtual TemporalRatioType
  GetFramesPerSecond() const = 0;
  virtual FrameOffsetType
  GetCurrentFrame() const = 0;
  virtual FrameOffsetType
  GetLastIFrame() const = 0;
 
  /*-------- This part of the interfaces deals with writing data. ----- */

  virtual void
  SetWriterParameters(TemporalRatioType                  framesPerSecond,
                      const std::vector<SizeValueType> & dim,
                      const char *                       fourCC,
                      unsigned int                       nChannels,
                      IOComponentEnum                    componentType) = 0;
 
protected:
  VideoIOBase();
  ~VideoIOBase() override;
 
  void
  PrintSelf(std::ostream & os, Indent indent) const override;

  ReadFromEnum       m_ReadFrom{ ReadFromEnum::ReadFromFile };
  TemporalRatioType  m_FramesPerSecond{ 0.0 };
  FrameOffsetType    m_FrameTotal{};
  FrameOffsetType    m_CurrentFrame{};
  FrameOffsetType    m_IFrameInterval{};
  FrameOffsetType    m_LastIFrame{};
  TemporalRatioType  m_Ratio{ 0.0 };
  TemporalOffsetType m_PositionInMSec{ 0.0 };
  bool               m_WriterOpen{ false };
  bool               m_ReaderOpen{ false };
};
} // end namespace itk
 
#endif // itkVideoIOBase_h