#include <ImFusion/GL/IntensityMask.h>

Masks pixels with a specific value or values outside a specific range. More...

Inheritance diagram for IntensityMask:

Detailed Description

Masks pixels with a specific value or values outside a specific range.

This mask type can work in two modes: either it considers only a single value as masked (default) or you can enabled a ranged mode where all pixel values outside a configured value range are considered as masked. Therefore, during mask query it requires the actual pixel value as input. However, comparison against the configured mask value (range) is only performed on the first channel and all other channels are ignored if present.

Note: The intensity values used during masking (i.e. when calling maskValue()) are compared to the exact same values set during setMaskedValue() or setMaskValueRange(), respectively. In other words: there is no shift/scale transformation involved.

Public Member Functions
	IntensityMask (PixelType type, float value=0.0f)
	Creates a new IntensityMask in single-value mode (i.e. `isUsingRange() == false`).

	IntensityMask (Image::Type type, float value=0.0f)

	IntensityMask (const Image &image, float value=0.0f)

PixelType	type () const
	Pixel value type of this mask.

void	setUseRange (bool enable)
	Configure whether the mask should operate in range mode (true) or single-value mode (false).

bool	isUsingRange () const

void	setMaskedValue (float v)
	Sets a specific pixel value that should be ignored.

float	maskedValue () const

void	setMaskValueRange (float min, float max)
	Sets a half open range `[min, max)` of allowed pixel values.

void	maskValueRange (float &min, float &max) const

void	configure (const Properties *p) override
	Configure this object instance by de-serializing the given Properties.

void	configuration (Properties *p) const override
	Serialize the current object configuration into the given Properties object.

uint8_t	maskValue (const vec3i &coord, const vec4f &color) const override
	Returns 0 if the given pixel is outside the mask (i.e.

bool	isCompatible (const SharedImage *image) const override
	Returns `true` if the mask can be used with the given image or `false` otherwise.

bool	requiresPixelValue () const override
	Returns true if the maskValue() rely on the pixel value.

std::unique_ptr< Mask >	resizedMask (const SharedImage &original, const Image &target) const override
	Creates a copy of the current mask, resized to the dimensions of the target image.

int	setIncludeArguments (GL::Program &p, const std::string &prefix="mask") const override
	Called by users of GlMask in order to correctly setup the mask shader.

GlMask *	glMask () override
	Returns the OpenGL-based implementation of the mask interface if available.

uint8_t	maskValue (const vec3i &coord, float value=-1.0f) const
	Convenience overload that calls `maskValue(coord, vec4f(value, value, value, 1.0f))`.

Public Member Functions inherited from Mask
uint8_t	maskValue (const vec3i &coord, float value=-1.0f) const
	Convenience overload that calls `maskValue(coord, vec4f(value, value, value, 1.0f))`.

virtual std::unique_ptr< TypedImage< uint8_t > >	createExplicitMask (const SharedImage &image, CreateOption createOption=CreateOption::DeepCopy) const
	Creates an explicit mask representation of this mask for a given image.

Public Member Functions inherited from Configurable
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

Public Member Functions inherited from GlMask
	GlMask (const std::string &includePath)
	Instantiates a new GL::AbstractInclude using `IMAGE_MASK` as defineName and the given path the to retrieve the GLSL source code from.

virtual std::unique_ptr< GlImage >	createExplicitMaskGl (const GlImage &inputImage, bool normalized=false)
	Creates an explicit mask representation of this mask when applied to the given image.

Public Member Functions inherited from AbstractInclude
	AbstractInclude (const std::string &defineName, const std::string &includePath)
	Creates a AbstractInclude for the given define and with the corresponding GLSL file at includePath.

const std::string &	defineName () const
	Returns the name of define used by this include.

const std::string &	includePath () const
	Returns the path to the included shader file.

virtual std::function< std::string(const std::string &)>	includeCodeSubstitution () const
	Optionally the abstract include can provide a function to change the shader code.

virtual std::vector< AbstractInclude * >	dependentIncludes () const
	Returns a list of dependent abstract includes that need to be included as well.

virtual Fingerprint	fingerprint () const
	Provides a finger print of the include.

Public Member Functions inherited from MultiIncludable< GlMask >
std::shared_ptr< MultiIncludeType >	createMultiInclude (const std::string &replacementToken)
	Instantiates a new AbstractInclude instance where all occurrences of baseToken provided during construction are replaces with replacementToken according to the specified replacementScheme.

virtual int	setIncludeArguments (Program &prog, IncludeArgumentsTypes... includeArgs, const std::string &token) const=0
	Interface that multi includes should use to configure the shader include (such as setting uniforms, binding textures, etc).

Additional Inherited Members
Public Types inherited from Mask
enum class	CreateOption { DeepCopy , ShallowCopyIfPossible }
	Enumeration of available behavior for createExplicitMask() More...

Public Types inherited from MultiIncludable< GlMask >
using	MultiIncludeType
	Alias for type of a multi-include instance of the original include.

Static Public Member Functions inherited from GlMask
static std::string	defineName ()
	Returns "IMAGE_MASK".

static std::string	defineSuffix ()
	Returns "MASK".

static std::string	multiIncludeDefine (const std::string &replacementToken)
	Returns `"IMAGE_" + toUpper(replacementToken)`

Public Attributes inherited from Configurable
Signal	signalParametersChanged
	Emitted whenever one of the registered Parameters' or SubPropertys' `signalValueChanged` signal was emitted.

Protected Member Functions inherited from MultiIncludable< GlMask >
	MultiIncludable (GlMask *crtpInstance, const std::string &baseToken, Flags< ShaderTextReplacement > replacementScheme)
	Instantiate and configure the MultiIncludable interface.

Protected Attributes inherited from Configurable
std::vector< Param >	m_params
	List of all registered Parameter and SubProperty instances.

Member Function Documentation

◆ setUseRange()

void setUseRange ( bool enable )

Configure whether the mask should operate in range mode (true) or single-value mode (false).

Depending on the mode use setMaskedValue() or setMaskValueRange() to configure the thresholds.

◆ setMaskedValue()

void setMaskedValue ( float v )

Sets a specific pixel value that should be ignored.

The value should be given in storage domain of the type of the mask.

Note: Make sure to also call setUseRange(false) to enable single-value mode.

◆ setMaskValueRange()

void setMaskValueRange	(	float	min,
		float	max )

Sets a half open range [min, max) of allowed pixel values.

Values outside this range will be masked (i.e. considered outside). The values should be given in storage domain of the type of the mask.

Note: Make sure to also call setUseRange(true) to enable ranged mode.

◆ configure()

void configure ( const Properties * p )

overridevirtual

Configure this object instance by de-serializing the given Properties.

The default implementation will do so automatically for all registered Parameter and SubProperty instances.

See also: configuration() for the inverse functionality

Reimplemented from Configurable.

◆ configuration()

void configuration ( Properties * p ) const

overridevirtual

Serialize the current object configuration into the given Properties object.

The default implementation will do so automatically for all registered Parameter and SubProperty instances.

See also: configure() for the inverse functionality

Reimplemented from Configurable.

◆ maskValue()

uint8_t maskValue	(	const vec3i &	coord,
		const vec4f &	color ) const

overridevirtual

Returns 0 if the given pixel is outside the mask (i.e.

invisible/to be ignored) or a non-zero value if it is inside the mask (i.e. visible/to be considered).

This function takes both the pixel coordinate and pixel value as input. Concrete implementations of the Mask interface are free to use only either input for their decision if it makes sense. Also, it is up to the implementation whether it supports multi-channel images or not. Subclasses only supporting grayscale images should only use the first channel.

Parameters

coord	Pixel coordinate to be tested against the mask, can be outside of the image.
color	Pixel value (not normalized) to be tested against the mask. This parameter is only needed if requiresPixelValue() returns `true`, which can allow for optimizations where pixel lookup is expensive.

Implements Mask.

◆ isCompatible()

bool isCompatible ( const SharedImage * image ) const

overridevirtual

Returns true if the mask can be used with the given image or false otherwise.

Implements Mask.

◆ requiresPixelValue()

bool requiresPixelValue ( ) const

overridevirtual

Returns true if the maskValue() rely on the pixel value.

If this method returns false, the maskValue() method can be safely used with only the coordinate. This is useful to avoid an otherwise unnecessary and expensive pixel lookup.

Implements Mask.

◆ resizedMask()

std::unique_ptr< Mask > resizedMask	(	const SharedImage &	original,
		const Image &	target ) const

overridevirtual

Creates a copy of the current mask, resized to the dimensions of the target image.

The default implementation calls createExplicitMask and resamples the result. Returns nullptr if the mask cannot be resized.

Reimplemented from Mask.

◆ setIncludeArguments()

int setIncludeArguments	(	GL::Program &	p,
		const std::string &	prefix = "mask" ) const

overridevirtual

Called by users of GlMask in order to correctly setup the mask shader.

Subclasses should implement this function so that it correctly sets all needed uniforms and input textures to be used by the OpenGL shader instance. Make sure to use the given prefix argument instead of a hardcoded "mask" when defining uniform names to support multi-includes where the prefixes have been replaced with unique alternatives. Example:

p.setArgument(prefix + "UseRange", m_useRange);

Implements GlMask.

◆ glMask()

GlMask * glMask ( )

overridevirtual

Returns the OpenGL-based implementation of the mask interface if available.

This function may return nullptr if this is not implemented (default).

Reimplemented from Mask.

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

ImFusion/GL/IntensityMask.h

Detailed Description

Public Member Functions

Additional Inherited Members

Member Function Documentation

◆ setUseRange()

◆ setMaskedValue()

◆ setMaskValueRange()

◆ configure()

◆ configuration()

◆ maskValue()

◆ isCompatible()

◆ requiresPixelValue()

◆ resizedMask()

◆ setIncludeArguments()

◆ glMask()