/usr/include/OTB-5.8/otbPointSetSource.h is in libotb-dev 5.8.0+dfsg-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 | /*=========================================================================
Program: ORFEO Toolbox
Language: C++
Date: $Date$
Version: $Revision$
Copyright (c) Centre National d'Etudes Spatiales. All rights reserved.
See OTBCopyright.txt for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notices for more information.
=========================================================================*/
#ifndef otbPointSetSource_h
#define otbPointSetSource_h
#include "itkProcessObject.h"
namespace otb
{
/** \class PointSetSource
* \brief Base class for all process objects that output point set data.
*
* PointSetSource is the base class for all process objects that output
* point set data. Specifically, this class defines the GetOutput() method
* that returns a pointer to the output point set. The class also defines
* some internal private data members that are used to manage streaming
* of data.
*
* \ingroup DataSources
*
* \ingroup OTBPointSet
*/
template <class TOutputPointSet>
class ITK_EXPORT PointSetSource : public itk::ProcessObject
{
public:
/** Standard class typedefs. */
typedef PointSetSource Self;
typedef itk::ProcessObject Superclass;
typedef itk::SmartPointer<Self> Pointer;
typedef itk::SmartPointer<const Self> ConstPointer;
/** Method for creation through the object factory. */
itkNewMacro(Self);
/** Run-time type information (and related methods). */
itkTypeMacro(PointSetSource, itk::ProcessObject);
/** Some convenient typedefs. */
typedef itk::ProcessObject::DataObjectPointerArraySizeType DataObjectPointerArraySizeType;
typedef itk::DataObject::Pointer DataObjectPointer;
typedef TOutputPointSet OutputPointSetType;
typedef typename OutputPointSetType::Pointer OutputPointSetPointer;
typedef typename OutputPointSetType::PointsContainer PointsContainerType;
typedef typename OutputPointSetType::PointDataContainer PointDataContainerType;
/** Get the point set output of this process object. */
OutputPointSetType * GetOutput(void);
OutputPointSetType * GetOutput(DataObjectPointerArraySizeType idx);
/** Set the point set output of this process object. This call is slated
* to be removed from ITK. You should GraftOutput() and possible
* DataObject::DisconnectPipeline() to properly change the output. */
void SetOutput(OutputPointSetType *output);
using Superclass::SetOutput;
/** Graft the specified DataObject onto this ProcessObject's output.
* This method grabs a handle to the specified DataObject's bulk
* data to used as its output's own bulk data. It also copies the
* region ivars (RequestedRegion, BufferedRegion,
* LargestPossibleRegion) and meta-data (Spacing, Origin) from the
* specified data object into this filter's output data object. Most
* importantly, however, it leaves the Source ivar untouched so the
* original pipeline routing is intact. This method is used when a
* process object is implemented using a mini-pipeline which is
* defined in its GenerateData() method. The usage is:
*
* \code
* // setup the mini-pipeline to process the input to this filter
* firstFilterInMiniPipeline->SetInput( this->GetInput() );
*
* // setup the mini-pipeline to calculate the correct regions
* // and write to the appropriate bulk data block
* lastFilterInMiniPipeline->GraftOutput( this->GetOutput() );
*
* // execute the mini-pipeline
* lastFilterInMiniPipeline->Update();
*
* // graft the mini-pipeline output back onto this filter's output.
* // this is needed to get the appropriate regions passed back.
* this->GraftOutput( lastFilterInMiniPipeline->GetOutput() );
* \endcode
*
* For proper pipeline execution, a filter using a mini-pipeline
* must implement the GenerateInputRequestedRegion(),
* GenerateOutputRequestedRegion(), GenerateOutputInformation() and
* EnlargeOutputRequestedRegion() methods as necessary to reflect
* how the mini-pipeline will execute (in other words, the outer
* filter's pipeline mechanism must be consistent with what the
* mini-pipeline will do). */
virtual void GraftOutput(itk::DataObject *output);
virtual void GraftNthOutput(DataObjectPointerArraySizeType idx, itk::DataObject *output);
/** 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
* SmartPointer to a DataObject. If a subclass of MeshSource has
* multiple outputs of different types, then that class must provide
* an implementation of MakeOutput(). */
DataObjectPointer MakeOutput(DataObjectPointerArraySizeType idx) ITK_OVERRIDE;
using Superclass::MakeOutput;
protected:
PointSetSource();
~PointSetSource() ITK_OVERRIDE {}
void PrintSelf(std::ostream& os, itk::Indent indent) const ITK_OVERRIDE;
/** Requested region of Point Set is specified as i of N unstructured regions.
* Since all DataObjects should be able to set the requested region in
* unstructured form, just copy output->RequestedRegion all inputs. */
void GenerateInputRequestedRegion() ITK_OVERRIDE;
private:
PointSetSource(const Self &); //purposely not implemented
void operator =(const Self&); //purposely not implemented
/** Used by streaming: The requested region of the output being processed
* by the execute method. Set in the GenerateInputRequestedRegion method. */
int m_GenerateDataRegion;
int m_GenerateDataNumberOfRegions;
};
} // end namespace otb
#ifndef OTB_MANUAL_INSTANTIATION
#include "otbPointSetSource.txx"
#endif
#endif
|