Image Graphics Format Handlers

Declaration of function open for user redefinition. More...

Functions list
int	gl_draw_jpeg_image (gl_rectangle_t *dest, gl_rectangle_t *src, const uint8_t *image)
	Draw JPEG image on display. More...
void	gl_draw_bitmap_16bpp (gl_rectangle_t *dest, gl_rectangle_t *src, const uint8_t *image)
	Draw 16bpp bitmap image on display. More...
void	gl_draw_bitmap_4bpp (gl_rectangle_t *dest, gl_rectangle_t *src, const uint8_t *image)
	Draw 1bpp bitmap image on display. More...
void	gl_draw_bitmap_8bpp (gl_rectangle_t *dest, gl_rectangle_t *src, const uint8_t *image)
	Draw 8bpp bitmap image on display. More...
void	gl_draw_bitmap_1bpp (gl_rectangle_t *dest, gl_rectangle_t *src, const uint8_t *image)
	Draw 1bpp bitmap image on display. More...

Detailed Description

Here are declaration for function used by gl_draw_image for specific image format. All functions can be reimplemented by user, and will be automaticly linked into gl_draw_image.

Function Documentation

gl_draw_jpeg_image()

int gl_draw_jpeg_image	(	gl_rectangle_t *	dest,
		gl_rectangle_t *	src,
		const uint8_t *	image
	)

This function draws JPEG image on display. It is declared as weak meaning that the user can redefine it which will result in linking it instead of the one present in library. In this way user can save RAM space if the redefined function consumes less memory than the library one. User will just have to define it with empty body. Also, user may write his own function definition so the image is drawn in different manner.

Parameters

[in]	dest	Frame in which the image will be drawn. See gl_rectangle_t structure definition for detailed explanation.
[in]	src	Part of the original image which will be drawn into dest frame. See gl_rectangle_t structure definition for detailed explanation.
[in]	image	Pointer to an image.

Returns

Returns zero if the image is successfully drawn, otherwise returns non-zero value.

Precondition

Before using this function a driver must be set using the gl_set_driver function.

Note

Image must be generated using NECTO Studio's resource generator.

gl_draw_bitmap_16bpp()

void gl_draw_bitmap_16bpp	(	gl_rectangle_t *	dest,
		gl_rectangle_t *	src,
		const uint8_t *	image
	)

This function draws bitmap image in 16bpp format on display. It is declared as weak meaning that the user can redefine it which will result in linking it instead of the one present in library. In this way user can save RAM space if the redefined function consumes less memory than the library one. User will just have to define it with empty body. Also, user may write his own function definition so the image is drawn in different manner.

Parameters

[in]	dest	Frame in which the image will be drawn. See gl_rectangle_t structure definition for detailed explanation.
[in]	src	Part of the original image which will be drawn into dest frame. See gl_rectangle_t structure definition for detailed explanation.
[in]	image	Pointer to an image.

Returns

Returns zero if the image is successfully drawn, otherwise returns non-zero value.

Precondition

Before using this function a driver must be set using the gl_set_driver function.

Note

Image must be generated using NECTO Studio's resource generator.

gl_draw_bitmap_4bpp()

void gl_draw_bitmap_4bpp	(	gl_rectangle_t *	dest,
		gl_rectangle_t *	src,
		const uint8_t *	image
	)

This function draws bitmap image in 4bpp format on display. It is declared as weak meaning that the user can redefine it which will result in linking it instead of the one present in library. In this way user can save RAM space if the redefined function consumes less memory than the library one. User will just have to define it with empty body. Also, user may write his own function definition so the image is drawn in different manner.

Parameters

[in]	dest	Frame in which the image will be drawn. See gl_rectangle_t structure definition for detailed explanation.
[in]	src	Part of the original image which will be drawn into dest frame. See gl_rectangle_t structure definition for detailed explanation.
[in]	image	Pointer to an image.

Returns

Returns zero if the image is successfully drawn, otherwise returns non-zero value.

Precondition

Before using this function a driver must be set using the gl_set_driver function.

Note

Image must be generated using NECTO Studio's resource generator.

gl_draw_bitmap_8bpp()

void gl_draw_bitmap_8bpp	(	gl_rectangle_t *	dest,
		gl_rectangle_t *	src,
		const uint8_t *	image
	)

This function draws bitmap image in 8bpp format on display. It is declared as weak meaning that the user can redefine it which will result in linking it instead of the one present in library. In this way user can save RAM space if the redefined function consumes less memory than the library one. User will just have to define it with empty body. Also, user may write his own function definition so the image is drawn in different manner.

Parameters

[in]	dest	Frame in which the image will be drawn. See gl_rectangle_t structure definition for detailed explanation.
[in]	src	Part of the original image which will be drawn into dest frame. See gl_rectangle_t structure definition for detailed explanation.
[in]	image	Pointer to an image.

Returns

Returns zero if the image is successfully drawn, otherwise returns non-zero value.

Precondition

Before using this function a driver must be set using the gl_set_driver function.

Note

Image must be generated using NECTO Studio's resource generator.

gl_draw_bitmap_1bpp()

void gl_draw_bitmap_1bpp	(	gl_rectangle_t *	dest,
		gl_rectangle_t *	src,
		const uint8_t *	image
	)

This function draws bitmap image in 1bpp format on display. It is declared as weak meaning that the user can redefine it which will result in linking it instead of the one present in library. In this way user can save RAM space if the redefined function consumes less memory than the library one. User will just have to define it with empty body. Also, user may write his own function definition so the image is drawn in different manner.

Parameters

[in]	dest	Frame in which the image will be drawn. See gl_rectangle_t structure definition for detailed explanation.
[in]	src	Part of the original image which will be drawn into dest frame. See gl_rectangle_t structure definition for detailed explanation.
[in]	image	Pointer to an image.

Returns

Returns zero if the image is successfully drawn, otherwise returns non-zero value.

Precondition

Before using this function a driver must be set using the gl_set_driver function.

Note

Image must be generated using NECTO Studio's resource generator.