image_translate.h File Reference

Go to the source code of this file.

Typedefs
typedef struct image_translate_state_s	image_translate_state_t
Functions
int	image_translate_row (image_translate_state_t *s, uint8_t buf[], size_t len)
	Get the next row of a translated image.
int	image_translate_get_output_width (image_translate_state_t *s)
	Get the width of the image being produced by an image translation context.
int	image_translate_get_output_length (image_translate_state_t *s)
	Get the length of the image being produced by an image translation context.
image_translate_state_t *	image_translate_init (image_translate_state_t *s, int input_format, int input_width, int input_length, int output_format, int output_width, int output_length, t4_row_read_handler_t row_read_handler, void *row_read_user_data)
	Initialise an image translation context for rescaling and squashing a gray scale or colour image to a bi-level FAX type image.
int	image_translate_release (image_translate_state_t *s)
	Release the resources associated with an image translation context.
int	image_translate_free (image_translate_state_t *s)
	Free the resources associated with an image translation context.

---

Detailed Description

---

Function Documentation

int image_translate_free

(

image_translate_state_t *

s

)

Free the resources associated with an image translation context.

Parameters:

s

The image translation context.

Returns:

0 for success, otherwise -1.

References image_translate_release().

int image_translate_get_output_length

(

image_translate_state_t *

s

)

Get the length of the image being produced by an image translation context.

Parameters:

s

The image translation context.

Returns:

The length of the output image, in pixel.

int image_translate_get_output_width

(

image_translate_state_t *

s

)

Get the width of the image being produced by an image translation context.

Parameters:

s

The image translation context.

Returns:

The width of the output image, in pixel.

image_translate_state_t* image_translate_init	(	image_translate_state_t *	s,
		int	input_format,
		int	input_width,
		int	input_length,
		int	output_format,
		int	output_width,
		int	output_length,
		t4_row_read_handler_t	row_read_handler,
		void *	row_read_user_data
	)

Initialise an image translation context for rescaling and squashing a gray scale or colour image to a bi-level FAX type image.

Parameters:

	s	The image translation context.
	input_format	x
	input_width	The width of the source image, in pixels.
	input_length	The length of the source image, in pixels.
	output_format	x
	output_width	The width of the output image, in pixels. If this is set <= 0 the image will not be resized.
	output_length	The length of the output image, in pixels. If this is set to <= 0 the output length will be derived automatically from the width, to maintain the geometry of the original image.
	row_read_handler	A callback routine used to pull rows of pixels from the source image into the translation process.
	row_read_user_data	An opaque point passed to read_row_handler

Returns:

A pointer to the context, or NULL if there was a problem.

int image_translate_release

(

image_translate_state_t *

s

)

Release the resources associated with an image translation context.

Parameters:

s

The image translation context.

Returns:

0 for success, otherwise -1.

Referenced by image_translate_free().

int image_translate_row	(	image_translate_state_t *	s,
		uint8_t	buf[],
		size_t	len
	)

Get the next row of a translated image.

Parameters:

s

The image translation context.

Returns:

the length of the row buffer, in bytes