ITK  4.2.0
Insight Segmentation and Registration Toolkit
Classes | Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Static Protected Member Functions | Private Member Functions
itk::VideoSource< TOutputVideoStream > Class Template Reference

#include <itkVideoSource.h>

+ Inheritance diagram for itk::VideoSource< TOutputVideoStream >:
+ Collaboration diagram for itk::VideoSource< TOutputVideoStream >:

List of all members.

Classes

struct  ThreadStruct

Public Types

typedef SmartPointer< const SelfConstPointer
typedef WeakPointer< const SelfConstWeakPointer
typedef
ProcessObject::DataObjectPointerArraySizeType 
DataObjectPointerArraySizeType
typedef
OutputVideoStreamType::DirectionType 
OutputFrameDirectionType
typedef
OutputVideoStreamType::IndexType 
OutputFrameIndexType
typedef
OutputVideoStreamType::PixelType 
OutputFramePixelType
typedef
OutputVideoStreamType::PointType 
OutputFramePointType
typedef
OutputVideoStreamType::SizeType 
OutputFrameSizeType
typedef
OutputVideoStreamType::SpacingType 
OutputFrameSpacingType
typedef
OutputVideoStreamType::SpatialRegionType 
OutputFrameSpatialRegionType
typedef
OutputVideoStreamType::FrameType 
OutputFrameType
typedef TOutputVideoStream OutputVideoStreamType
typedef SmartPointer< SelfPointer
typedef VideoSource Self
typedef TemporalProcessObject Superclass
- Public Types inherited from itk::TemporalProcessObject
- Public Types inherited from itk::ProcessObject
typedef
DataObject::DataObjectIdentifierType 
DataObjectIdentifierType
typedef DataObject::Pointer DataObjectPointer
typedef std::vector
< DataObjectPointer
DataObjectPointerArray
typedef std::vector
< DataObjectIdentifierType
NameArray
- Public Types inherited from itk::Object
- Public Types inherited from itk::LightObject

Public Member Functions

virtual ::itk::LightObject::Pointer CreateAnother (void) const
virtual const char * GetNameOfClass () const
OutputVideoStreamTypeGetOutput ()
OutputVideoStreamTypeGetOutput (unsigned int idx)
virtual void GraftNthOutput (unsigned int idx, OutputVideoStreamType *output)
virtual void GraftOutput (OutputVideoStreamType *output)
virtual DataObjectPointer MakeOutput (DataObjectPointerArraySizeType idx)
- Public Member Functions inherited from itk::TemporalProcessObject
virtual void EnlargeOutputRequestedRegion (DataObject *output)
virtual void GenerateData ()
virtual void GenerateInputRequestedRegion ()
virtual void GenerateOutputRequestedRegion (DataObject *output)
virtual SizeValueType GetUnitInputNumberOfFrames ()
virtual SizeValueType GetUnitOutputNumberOfFrames ()
virtual void UpdateOutputData (DataObject *output)
virtual void UpdateOutputInformation ()
- Public Member Functions inherited from itk::ProcessObject
virtual void AbortGenerateDataOff ()
virtual void AbortGenerateDataOn ()
virtual const bool & GetAbortGenerateData ()
NameArray GetInputNames () const
MultiThreader * GetMultiThreader () const
DataObjectPointerArraySizeType GetNumberOfIndexedInputs () const
DataObjectPointerArraySizeType GetNumberOfInputs () const
DataObjectPointerArraySizeType GetNumberOfOutputs () const
virtual
DataObjectPointerArraySizeType 
GetNumberOfValidRequiredInputs () const
NameArray GetOutputNames () const
virtual const float & GetProgress ()
NameArray GetRequiredInputNames () const
bool HasInput (const DataObjectIdentifierType &key) const
bool HasOutput (const DataObjectIdentifierType &key) const
virtual DataObjectPointer MakeOutput (const DataObjectIdentifierType &)
virtual void PrepareOutputs ()
virtual void PropagateRequestedRegion (DataObject *output)
virtual void ResetPipeline ()
virtual void SetAbortGenerateData (bool _arg)
virtual void SetProgress (float _arg)
virtual void Update ()
virtual void UpdateLargestPossibleRegion ()
void UpdateProgress (float amount)
DataObjectPointerArray GetInputs ()
DataObjectPointerArray GetOutputs ()
DataObjectPointerArray GetIndexedInputs ()
DataObjectPointerArray GetIndexedOutputs ()
DataObjectPointerArraySizeType GetNumberOfIndexedOutputs () const
virtual void SetReleaseDataFlag (bool flag)
virtual bool GetReleaseDataFlag () const
void ReleaseDataFlagOn ()
void ReleaseDataFlagOff ()
virtual void SetReleaseDataBeforeUpdateFlag (bool _arg)
virtual const bool & GetReleaseDataBeforeUpdateFlag ()
virtual void ReleaseDataBeforeUpdateFlagOn ()
virtual void ReleaseDataBeforeUpdateFlagOff ()
virtual void SetNumberOfThreads (ThreadIdType _arg)
virtual const ThreadIdTypeGetNumberOfThreads ()
- Public Member Functions inherited from itk::Object
unsigned long AddObserver (const EventObject &event, Command *)
unsigned long AddObserver (const EventObject &event, Command *) const
virtual void DebugOff () const
virtual void DebugOn () const
CommandGetCommand (unsigned long tag)
bool GetDebug () const
MetaDataDictionaryGetMetaDataDictionary (void)
const MetaDataDictionaryGetMetaDataDictionary (void) const
virtual unsigned long GetMTime () const
virtual const TimeStampGetTimeStamp () const
bool HasObserver (const EventObject &event) const
void InvokeEvent (const EventObject &)
void InvokeEvent (const EventObject &) const
virtual void Modified () const
virtual void Register () const
void RemoveAllObservers ()
void RemoveObserver (unsigned long tag)
void SetDebug (bool debugFlag) const
void SetMetaDataDictionary (const MetaDataDictionary &rhs)
virtual void SetReferenceCount (int)
virtual void UnRegister () const
- Public Member Functions inherited from itk::LightObject
virtual void Delete ()
virtual int GetReferenceCount () const
 itkCloneMacro (Self)
void Print (std::ostream &os, Indent indent=0) const

Static Public Member Functions

static Pointer New ()

Protected Member Functions

virtual void AfterThreadedGenerateData ()
virtual void AllocateOutputs ()
virtual void BeforeThreadedGenerateData ()
virtual void GenerateOutputRequestedTemporalRegion (TemporalDataObject *output)
virtual void PrintSelf (std::ostream &os, Indent indent) const
virtual int SplitRequestedSpatialRegion (int i, int num, OutputFrameSpatialRegionType &splitRegion)
virtual void TemporalStreamingGenerateData ()
virtual void ThreadedGenerateData (const OutputFrameSpatialRegionType &outputRegionForThread, int threadId)
 VideoSource ()
virtual ~VideoSource ()
- Protected Member Functions inherited from itk::TemporalProcessObject
virtual void AfterTemporalStreamingGenerateData ()
virtual void BeforeTemporalStreamingGenerateData ()
virtual void EnlargeOutputRequestedTemporalRegion (TemporalDataObject *output)
virtual TemporalRegion GenerateDefaultLargestPossibleTemporalRegion ()
virtual void GenerateInputRequestedTemporalRegion ()
virtual SizeValueType GetInputStencilCurrentFrameIndex ()
virtual void SetFrameSkipPerOutput (OffsetValueType _arg)
virtual void SetInputStencilCurrentFrameIndex (SizeValueType _arg)
virtual void SetUnitInputNumberOfFrames (SizeValueType _arg)
virtual void SetUnitOutputNumberOfFrames (SizeValueType _arg)
virtual std::vector
< TemporalRegion
SplitRequestedTemporalRegion ()
 TemporalProcessObject ()
virtual ~TemporalProcessObject ()
- Protected Member Functions inherited from itk::ProcessObject
virtual void AddInput (DataObject *input)
virtual void AddOutput (DataObject *output)
bool AddRequiredInputName (const DataObjectIdentifierType &)
virtual void CacheInputReleaseDataFlags ()
virtual void GenerateOutputInformation ()
virtual const
DataObjectPointerArraySizeType
GetNumberOfRequiredInputs ()
virtual const
DataObjectPointerArraySizeType
GetNumberOfRequiredOutputs ()
bool IsIndexedName (const DataObjectIdentifierType &) const
bool IsRequiredInputName (const DataObjectIdentifierType &) const
 itkLegacyMacro (virtual void RemoveInput(DataObject *input))
 itkLegacyMacro (virtual void RemoveOutput(DataObject *output))
 itkLegacyMacro (void SetNumberOfInputs(DataObjectPointerArraySizeType num))
 itkLegacyMacro (void SetNumberOfOutputs(DataObjectPointerArraySizeType num))
DataObjectPointerArraySizeType MakeIndexFromName (const DataObjectIdentifierType &) const
DataObjectIdentifierType MakeNameFromIndex (DataObjectPointerArraySizeType) const
 ProcessObject ()
virtual void PropagateResetPipeline ()
virtual void ReleaseInputs ()
virtual void RemoveInput (const DataObjectIdentifierType &key)
virtual void RemoveInput (DataObjectPointerArraySizeType)
virtual void RemoveOutput (const DataObjectIdentifierType &key)
virtual void RemoveOutput (DataObjectPointerArraySizeType idx)
bool RemoveRequiredInputName (const DataObjectIdentifierType &)
virtual void RestoreInputReleaseDataFlags ()
virtual void SetInput (const DataObjectIdentifierType &key, DataObject *input)
virtual void SetNthInput (DataObjectPointerArraySizeType num, DataObject *input)
virtual void SetNthOutput (DataObjectPointerArraySizeType num, DataObject *output)
void SetNumberOfIndexedInputs (DataObjectPointerArraySizeType num)
void SetNumberOfIndexedOutputs (DataObjectPointerArraySizeType num)
virtual void SetNumberOfRequiredInputs (DataObjectPointerArraySizeType)
virtual void SetNumberOfRequiredOutputs (DataObjectPointerArraySizeType _arg)
virtual void SetOutput (const DataObjectIdentifierType &key, DataObject *output)
virtual void SetPrimaryInput (DataObject *input)
virtual void SetPrimaryOutput (DataObject *output)
void SetRequiredInputNames (const NameArray &)
virtual void VerifyInputInformation ()
virtual void VerifyPreconditions ()
 ~ProcessObject ()
DataObjectGetInput (const DataObjectIdentifierType &key)
const DataObjectGetInput (const DataObjectIdentifierType &key) const
DataObjectGetInput (DataObjectPointerArraySizeType)
const DataObjectGetInput (DataObjectPointerArraySizeType idx) const
DataObjectGetPrimaryInput ()
const DataObjectGetPrimaryInput () const
DataObjectGetOutput (const DataObjectIdentifierType &key)
const DataObjectGetOutput (const DataObjectIdentifierType &key) const
DataObjectGetOutput (DataObjectPointerArraySizeType idx)
const DataObjectGetOutput (DataObjectPointerArraySizeType idx) const
DataObjectGetPrimaryOutput ()
const DataObjectGetPrimaryOutput () const
virtual void PushBackInput (const DataObject *input)
virtual void PopBackInput ()
virtual void PushFrontInput (const DataObject *input)
virtual void PopFrontInput ()
- Protected Member Functions inherited from itk::Object
 Object ()
bool PrintObservers (std::ostream &os, Indent indent) const
virtual void SetTimeStamp (const TimeStamp &time)
virtual ~Object ()
- Protected Member Functions inherited from itk::LightObject
virtual LightObject::Pointer InternalClone () const
 LightObject ()
virtual void PrintHeader (std::ostream &os, Indent indent) const
virtual void PrintTrailer (std::ostream &os, Indent indent) const
virtual ~LightObject ()

Static Protected Member Functions

static ITK_THREAD_RETURN_TYPE ThreaderCallback (void *arg)

Private Member Functions

void operator= (const Self &)
 VideoSource (const Self &)
static const unsigned int OutputFrameDimension = OutputFrameType::ImageDimension
static unsigned int GetOutputFrameDimension ()

Additional Inherited Members

- Protected Attributes inherited from itk::TemporalProcessObject
OffsetValueType m_FrameSkipPerOutput
SizeValueType m_InputStencilCurrentFrameIndex
SizeValueType m_UnitInputNumberOfFrames
SizeValueType m_UnitOutputNumberOfFrames
- Protected Attributes inherited from itk::ProcessObject
bool m_Updating
TimeStamp m_OutputInformationMTime

Detailed Description

template<class TOutputVideoStream>
class itk::VideoSource< TOutputVideoStream >

A TemporalProcessObject that produces a VideoStream.

VideoSource acts as the base class for all TemporalProcess objects that produce a VideoStream as their output. This class defines GetOutput() which returns a pointer to the VideoStream object on output port 0.

The other roll that VideoSource plays is to implement the framework for spatial streaming to complement the temporal streaming implemented in TemporalProcessObject. This implementation mirrors the implementation in ImageSource except that each thread will be able to operate on a spatial region of each frame in the current temporal region that is being processed.

Definition at line 43 of file itkVideoSource.h.


Member Typedef Documentation

template<class TOutputVideoStream>
typedef SmartPointer< const Self > itk::VideoSource< TOutputVideoStream >::ConstPointer
template<class TOutputVideoStream>
typedef WeakPointer< const Self > itk::VideoSource< TOutputVideoStream >::ConstWeakPointer
template<class TOutputVideoStream>
typedef ProcessObject::DataObjectPointerArraySizeType itk::VideoSource< TOutputVideoStream >::DataObjectPointerArraySizeType

Make a DataObject of the correct type for the specified output port. The default always creates an OutputVideoStreamType object, so subclasses with multiple types of output must override this to return the proper type.

Reimplemented from itk::ProcessObject.

Definition at line 101 of file itkVideoSource.h.

template<class TOutputVideoStream>
typedef OutputVideoStreamType::DirectionType itk::VideoSource< TOutputVideoStream >::OutputFrameDirectionType

Definition at line 64 of file itkVideoSource.h.

template<class TOutputVideoStream>
typedef OutputVideoStreamType::IndexType itk::VideoSource< TOutputVideoStream >::OutputFrameIndexType

Definition at line 59 of file itkVideoSource.h.

template<class TOutputVideoStream>
typedef OutputVideoStreamType::PixelType itk::VideoSource< TOutputVideoStream >::OutputFramePixelType

Definition at line 60 of file itkVideoSource.h.

template<class TOutputVideoStream>
typedef OutputVideoStreamType::PointType itk::VideoSource< TOutputVideoStream >::OutputFramePointType

Definition at line 61 of file itkVideoSource.h.

template<class TOutputVideoStream>
typedef OutputVideoStreamType::SizeType itk::VideoSource< TOutputVideoStream >::OutputFrameSizeType

Definition at line 63 of file itkVideoSource.h.

template<class TOutputVideoStream>
typedef OutputVideoStreamType::SpacingType itk::VideoSource< TOutputVideoStream >::OutputFrameSpacingType

Definition at line 62 of file itkVideoSource.h.

template<class TOutputVideoStream>
typedef OutputVideoStreamType::SpatialRegionType itk::VideoSource< TOutputVideoStream >::OutputFrameSpatialRegionType
template<class TOutputVideoStream>
typedef OutputVideoStreamType::FrameType itk::VideoSource< TOutputVideoStream >::OutputFrameType
template<class TOutputVideoStream>
typedef TOutputVideoStream itk::VideoSource< TOutputVideoStream >::OutputVideoStreamType
template<class TOutputVideoStream>
typedef SmartPointer< Self > itk::VideoSource< TOutputVideoStream >::Pointer
template<class TOutputVideoStream>
typedef VideoSource itk::VideoSource< TOutputVideoStream >::Self
template<class TOutputVideoStream>
typedef TemporalProcessObject itk::VideoSource< TOutputVideoStream >::Superclass

Constructor & Destructor Documentation

template<class TOutputVideoStream>
itk::VideoSource< TOutputVideoStream >::VideoSource ( )
protected
template<class TOutputVideoStream>
virtual itk::VideoSource< TOutputVideoStream >::~VideoSource ( )
protectedvirtual
template<class TOutputVideoStream>
itk::VideoSource< TOutputVideoStream >::VideoSource ( const Self )
private

Member Function Documentation

template<class TOutputVideoStream>
virtual void itk::VideoSource< TOutputVideoStream >::AfterThreadedGenerateData ( void  )
inlineprotectedvirtual

Method that gets called after all threads finish in TemporalStreamingGenerateData

Definition at line 156 of file itkVideoSource.h.

template<class TOutputVideoStream>
virtual void itk::VideoSource< TOutputVideoStream >::AllocateOutputs ( )
protectedvirtual

The GenerateData method normally allocates the buffers for all of the outputs of a filter. Some filters may want to override this default behavior. For example, a filter may have multiple outputs with varying resolution. Or a filter may want to process data in place by grafting its input to its output.

template<class TOutputVideoStream>
virtual void itk::VideoSource< TOutputVideoStream >::BeforeThreadedGenerateData ( void  )
inlineprotectedvirtual

Method that gets called before threads are dispatched from TemporalStreamingGeneratData

Definition at line 151 of file itkVideoSource.h.

template<class TOutputVideoStream>
virtual::itk::LightObject::Pointer itk::VideoSource< TOutputVideoStream >::CreateAnother ( void  ) const
virtual
template<class TOutputVideoStream>
virtual void itk::VideoSource< TOutputVideoStream >::GenerateOutputRequestedTemporalRegion ( TemporalDataObject output)
protectedvirtual

Override GenerateOutputRequestedTemporalRegion to make sure that if the requested temporal region is not set, it gets set to the largest possible temporal region (using TemporalProcessObject's implementation) and the output has enough frame buffer slots to hold the entire request. We don't want the number of buffers to be changed for mid-pipeline filters since they will usually operate on fewer frames than requested at any given time. The solution is to only change the number of buffers if the requested temporal region was unset at the beginning of the call since mid-pipeline filters will always have their outputs' requested spatial regions set by the GenerateInputRequestedRegion call from the filter one further down the pipeline.

Reimplemented from itk::TemporalProcessObject.

template<class TOutputVideoStream>
virtual const char* itk::VideoSource< TOutputVideoStream >::GetNameOfClass ( ) const
virtual
template<class TOutputVideoStream>
OutputVideoStreamType* itk::VideoSource< TOutputVideoStream >::GetOutput ( )

GetOutput() returns a pointer to the VideoStream on output port 0. This is analogous to the GetOutput on ImageSource and will be used to pass VideoStream data between TemporalProcessObjects (typically video filters)

template<class TOutputVideoStream>
OutputVideoStreamType* itk::VideoSource< TOutputVideoStream >::GetOutput ( unsigned int  idx)
template<class TOutputVideoStream>
static unsigned int itk::VideoSource< TOutputVideoStream >::GetOutputFrameDimension ( )
inlinestatic

Access the spacial dimensionality of the frames

Definition at line 75 of file itkVideoSource.h.

template<class TOutputVideoStream>
virtual void itk::VideoSource< TOutputVideoStream >::GraftNthOutput ( unsigned int  idx,
OutputVideoStreamType output 
)
virtual

Graft the provided VideoStream onto the TemporalProcessObject's idx'th output using VideoStream's Graft implementation

template<class TOutputVideoStream>
virtual void itk::VideoSource< TOutputVideoStream >::GraftOutput ( OutputVideoStreamType output)
virtual

Graft the provided VideoStream onto the 0th output. This is useful for ImageSources that use a mini-pipeline internally. See comment in ImageSource for more information.

template<class TOutputVideoStream>
virtual DataObjectPointer itk::VideoSource< TOutputVideoStream >::MakeOutput ( DataObjectPointerArraySizeType  idx)
virtual

Make a DataObject of the correct type to used as the specified output. Every ProcessObject subclass must be able to create a DataObject that can be used as a specified output. This method is automatically called when DataObject::DisconnectPipeline() is called. DataObject::DisconnectPipeline, disconnects a data object from being an output of its current source. When the data object is disconnected, the ProcessObject needs to construct a replacement output data object so that the ProcessObject is in a valid state. So DataObject::DisconnectPipeline eventually calls ProcessObject::MakeOutput. Note that MakeOutput always returns a itkSmartPointer to a DataObject. ImageSource and MeshSource override this method to create the correct type of image and mesh respectively. If a filter has multiple outputs of different types, then that filter must provide an implementation of MakeOutput().

Reimplemented from itk::ProcessObject.

template<class TOutputVideoStream>
static Pointer itk::VideoSource< TOutputVideoStream >::New ( )
static
template<class TOutputVideoStream>
void itk::VideoSource< TOutputVideoStream >::operator= ( const Self )
private
template<class TOutputVideoStream>
virtual void itk::VideoSource< TOutputVideoStream >::PrintSelf ( std::ostream &  os,
Indent  indent 
) const
protectedvirtual
template<class TOutputVideoStream>
virtual int itk::VideoSource< TOutputVideoStream >::SplitRequestedSpatialRegion ( int  i,
int  num,
OutputFrameSpatialRegionType splitRegion 
)
protectedvirtual

This method functions like SplitRequestedRegion in ImageSource and is used by the implementation of TemporalStreamingGenerateData to dispatch threads that call ThreadedGenerateData.

template<class TOutputVideoStream>
virtual void itk::VideoSource< TOutputVideoStream >::TemporalStreamingGenerateData ( )
protectedvirtual

We override the default implementation of TemporalStreamingGenerateData from TemporalProcessObject to provide functionality for spatial streaming. This implementation works exactly the same way as the implementation of GenerateData in ImageSource. The filter-specific implementation of ThreadedGenerateData will be responsible of accessing the correct frames.

Reimplemented from itk::TemporalProcessObject.

Reimplemented in itk::VideoFileReader< TOutputVideoStream >, and itk::ImageFilterToVideoFilterWrapper< TImageToImageFilter >.

template<class TOutputVideoStream>
virtual void itk::VideoSource< TOutputVideoStream >::ThreadedGenerateData ( const OutputFrameSpatialRegionType outputRegionForThread,
int  threadId 
)
protectedvirtual

ThreadedGenerateData here serves the same symnatic purpose as ThreadedGenerateData in ProcessObjects that handle Images. This is to say that ThreadedGenerateData is in charge of performing a single algorithmic operation on a portion of the requested region. The difference will come in the implementation of each filter. Subclass implementations must access the passed spatial region across the desired number of frames in the buffered TemporalRegion of the input.

WARNING: subclasses may need to handle the case where different frames have different spatial dimensions and thus some frames may not be accessible at the requested spatial region.

Reimplemented in itk::FrameDifferenceVideoFilter< TInputVideoStream, TOutputVideoStream >, and itk::FrameAverageVideoFilter< TInputVideoStream, TOutputVideoStream >.

template<class TOutputVideoStream>
static ITK_THREAD_RETURN_TYPE itk::VideoSource< TOutputVideoStream >::ThreaderCallback ( void *  arg)
staticprotected

Static thread callback function for the MultiThreader. This gives control to ThreadedGenerateData().


Member Data Documentation

template<class TOutputVideoStream>
const unsigned int itk::VideoSource< TOutputVideoStream >::OutputFrameDimension = OutputFrameType::ImageDimension
static

Access the spacial dimensionality of the frames

Definition at line 74 of file itkVideoSource.h.


The documentation for this class was generated from the following file: