libvips/man/im_andimage.3
2007-08-31 13:01:42 +00:00

92 lines
1.6 KiB
Groff

.TH IM_ANDIMAGE 3 "30 October 1992"
.SH NAME
im_andimage, im_andconst, im_and_vec, im_orimage, im_orconst, im_or_vec,
im_eorimage, im_eorconst, im_eor_vec \- boolean
operations on unsigned char images
.SH SYNOPSIS
.B #include <vips/vips.h>
.B int im_andimage(a, b, out)
.br
.B IMAGE *a, *b, *out;
.B int im_andconst(a, out, c)
.br
.B IMAGE *a, *out;
.br
.B double c;
.B int im_and_vec(a, out, n, v)
.br
.B IMAGE *a, *out;
.br
.B int n;
.br
.B double *v;
.B int im_orimage(a, b, out)
.br
.B IMAGE *a, *b, *out;
.B int im_orconst(a, out, c)
.br
.B IMAGE *a, *out;
.br
.B double c;
.B int im_or_vec(a, out, n, v)
.br
.B IMAGE *a, *out;
.br
.B int n;
.br
.B double *v;
.B int im_eorimage(a, b, out)
.br
.B IMAGE *a, *b, *out;
.B int im_eorconst(a, out, c)
.br
.B IMAGE *a, *out;
.br
.B double c;
.B int im_eor_vec(a, out, n, v)
.br
.B IMAGE *a, *out;
.br
.B int n;
.br
.B double *v;
.SH DESCRIPTION
Perform bitwise logical operations on integer images.
.B im_andimage(3)
performs bitwise and between corresponding pixels in a and b, writing the
result to out. Both images must be the same size and have the same number
of bands. They can have any integer type.
.B im_andconst(3)
performs bitwise and between pixels in a and a single
constant value.
.B im_and_vec(3)
lets you specify n constants, one per band.
.B im_orimage(3)
and
.B im_eorimage(3)
behave similarly. Use im_eorconst( in, out, -1 ) or
.B im_invert(3)
as a not operator.
.SH RETURN VALUE
All functions return 0 on success and -1 on error.
.SH SEE ALSO
im_ifthenelse(3), im_equal(3).
.SH COPYRIGHT
National Gallery, 1992
.SH AUTHOR
J. Cupitt