libvips/man/im_log_imask.3

57 lines
1.6 KiB
Groff

.TH LOG_MASKS 3 "6 December 1991"
.SH NAME
im_log_dmask, im_log_imask \- create a laplacian of gaussian (log)
DOUBLEMASK or INTMASK
.SH SYNOPSIS
.B
#include <vips/vips.h>
.B DOUBLEMASK *im_log_dmask( name, sigma, min_amplitude )
.br
char *name;
.br
double sigma, min_amplitude;
.B INTMASK *im_log_imask( name, sigma, min_amplitude )
.br
char *name;
.br
double sigma, min_amplitude;
.SH DESCRIPTION
Both functions create a circularly symmetric laplacian of Gaussian mask. The
size of the mask is determined by the variable min_amplitude; if for instance
the value .1 is entered this means that the produced mask is clipped at values
within 10 persent of zero, and where the change between mask elements is less
than 10%.
The mask can be directly used with the vasari convolution
programs, the default offset set is 0.
The program uses the following equation: (from Handbook of Pattern Recognition
and image processing by Young and Fu, AP 1986 pages 220-221):
H(r) = (1 / (2 * M_PI * s4)) *
(2 - (r2 / s2)) *
exp(-r2 / (2 * s2))
where s2 = sigma * sigma, s4=s2 * s2, r2 = r * r. The generated mask has odd
size and its
maximum value is normalised to either 100 (log_imask) or to 1.0 (log_dmask)
.B im_log_dmask()
creates a DOUBLEMASK laplacian of Gaussian mask with maximum value normalised
to 1.0.
.B im_log_imask()
creates a INTMASK laplacian of Gaussian mask with maximum value normalised
to 100.
.SH RETURNED VALUE:
The functions return NULL on erorr.
.SH SEE ALSO
im_gauss_dmask(3), im_conv(3)
.SH COPYRIGHT
.br
N. Dessipris
.SH AUTHOR
N. Dessipris \- 06/12/1991