itkVideoIOBase.h

Go to the documentation of this file.

/*=========================================================================
 *
 *  Copyright Insight Software Consortium
 *
 *  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
 *
 *         http://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 "itkExceptionObject.h"
#include "ITKVideoIOExport.h"
#include "vnl/vnl_vector.h"

#include <string>

namespace itk
{
class ITKVideoIO_EXPORT VideoIOBase : public ImageIOBase
{
public:
  ITK_DISALLOW_COPY_AND_ASSIGN(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;

  itkTypeMacro(VideoIOBase, Superclass);

  virtual void FinishReadingOrWriting() = 0;

  /*-------- This part of the interface deals with reading data. ------ */

  typedef enum {ReadFromFile, ReadFromCamera} ReadType;

  virtual void SetReadFromFile() = 0;

  virtual void SetReadFromCamera() = 0;

  ReadType GetReadType() {
    return this->m_ReadType;
  }

  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,
                                    IOComponentType componentType) = 0;

protected:

  VideoIOBase();
  ~VideoIOBase() override;

  void PrintSelf(std::ostream & os, Indent indent) const override;

  ReadType           m_ReadType{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