ImFusion C++ SDK 4.5.0
ImFusion::GlMedianFilter Class Reference

#include <ImFusion/GL/GlMedianFilter.h>

Median Filter. More...

Inheritance diagram for ImFusion::GlMedianFilter:

Detailed Description

Median Filter.

Note
The median filter performs a sorting of the pixel neighborhood and assigns the median pixel value to the center pixel.
In this implementation, an additional threshold can be defined and only pixels with a value below or above will be median filtered.
Adapted from http://graphics.cs.williams.edu/papers/MedianShaderX6/median.pix and http://graphics.cs.williams.edu/papers/MedianShaderX6/median5.pix

Public Types

enum  Submode {
  FILTER_PEPPER , FILTER_SALT , FILTER_SALT_PEPPER , FILTER_ALL ,
  NR_SUBMODES
}
 Filter submode. More...
Public Types inherited from ImFusion::Algorithm
enum  Status {
  Unknown = -1 , Success = 0 , Error = 1 , InvalidInput ,
  IncompleteInput , OutOfMemoryHost , OutOfMemoryGPU , UnsupportedGPU ,
  UnknownAction , AbortedByUser , User = 1000
}
 Status codes. More...

Public Member Functions

 GlMedianFilter (GL::Framebuffer *fbo=0)
bool setKernelSize (int size, double k) override
void setSubmode (int mode)
 Set the filter submode.
void compute (const GlImage &imgIn, GlImage &imgOut) override
 Execute the filter on the image.
bool good () const override
 Return true if the filter can be used, in particular if the shaders are available.
Public Member Functions inherited from ImFusion::GlFilter
 GlFilter (GL::Framebuffer *fbo=0)
 Constructor with optional FBO to use. If no FBO is specified a private FBO is created.
 ~GlFilter () override
 Destructor.
void compute () override
 Algorithm interface.
virtual bool setKernelSize (double, vec3, double)
 Common interface to set filter kernel size in mm and parameter.
virtual void compute (SharedImage &imgIn, SharedImage &imgOut)
virtual void compute (const std::vector< GlImage * > &imgIn, std::vector< GlImage * > &imgOut)
 Convenience function for executing filter on multiple images.
virtual void prepareForMasking (Mask *)
 Prepare the filter's GlProgram(s) for masking.
virtual bool supportsMetricMode () const
 Return true if the filter supports anisotropic spacing, i.e. metric.
void setMetricMode (bool value)
 If the GlFilter supports metric, i.e.
bool metricMode () const
 Getter for m_metricMode.
Public Member Functions inherited from ImFusion::Algorithm
 Algorithm ()
 Default constructor will registers a single "compute" action that calls compute() and returns status().
virtual OwningDataList takeOutput ()
 Return any new Data that was created by the Algorithm during the last call to compute().
virtual void setProgress (Progress *progress)
 Sets a Progress interface the algorithm can use to notify observers about its computing progress.
Progressprogress () const
 Returns the progress interface if set.
virtual int status () const
 Indicates the status of the last call to compute().
virtual bool survivesDataDeletion (const Data *) const
 Indicates whether the algorithm can handle (partial) deletion of the specified data, by default this checks whether the data is in the input list.
const FactoryInfofactoryInfo () const
 Returns the record describing how this Algorithm was instantiated by the AlgorithmFactory.
void setFactoryInfo (const FactoryInfo &value)
 Sets the record describing how this Algorithm was instantiated by the AlgorithmFactory.
Status runAction (const std::string &id)
 Run the action with name id if it exists.
const std::vector< Action > & actions ()
 Get a mapping from Action id to Action as registered in this algorithm.
Public Member Functions inherited from ImFusion::Configurable
virtual void configure (const Properties *p)
 Configure this object instance by de-serializing the given Properties.
virtual void configuration (Properties *p) const
 Serialize the current object configuration into the given Properties object.
virtual void configureDefaults ()
 Retrieve the properties of this object, replaces values with their defaults and sets it again.
void registerParameter (ParameterBase *param)
 Register the given Parameter or SubProperty, so that it will be configured during configure()/configuration().
void unregisterParameter (const ParameterBase *param)
 Remove the given Parameter or SubProperty from the list of registered parameters.
 Configurable (const Configurable &rhs)
 Configurable (Configurable &&rhs) noexcept
Configurable & operator= (const Configurable &)
Configurable & operator= (Configurable &&) noexcept

Protected Attributes

GL::ImageProgramm_program
int m_kernelSize
 Kernel size in pixels.
double m_threshold
 Discard pixels above/below the threshold and replace with mean of neighborhood.
int m_submode
 Filter submode.
Protected Attributes inherited from ImFusion::GlFilter
GL::Framebufferm_fbo
bool m_ownFbo
bool m_metricMode
 If set to true the GlFilter result will be computed taking the spacing into account.
Protected Attributes inherited from ImFusion::Algorithm
std::string m_name
 Algorithm name.
Progressm_progress = nullptr
 Non-owing pointer to a progress interface. May be a nullptr.
FactoryInfo m_factoryInfo = {}
 Record describing how this algorithm was instantiated by the AlgorithmFactory.
int m_status = Status::Unknown
 Algorithm status after last call to compute().
std::vector< Actionm_actions
 Map of key given by the id of the action, of the available actions of this algorithm.
Protected Attributes inherited from ImFusion::Configurable
std::vector< Paramm_params
 List of all registered Parameter and SubProperty instances.

Additional Inherited Members

Static Public Member Functions inherited from ImFusion::Algorithm
static bool createCompatible (const DataList &data, Algorithm **a=nullptr)
 Factory function to check algorithm compatibility with input data and optionally instantiate it.
Public Attributes inherited from ImFusion::Algorithm
Signal signalOutputChanged
 Signal should be emitted by Algorithms when their output/result has changed.
Signal signalParametersChanged
 Signal should be emitted by Algorithms when their parameter configuration has changed.
Public Attributes inherited from ImFusion::Configurable
Signal signalParametersChanged
 Emitted whenever one of the registered Parameters' or SubPropertys' signalValueChanged signal was emitted.
Protected Member Functions inherited from ImFusion::Algorithm
void loadDefaults ()
void registerAction (const std::string &id, const std::string &guiName, const std::function< Algorithm::Status(void)> &action)
 Register an action to be run via runAction.
template<typename D>
void registerAction (const std::string &id, const std::string &guiName, Algorithm::Status(D::*action)(void))
 Template version of runAction that can be used with a pointer to a member function.
void registerAction (const Action &action)
 Register an action.

Member Enumeration Documentation

◆ Submode

Filter submode.

Enumerator
FILTER_PEPPER 

Apply the filter only to dark pixels that lie beneath the threshold. E.g. for removal of 'dead' pixels.

FILTER_SALT 

Apply the filter only to bright pixels that lie above the threshold. E.g. for removal of overdriven pixels.

FILTER_ALL 

Apply the filter only to pixels when the absolute intensity difference to the neighborhood median pixel lies above the threshold.

The threshold value is multiplied by a factor of 0.1 in the shader. Apply the filter to entire image. Doesn't take threshold into account.

Member Function Documentation

◆ setKernelSize()

bool ImFusion::GlMedianFilter::setKernelSize ( int size,
double k )
overridevirtual
Parameters
sizeSize of quadratic kernel. Currently supported sizes are 3 and 5.
kThreshold value. Note that this is the slider value multiplied by 0.01
Warning
Filtering a 3D image using the 5x5x5 kernel is costly. Computation time is about 1min for a 512^3 image.

Reimplemented from ImFusion::GlFilter.

◆ compute()

void ImFusion::GlMedianFilter::compute ( const GlImage & imgIn,
GlImage & imgOut )
overridevirtual

Execute the filter on the image.

Implements ImFusion::GlFilter.

◆ good()

bool ImFusion::GlMedianFilter::good ( ) const
overridevirtual

Return true if the filter can be used, in particular if the shaders are available.

Implements ImFusion::GlFilter.

Member Data Documentation

◆ m_kernelSize

int ImFusion::GlMedianFilter::m_kernelSize
protected

Kernel size in pixels.

Note
Default values for GUI elements representing these member variables are set in GlFilterSet::initParamInfo().

The documentation for this class was generated from the following file:
  • ImFusion/GL/GlMedianFilter.h
Search Tab / S to search, Esc to close