Binary Image Operations
[Image Package]

Functions
Gan_Bool	gan_image_bit_get_pix_4group (const Gan_Image *image, unsigned row, unsigned col)
	Test local group of four binary pixels.
Gan_Bool	gan_image_bit_get_pix_5group (const Gan_Image *image, unsigned row, unsigned col)
	Test local group of five binary pixels.
Gan_Bool	gan_image_bit_get_pix_9group (const Gan_Image *image, unsigned row, unsigned col)
	Test local group of nine binary pixels.
Gan_Bool	gan_image_bit_get_pix_3group_horiz (const Gan_Image *image, unsigned row, unsigned col)
	Test local group of three binary pixels in a row.
Gan_Bool	gan_image_bit_get_pix_3group_vert (const Gan_Image *image, unsigned row, unsigned col)
	Test local group of three binary pixels in a column.
int	gan_image_get_pixel_count_b (const Gan_Image *image, Gan_Bool val, const Gan_ImageWindow *psubwin)
	Returns number of pixels set or unset in the given binary image.
Gan_Image *	gan_image_bit_invert_q (Gan_Image *image, Gan_Image *result_image)
	Invert binary image.
Gan_Image *	gan_image_bit_and_q (Gan_Image *image1, Gan_Image *image2, Gan_Image *result)
	Binary AND of all pixels in a binary image.
Gan_Image *	gan_image_bit_nand_q (Gan_Image *image1, Gan_Image *image2, Gan_Image *result)
	Binary NAND of all pixels in a binary image.
Gan_Image *	gan_image_bit_or_q (Gan_Image *image1, Gan_Image *image2, Gan_Image *result)
	Binary OR of all pixels in a binary image.
Gan_Image *	gan_image_bit_eor_q (Gan_Image *image1, Gan_Image *image2, Gan_Image *result)
	Binary EOR of all pixels in a binary image.
Gan_Image *	gan_image_bit_andnot_q (Gan_Image *image1, Gan_Image *image2, Gan_Image *result)
	Binary AND-NOT of all pixels in a binary image.
Gan_Bool	gan_image_bit_fill_row (Gan_Image *image, unsigned y, unsigned x, unsigned width, Gan_Bool pix)
	Fill part of a row of a binary image.
Gan_Bool	gan_image_bit_invert_row (Gan_Image *image, unsigned y, unsigned x, unsigned width)
	Invert part of a row of a binary image.
Gan_Bool	gan_image_bit_dilate_horiz (Gan_Image *image, int no_pixels, Gan_Image *restrict_mask)
	Dilate binary image horizontally.
Gan_Bool	gan_image_bit_dilate_vert (Gan_Image *image, int no_pixels, Gan_Image *restrict_mask)
	Dilate binary image vertically.
Gan_Bool	gan_image_bit_shift (const Gan_Image *image, int vshift, int hshift, Gan_Image *result_image)
	Shift binary image horizontally and vertically.
Gan_Image *	gan_image_bit_invert_s (Gan_Image *image)
	Macro: Invert binary image.
Gan_Image *	gan_image_bit_invert_i (Gan_Image *image)
	Macro: Invert binary image.
Gan_Image *	gan_image_bit_and_s (Gan_Image *image1, Gan_Image *image2)
	Binary AND of all pixels in a binary image.
Gan_Image *	gan_image_bit_nand_s (Gan_Image *image1, Gan_Image *image2)
	Binary NAND of all pixels in a binary image.
Gan_Image *	gan_image_bit_or_s (Gan_Image *image1, Gan_Image *image2)
	Binary OR of all pixels in a binary image.
Gan_Image *	gan_image_bit_eor_s (Gan_Image *image1, Gan_Image *image2)
	Binary EOR of all pixels in a binary image.
Gan_Image *	gan_image_bit_andnot_s (Gan_Image *image1, Gan_Image *image2)
	Binary AND-NOT of all pixels in a binary image.
Gan_Image *	gan_image_bit_and_i (Gan_Image *result, Gan_Image *image)
	Binary AND of all pixels in a binary image.
Gan_Image *	gan_image_bit_nand_i (Gan_Image *result, Gan_Image *image)
	Binary NAND of all pixels in a binary image.
Gan_Image *	gan_image_bit_or_i (Gan_Image *result, Gan_Image *image)
	Binary OR of all pixels in a binary image.
Gan_Image *	gan_image_bit_eor_i (Gan_Image *result, Gan_Image *image)
	Binary EOR of all pixels in a binary image.
Gan_Image *	gan_image_bit_andnot_i (Gan_Image *result, Gan_Image *image)
	Binary AND-NOT of all pixels in a binary image.

---

Function Documentation

Gan_Image* gan_image_bit_and_i (  Gan_Image *  result, Gan_Image *  image )

Binary AND of all pixels in a binary image. Returns: Result binary image result. Apply AND operation to two input binary images image1 and image2, overwriting the result image with the result.

Gan_Image * gan_image_bit_and_q (  Gan_Image *  image1, Gan_Image *  image2, Gan_Image *  result_image )

Binary AND of all pixels in a binary image. Returns: Result binary image result. Apply AND operation to two input binary images image1 and image2, writing the result into result.

Gan_Image* gan_image_bit_and_s (  Gan_Image *  image1, Gan_Image *  image2 )

Binary AND of all pixels in a binary image. Returns: The result as a new image. Apply AND operation to two input binary images image1 and image2, creating a new image to hold the result.

Gan_Image* gan_image_bit_andnot_i (  Gan_Image *  result, Gan_Image *  image )

Binary AND-NOT of all pixels in a binary image. Returns: Result binary image result. Apply AND-NOT operation to two input binary images image1 and image2, overwriting the result image with the result.

Gan_Image * gan_image_bit_andnot_q (  Gan_Image *  image1, Gan_Image *  image2, Gan_Image *  result_image )

Binary AND-NOT of all pixels in a binary image. Returns: Result binary image result. Apply AND-NOT operation to two input binary images image1 and image2, writing the result into result.

Gan_Image* gan_image_bit_andnot_s (  Gan_Image *  image1, Gan_Image *  image2 )

Binary AND-NOT of all pixels in a binary image. Returns: The result as a new image. Apply AND-NOT operation to two input binary images image1 and image2, creating a new image to hold the result.

Gan_Bool gan_image_bit_dilate_horiz (  Gan_Image *  image, int  no_pixels, Gan_Image *  restrict_mask )

Dilate binary image horizontally. Parameters: image  Binary image to dilate no_pixels  Number of pixels to dilate image by restrict_mask  Mask to restrict dilation or NULL Returns: GAN_TRUE on success, GAN_FALSE on failure. Dilate binary image image horizontally by given number of pixels no_pixels, optionally specifying a mask restrict_mask to restrict the dilation.

Gan_Bool gan_image_bit_dilate_vert (  Gan_Image *  image, int  no_pixels, Gan_Image *  restrict_mask )

Dilate binary image vertically. Parameters: image  Binary image to dilate no_pixels  Number of pixels to dilate image by restrict_mask  Mask to restrict dilation or NULL Returns: GAN_TRUE on success, GAN_FALSE on failure. Dilate binary image image vertically by given number of pixels no_pixels, optionally specifying a mask restrict_mask to restrict the dilation.

Gan_Image* gan_image_bit_eor_i (  Gan_Image *  result, Gan_Image *  image )

Binary EOR of all pixels in a binary image. Returns: Result binary image result. Apply EOR operation (exclusive OR) to two input binary images image1 and image2, overwriting the result image with the result.

Gan_Image * gan_image_bit_eor_q (  Gan_Image *  image1, Gan_Image *  image2, Gan_Image *  result_image )

Binary EOR of all pixels in a binary image. Returns: Result binary image result. Apply EOR operation (exclusive OR) to two input binary images image1 and image2, writing the result into result.

Gan_Image* gan_image_bit_eor_s (  Gan_Image *  image1, Gan_Image *  image2 )

Binary EOR of all pixels in a binary image. Returns: The result as a new image. Apply EOR operation (exclusive OR) to two input binary images image1 and image2, creating a new image to hold the result.

Gan_Bool gan_image_bit_fill_row (  Gan_Image *  image, unsigned  y, unsigned  x, unsigned  width, Gan_Bool  pix )

Fill part of a row of a binary image. Fill part of a row of a binary image, starting at position x, y and filling width pixels to the right.

Gan_Bool gan_image_bit_get_pix_3group_horiz (  const Gan_Image *  image, unsigned  row, unsigned  col )

Test local group of three binary pixels in a row. Return GAN_TRUE if bits at positions (row,col), (row,col-1) and (row,col+1) are all set to one (true), or GAN_FALSE otherwise.

Gan_Bool gan_image_bit_get_pix_3group_vert (  const Gan_Image *  image, unsigned  row, unsigned  col )

Test local group of three binary pixels in a column. Return GAN_TRUE if bits at positions (row,col), (row-1,col) and (row+1,col) are all set to one (true), or GAN_FALSE otherwise.

Gan_Bool gan_image_bit_get_pix_4group (  const Gan_Image *  image, unsigned  row, unsigned  col )

Test local group of four binary pixels. Return GAN_TRUE if bits at positions (row,col), (row,col+1), (row+1,col) and (row+1,col+1) are all set to one (true), or GAN_FALSE otherwise.

Gan_Bool gan_image_bit_get_pix_5group (  const Gan_Image *  image, unsigned  row, unsigned  col )

Test local group of five binary pixels. Return GAN_TRUE if bits at positions (row,col), (row,col-1), (row,col+1), (row-1,col) and (row+1,col) are all set to one (true), or GAN_FALSE otherwise.

Gan_Bool gan_image_bit_get_pix_9group (  const Gan_Image *  image, unsigned  row, unsigned  col )

Test local group of nine binary pixels. Return GAN_TRUE if bits at positions (row-1,col-1), (row,col), (row+1,col-1), (row,col-1), (row,col+1), (row-1,col), (row+1,col-1), (row+1,col) and (row+1,col+1) are all set to one (true), or GAN_FALSE otherwise.

Gan_Image* gan_image_bit_invert_i (  Gan_Image *  image  )

Macro: Invert binary image. Returns: The result image. Invert all the bits in the given image, overwriting the result on the input image.

Gan_Image * gan_image_bit_invert_q (  Gan_Image *  image, Gan_Image *  result_image )

Invert binary image. Returns: The result image result_image. Invert all the bits in the given image, writing the result into result_image.

Gan_Bool gan_image_bit_invert_row (  Gan_Image *  image, unsigned  y, unsigned  x, unsigned  width )

Invert part of a row of a binary image. Invert part of a row of a binary image, starting at position x, y and filling width pixels to the right.

Gan_Image* gan_image_bit_invert_s (  Gan_Image *  image  )

Macro: Invert binary image. Returns: The result as a new image. Invert all the bits in the given image, creating a new image to hold the result.

Gan_Image* gan_image_bit_nand_i (  Gan_Image *  result, Gan_Image *  image )

Binary NAND of all pixels in a binary image. Returns: Result binary image result. Apply NAND operation (not AND) to two input binary images image1 and image2, overwriting the result image with the result.

Gan_Image * gan_image_bit_nand_q (  Gan_Image *  image1, Gan_Image *  image2, Gan_Image *  result_image )

Binary NAND of all pixels in a binary image. Returns: Result binary image result. Apply NAND operation (not AND) to two input binary images image1 and image2, writing the result into result.

Gan_Image* gan_image_bit_nand_s (  Gan_Image *  image1, Gan_Image *  image2 )

Binary NAND of all pixels in a binary image. Returns: The result as a new image. Apply NAND operation (not AND) to two input binary images image1 and image2, creating a new image to hold the result.

Gan_Image* gan_image_bit_or_i (  Gan_Image *  result, Gan_Image *  image )

Binary OR of all pixels in a binary image. Returns: Result binary image result. Apply OR operation to two input binary images image1 and image2, overwriting the result image with the result.

Gan_Image * gan_image_bit_or_q (  Gan_Image *  image1, Gan_Image *  image2, Gan_Image *  result_image )

Binary OR of all pixels in a binary image. Returns: Result binary image result. Apply OR operation to two input binary images image1 and image2, writing the result into result.

Gan_Image* gan_image_bit_or_s (  Gan_Image *  image1, Gan_Image *  image2 )

Binary OR of all pixels in a binary image. Returns: The result as a new image. Apply OR operation to two input binary images image1 and image2, creating a new image to hold the result.

Gan_Bool gan_image_bit_shift (  const Gan_Image *  image, int  vshift, int  hshift, Gan_Image *  result_image )

Shift binary image horizontally and vertically. Parameters: image  Binary image to shift vshift  Vertical shift hshift  Horizontal shift result_image  Binary result image Returns: GAN_TRUE on success, GAN_FALSE on failure.

int gan_image_get_pixel_count_b (  const Gan_Image *  image, Gan_Bool  val, const Gan_ImageWindow *  psubwin )

Returns number of pixels set or unset in the given binary image. If val is passed as GAN_TRUE, returns the number of pixels set to one (true) in the given image. If val is GAN_FALSE, counts the number of zeros instead. If subwin is not NULL, counts the pixels only inside the given subwindow.

---