ITK
6.0.0
Insight Toolkit
|
#include <itkUnsharpMaskImageFilter.h>
Edge enhancement filter.
This filter subtracts a smoothed version of the image from the image to achieve the edge enhancing effect. https://en.wikipedia.org/w/index.php?title=Unsharp_masking&oldid=750486803#Photographic_unsharp_masking
It has configurable amount, radius (sigma) and threshold, and whether to clamp the resulting values to the range of output type.
Formula: sharpened=original+[itk::Math::abs(original-blurred)-threshold]*amount
If clamping is turned off (it is on by default), casting to output pixel format is done using C++ defaults, meaning that values are not clamped but rather wrap around e.g. 260 -> 4 (unsigned char).
Definition at line 55 of file itkUnsharpMaskImageFilter.h.
Classes | |
class | UnsharpMaskingFunctor |
Public Member Functions | |
const char * | GetNameOfClass () const override |
virtual void | SetSigmas (SigmaArrayType _arg) |
virtual SigmaArrayType | GetSigmas () const |
void | SetSigma (const typename SigmaArrayType::ValueType sigma) |
virtual void | SetAmount (TInternalPrecision _arg) |
virtual TInternalPrecision | GetAmount () const |
virtual void | SetThreshold (TInternalPrecision _arg) |
virtual TInternalPrecision | GetThreshold () const |
virtual void | SetClamp (bool _arg) |
virtual bool | GetClamp () const |
virtual void | ClampOn () |
Public Member Functions inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
const InputImageType * | GetInput () const |
const InputImageType * | GetInput (unsigned int idx) const |
void | PopBackInput () override |
void | PopFrontInput () override |
virtual void | PushBackInput (const InputImageType *input) |
virtual void | PushFrontInput (const InputImageType *input) |
virtual void | SetInput (const DataObjectIdentifierType &key, DataObject *input) |
virtual void | SetInput (const InputImageType *input) |
virtual void | SetInput (unsigned int, const TInputImage *image) |
virtual void | SetCoordinateTolerance (double _arg) |
virtual double | GetCoordinateTolerance () const |
virtual void | SetDirectionTolerance (double _arg) |
virtual double | GetDirectionTolerance () const |
Public Member Functions inherited from itk::ImageSource< TOutputImage > | |
OutputImageType * | GetOutput (unsigned int idx) |
OutputImageType * | GetOutput () |
const OutputImageType * | GetOutput () const |
virtual void | GraftOutput (DataObject *graft) |
virtual void | GraftOutput (const DataObjectIdentifierType &key, DataObject *graft) |
virtual void | GraftNthOutput (unsigned int idx, DataObject *graft) |
ProcessObject::DataObjectPointer | MakeOutput (ProcessObject::DataObjectPointerArraySizeType idx) override |
ProcessObject::DataObjectPointer | MakeOutput (const ProcessObject::DataObjectIdentifierType &) override |
Public Member Functions inherited from itk::ProcessObject | |
virtual void | AbortGenerateDataOn () |
virtual void | EnlargeOutputRequestedRegion (DataObject *) |
virtual const bool & | GetAbortGenerateData () const |
DataObjectPointerArray | GetIndexedInputs () |
DataObjectPointerArray | GetIndexedOutputs () |
NameArray | GetInputNames () const |
DataObjectPointerArray | GetInputs () |
MultiThreaderType * | GetMultiThreader () const |
DataObjectPointerArraySizeType | GetNumberOfIndexedInputs () const |
DataObjectPointerArraySizeType | GetNumberOfIndexedOutputs () const |
DataObjectPointerArraySizeType | GetNumberOfInputs () const |
DataObjectPointerArraySizeType | GetNumberOfOutputs () const |
virtual DataObjectPointerArraySizeType | GetNumberOfValidRequiredInputs () const |
NameArray | GetOutputNames () const |
DataObjectPointerArray | GetOutputs () |
virtual float | GetProgress () const |
NameArray | GetRequiredInputNames () const |
bool | HasInput (const DataObjectIdentifierType &key) const |
bool | HasOutput (const DataObjectIdentifierType &key) const |
void | IncrementProgress (float increment) |
virtual void | PrepareOutputs () |
virtual void | PropagateRequestedRegion (DataObject *output) |
virtual void | ResetPipeline () |
virtual void | SetAbortGenerateData (bool _arg) |
void | SetMultiThreader (MultiThreaderType *threader) |
virtual void | Update () |
virtual void | UpdateLargestPossibleRegion () |
virtual void | UpdateOutputData (DataObject *output) |
virtual void | UpdateOutputInformation () |
void | UpdateProgress (float progress) |
virtual void | SetReleaseDataFlag (bool val) |
virtual bool | GetReleaseDataFlag () const |
void | ReleaseDataFlagOn () |
void | ReleaseDataFlagOff () |
virtual void | SetReleaseDataBeforeUpdateFlag (bool _arg) |
virtual const bool & | GetReleaseDataBeforeUpdateFlag () const |
virtual void | ReleaseDataBeforeUpdateFlagOn () |
virtual void | SetNumberOfWorkUnits (ThreadIdType _arg) |
virtual const ThreadIdType & | GetNumberOfWorkUnits () const |
Public Member Functions inherited from itk::Object | |
unsigned long | AddObserver (const EventObject &event, Command *cmd) const |
unsigned long | AddObserver (const EventObject &event, std::function< void(const EventObject &)> function) const |
LightObject::Pointer | CreateAnother () const override |
virtual void | DebugOff () const |
virtual void | DebugOn () const |
Command * | GetCommand (unsigned long tag) |
bool | GetDebug () const |
MetaDataDictionary & | GetMetaDataDictionary () |
const MetaDataDictionary & | GetMetaDataDictionary () const |
virtual ModifiedTimeType | GetMTime () const |
virtual const TimeStamp & | GetTimeStamp () const |
bool | HasObserver (const EventObject &event) const |
void | InvokeEvent (const EventObject &) |
void | InvokeEvent (const EventObject &) const |
virtual void | Modified () const |
void | Register () const override |
void | RemoveAllObservers () |
void | RemoveObserver (unsigned long tag) const |
void | SetDebug (bool debugFlag) const |
void | SetReferenceCount (int) override |
void | UnRegister () const noexcept override |
void | SetMetaDataDictionary (const MetaDataDictionary &rhs) |
void | SetMetaDataDictionary (MetaDataDictionary &&rrhs) |
virtual void | SetObjectName (std::string _arg) |
virtual const std::string & | GetObjectName () const |
Public Member Functions inherited from itk::LightObject | |
Pointer | Clone () const |
virtual void | Delete () |
virtual int | GetReferenceCount () const |
void | Print (std::ostream &os, Indent indent=0) const |
Static Public Member Functions | |
static Pointer | New () |
Static Public Member Functions inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
static double | GetGlobalDefaultCoordinateTolerance () |
static double | GetGlobalDefaultDirectionTolerance () |
static void | SetGlobalDefaultCoordinateTolerance (double) |
static void | SetGlobalDefaultDirectionTolerance (double) |
Static Public Member Functions inherited from itk::Object | |
static bool | GetGlobalWarningDisplay () |
static void | GlobalWarningDisplayOff () |
static void | GlobalWarningDisplayOn () |
static Pointer | New () |
static void | SetGlobalWarningDisplay (bool val) |
Static Public Member Functions inherited from itk::LightObject | |
static void | BreakOnError () |
static Pointer | New () |
Static Public Attributes | |
static constexpr unsigned int | ImageDimension = TOutputImage::ImageDimension |
static constexpr unsigned int | InputImageDimension = TInputImage::ImageDimension |
Static Public Attributes inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
static constexpr unsigned int | InputImageDimension = TInputImage::ImageDimension |
static constexpr unsigned int | OutputImageDimension = TOutputImage::ImageDimension |
Static Public Attributes inherited from itk::ImageSource< TOutputImage > | |
static constexpr unsigned int | OutputImageDimension = TOutputImage::ImageDimension |
Private Attributes | |
TInternalPrecision | m_Amount {} |
bool | m_Clamp {} |
SigmaArrayType | m_Sigmas {} |
TInternalPrecision | m_Threshold {} |
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::ConstPointer = SmartPointer<const Self> |
Definition at line 91 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::GaussianType = SmoothingRecursiveGaussianImageFilter<TInputImage, Image<TInternalPrecision, TOutputImage::ImageDimension> > |
Definition at line 110 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::InputImagePointer = typename InputImageType::Pointer |
Definition at line 83 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::InputImageRegionType = typename TInputImage::RegionType |
Definition at line 74 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::InputImageType = TInputImage |
Image type alias support
Definition at line 81 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::InputInternalPixelType = typename TInputImage::InternalPixelType |
Definition at line 72 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::InputPixelType = typename TInputImage::PixelType |
Definition at line 71 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::InternalPrecisionType = TInternalPrecision |
Definition at line 85 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::OutputImageRegionType = typename TOutputImage::RegionType |
Definition at line 73 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::OutputImageType = TOutputImage |
Definition at line 82 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::OutputInternalPixelType = typename TOutputImage::InternalPixelType |
Definition at line 70 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::OutputPixelType = typename TOutputImage::PixelType |
Extract some information from the image types.
Definition at line 69 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::Pointer = SmartPointer<Self> |
Smart pointer type alias support
Definition at line 90 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::Self = UnsharpMaskImageFilter |
Standard "Self" & Superclass type alias.
Definition at line 63 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::SigmaArrayType = typename GaussianType::SigmaArrayType |
Definition at line 112 of file itkUnsharpMaskImageFilter.h.
using itk::UnsharpMaskImageFilter< TInputImage, TOutputImage, TInternalPrecision >::Superclass = ImageToImageFilter<TInputImage, TOutputImage> |
Definition at line 64 of file itkUnsharpMaskImageFilter.h.
|
protected |
|
overrideprotecteddefault |
|
virtual |
Set/Get whether to clamp values to supported range of output type. Default: On.
|
overrideprotectedvirtual |
A version of GenerateData() specific for image processing filters. This implementation will split the processing across multiple threads. The buffer is allocated by this method. Then the BeforeThreadedGenerateData() method is called (if provided). Then, a series of threads are spawned each calling DynamicThreadedGenerateData(). After all the threads have completed processing, the AfterThreadedGenerateData() method is called (if provided). If an image processing filter cannot be threaded, the filter should provide an implementation of GenerateData(). That implementation is responsible for allocating the output buffer. If a filter can be threaded, it should NOT provide a GenerateData() method but should provide a DynamicThreadedGenerateData() instead.
Reimplemented from itk::ImageSource< TOutputImage >.
|
overrideprotectedvirtual |
UnsharpMaskImageFilter needs a larger input requested region than the output requested region (larger by the size of the Gaussian kernel). As such, UnsharpMaskImageFilter needs to provide an implementation for GenerateInputRequestedRegion() in order to inform the pipeline execution model.
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
|
virtual |
Set/Get amount of enhancement. Usual range: 0.1 to 2.0. Default: 0.5.
|
virtual |
Set/Get whether to clamp values to supported range of output type. Default: On.
|
overridevirtual |
Run-time type information (and related methods)
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
|
virtual |
Set/Get Sigma values measured in the units of image spacing. Default: 1.0.
|
virtual |
Set/Get threshold for enhancement. Default: 0.
|
static |
Method for creation through the object factory.
|
overrideprotectedvirtual |
Methods invoked by Print() to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
|
virtual |
Set/Get amount of enhancement. Usual range: 0.1 to 2.0. Default: 0.5.
|
virtual |
Set/Get whether to clamp values to supported range of output type. Default: On.
|
inline |
Convenience method for setting all dimensional parameters to the same values.
Definition at line 122 of file itkUnsharpMaskImageFilter.h.
|
virtual |
Set/Get Sigma values measured in the units of image spacing. Default: 1.0.
|
virtual |
Set/Get threshold for enhancement. Default: 0.
|
overrideprotectedvirtual |
Verifies that the process object has been configured correctly, that all required inputs are set, and needed parameters are set appropriately. If not valid an exceptions will be thrown.
This method is called before UpdateOutputInformation() is propagated to the inputs.
The ProcessObject's implementation verifies that the m_NumberOfRequiredInputs are set and not null.
Reimplemented from itk::ProcessObject.
|
staticconstexpr |
Definition at line 75 of file itkUnsharpMaskImageFilter.h.
|
staticconstexpr |
Definition at line 76 of file itkUnsharpMaskImageFilter.h.
|
private |
The edge amplification amount
Definition at line 171 of file itkUnsharpMaskImageFilter.h.
|
private |
Definition at line 174 of file itkUnsharpMaskImageFilter.h.
|
private |
Definition at line 173 of file itkUnsharpMaskImageFilter.h.
|
private |
Definition at line 172 of file itkUnsharpMaskImageFilter.h.