Description

VuoImageConvolve interface.

Copyright: Copyright © 2012–2021 Kosada Incorporated. This code may be modified and distributed under the terms of the MIT License. For more information, see https://vuo.org/license.

Typedefs
typedef void *	VuoImageConvolve
	State data for the image Convolverer. More...

typedef double(*	VuoImageConvolveFunction) (double x, double y, double param)
	A function that can be passed to VuoImageConvolve_generateMatrix. More...

Functions
VuoImageConvolve	VuoImageConvolve_make (void)
	Creates state data for the image Convolverer. More...

VuoImage	VuoImageConvolve_convolve (VuoImageConvolve convolve, VuoImage image, VuoImage convolutionMatrix, VuoThresholdType channels, double intensity, double threshold, VuoDiode range)
	Returns a convolved copy of image. More...

double	VuoImageConvolve_laplacianOfGaussian (double x, double y, double radius)
	Returns the (0,0)-centered Laplacian-of-Gaussian function at the given position and sigma. More...

unsigned int	VuoImageConvolve_laplacianOfGaussianWidth (double sigma)
	Returns a recommended matrix width for VuoImageConvolve_laplacianOfGaussian. More...

VuoImage	VuoImageConvolve_generateMatrix (VuoImageConvolveFunction f, unsigned int width, bool removeDCOffset, double param)
	Returns an image containing a set of (unnormalized) weights for the specified function. More...

Typedef Documentation

◆ VuoImageConvolve

typedef void* VuoImageConvolve

State data for the image Convolverer.

Definition at line 20 of file VuoImageConvolve.h.

◆ VuoImageConvolveFunction

typedef double(* VuoImageConvolveFunction) (double x, double y, double param)

A function that can be passed to VuoImageConvolve_generateMatrix.

Definition at line 26 of file VuoImageConvolve.h.

Function Documentation

◆ VuoImageConvolve_convolve()

VuoImage VuoImageConvolve_convolve	(	VuoImageConvolve	convolve,
		VuoImage	image,
		VuoImage	convolutionMatrix,
		VuoThresholdType	channels,
		double	intensity,
		double	threshold,
		VuoDiode	range
	)

Returns a convolved copy of image.

(Or, if radius is zero, returns image.)

convolutionMatrix must be square and have odd width/height.

Definition at line 199 of file VuoImageConvolve.c.

◆ VuoImageConvolve_generateMatrix()

VuoImage VuoImageConvolve_generateMatrix	(	VuoImageConvolveFunction	f,
		unsigned int	width,
		bool	removeDCOffset,
		double	param
	)

Returns an image containing a set of (unnormalized) weights for the specified function.

Definition at line 80 of file VuoImageConvolve.c.

◆ VuoImageConvolve_laplacianOfGaussian()

double VuoImageConvolve_laplacianOfGaussian	(	double	x,
		double	y,
		double	radius
	)

Returns the (0,0)-centered Laplacian-of-Gaussian function at the given position and sigma.

(This is the continuous version of the function, but we make up for it by normalizing and removing the DC offset in VuoImageConvolve_generateMatrix.)

Definition at line 50 of file VuoImageConvolve.c.

◆ VuoImageConvolve_laplacianOfGaussianWidth()

unsigned int VuoImageConvolve_laplacianOfGaussianWidth ( double sigma )

Returns a recommended matrix width for VuoImageConvolve_laplacianOfGaussian.

Definition at line 63 of file VuoImageConvolve.c.

◆ VuoImageConvolve_make()

VuoImageConvolve VuoImageConvolve_make ( void )

Creates state data for the image Convolverer.

Definition at line 125 of file VuoImageConvolve.c.