#include <ImFusion/GL/SkippingMask.h>

Basic mask where only every N-th pixel is considered inside. More...

Inheritance diagram for SkippingMask:

Detailed Description

Basic mask where only every N-th pixel is considered inside.

This is configured through the skip parameter. Only those pixels are considered inside where for each dimension the following holds true: pixelCoord % (skip + 1) == 0.

Public Member Functions
	SkippingMask (const vec3i &imageDimensions, const vec3i &skip)
	Construct the mask with image pixel dimensions.

void	setSkip (const vec3i &skip)
	Sets which pixels should be inside.

vec3i	skip () 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.

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.

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.

virtual std::unique_ptr< Mask >	resizedMask (const SharedImage &original, const Image &target) const
	Creates a copy of the current mask, resized to the dimensions of the target 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.

Constructor & Destructor Documentation

◆ SkippingMask()

SkippingMask	(	const vec3i &	imageDimensions,
		const vec3i &	skip )

Construct the mask with image pixel dimensions.

Parameters

imageDimensions	Number of pixels of the mask pixel grid
skip	Number of pixels that should be skipped in each direction.

Member Function Documentation

◆ setSkip()

void setSkip ( const vec3i & skip )

Sets which pixels should be inside.

Only those pixels are considered inside where for each dimension the following holds true: pixelCoord % (skip + 1) == 0.

◆ 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.

◆ 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/SkippingMask.h

Detailed Description

Public Member Functions

Additional Inherited Members

Constructor & Destructor Documentation

◆ SkippingMask()

Member Function Documentation

◆ setSkip()

◆ configure()

◆ configuration()

◆ maskValue()

◆ isCompatible()

◆ requiresPixelValue()

◆ setIncludeArguments()

◆ glMask()