vg_drawing.h File Reference

Provides drawing functions called by MicroVG native drawing functions. More...

#include <LLVG_PAINTER_impl.h>
#include "ui_drawing.h"

Go to the source code of this file.

Functions
void	VG_DRAWING_initialize (void)
	Called when initializing MicroVG. More...
bool	VG_DRAWING_image_is_closed (const MICROVG_Image *image)
	Tells if the image is closed (closed just before calling the native function). More...
void	VG_DRAWING_get_image_size (const MICROVG_Image *image, float *width, float *height)
	Gets the image size. The image structure format is VEE Port specific. More...
DRAWING_Status	VG_DRAWING_drawPath (MICROUI_GraphicsContext *gc, jbyte *path, jfloat *matrix, jint fillRule, jint blend, jint color)
	Draws a path filled with the specified color (not the one of the Graphics Context). More...
DRAWING_Status	VG_DRAWING_drawGradient (MICROUI_GraphicsContext *gc, jbyte *path, jfloat *matrix, jint fillRule, jint alpha, jint blend, jint *gradient, jfloat *gradientMatrix)
	Draws a path filled with a linear gradient. More...
DRAWING_Status	VG_DRAWING_drawString (MICROUI_GraphicsContext *gc, jchar *text, jint length, jint faceHandle, jfloat size, jfloat *matrix, jint alpha, jint blend, jfloat letterSpacing)
	Draws a string with the color of the Graphics Context. More...
DRAWING_Status	VG_DRAWING_drawStringGradient (MICROUI_GraphicsContext *gc, jchar *text, jint length, jint faceHandle, jfloat size, jfloat *matrix, jint alpha, jint blend, jfloat letterSpacing, jint *gradientData, jfloat *gradientMatrix)
	Draws a string with a linear gradient. More...
DRAWING_Status	VG_DRAWING_drawStringOnCircle (MICROUI_GraphicsContext *gc, jchar *text, jint length, jint faceHandle, jfloat size, jfloat *matrix, jint alpha, jint blend, jfloat letterSpacing, jfloat radius, jint direction)
	Draws a string along a circle, with the color of the Graphics Context. More...
DRAWING_Status	VG_DRAWING_drawStringOnCircleGradient (MICROUI_GraphicsContext *gc, jchar *text, jint length, jint faceHandle, jfloat size, jfloat *matrix, jint alpha, jint blend, jfloat letterSpacing, jfloat radius, jint direction, jint *gradientData, jfloat *gradientMatrix)
	Draws a string along a circle, with a linear gradient. More...
DRAWING_Status	VG_DRAWING_drawImage (MICROUI_GraphicsContext *gc, void *image, jfloat *matrix, jint alpha, jlong elapsed, const float color_matrix[], jint *errno)
	Draws an image with transformation and opacity. Optionally apply an animation and / or a color filtering. More...

Detailed Description

Provides drawing functions called by MicroVG native drawing functions.

This header file follows strictly the same concept as ui_drawing.h but for MicroVG library.

See also

ui_drawing.h

Definition in file vg_drawing.h.

Function Documentation

VG_DRAWING_drawGradient()

DRAWING_Status VG_DRAWING_drawGradient	(	MICROUI_GraphicsContext *	gc,
		jbyte *	path,
		jfloat *	matrix,
		jint	fillRule,
		jint	alpha,
		jint	blend,
		jint *	gradient,
		jfloat *	gradientMatrix
	)

Draws a path filled with a linear gradient.

Parameters

[in]	gc	the destination
[in]	path	the path's data
[in]	matrix	the deformation to apply
[in]	fillRule	the fill type
[in]	alpha	the global opacity to apply
[in]	blend	the blend mode
[in]	gradient	the gradient to apply
[in]	gradientMatrix	the gradient deformation, may be null (means identity)

Returns

the drawing status.

VG_DRAWING_drawImage()

DRAWING_Status VG_DRAWING_drawImage	(	MICROUI_GraphicsContext *	gc,
		void *	image,
		jfloat *	matrix,
		jint	alpha,
		jlong	elapsed,
		const float	color_matrix[],
		jint *	errno
	)

Draws an image with transformation and opacity. Optionally apply an animation and / or a color filtering.

Parameters

[in]	gc	the graphics context to draw on
[in]	image	the image to draw
[in]	matrix	the transformation matrix to apply
[in]	alpha	the global opacity rendering value
[in]	elapsed	the elapsed time since the beginning of the animation, in milliseconds
[in]	color_matrix	the color matrix used to transform colors, may be null (means no color deformation)
[out]	errno	the error code to return to MicroVG.

Returns

the drawing status.

VG_DRAWING_drawPath()

DRAWING_Status VG_DRAWING_drawPath	(	MICROUI_GraphicsContext *	gc,
		jbyte *	path,
		jfloat *	matrix,
		jint	fillRule,
		jint	blend,
		jint	color
	)

Draws a path filled with the specified color (not the one of the Graphics Context).

Parameters

[in]	gc	the destination
[in]	path	the path's data
[in]	matrix	the deformation to apply
[in]	fillRule	the fill type
[in]	blend	the blend mode
[in]	color	the color to apply (with an opacity)

Returns

the drawing status.

VG_DRAWING_drawString()

DRAWING_Status VG_DRAWING_drawString	(	MICROUI_GraphicsContext *	gc,
		jchar *	text,
		jint	length,
		jint	faceHandle,
		jfloat	size,
		jfloat *	matrix,
		jint	alpha,
		jint	blend,
		jfloat	letterSpacing
	)

Draws a string with the color of the Graphics Context.

The top/left position of the first drawn character is placed at coordinate x/y.

Parameters

[in]	gc	the MicroUI GraphicsContext target.
[in]	text	the array of characters to draw.
[in]	length	the length of the array
[in]	faceHandle	the font reference handle.
[in]	size	the height of the font in pixels.
[in]	matrix	deformation matrix, may be null (means identity)
[in]	alpha	the opacity level to apply to the character.
[in]	blend	the blend mode to use
[in]	letterSpacing	the extra letter spacing to use

Returns

the drawing status.

VG_DRAWING_drawStringGradient()

DRAWING_Status VG_DRAWING_drawStringGradient	(	MICROUI_GraphicsContext *	gc,
		jchar *	text,
		jint	length,
		jint	faceHandle,
		jfloat	size,
		jfloat *	matrix,
		jint	alpha,
		jint	blend,
		jfloat	letterSpacing,
		jint *	gradientData,
		jfloat *	gradientMatrix
	)

Draws a string with a linear gradient.

Parameters

[in]	gc	the MicroUI GraphicsContext target.
[in]	text	the array of characters to draw.
[in]	length	the length of the array
[in]	faceHandle	the font reference handle.
[in]	size	the height of the font in pixels.
[in]	matrix	deformation matrix, may be null (means identity)
[in]	alpha	the opacity level to apply to the character.
[in]	blend	the blend mode to use
[in]	letterSpacing	the extra letter spacing to use
[in]	gradientData	the gradient to apply
[in]	gradientMatrix	the gradient deformation, may be null (means identity)

Returns

the drawing status.

VG_DRAWING_drawStringOnCircle()

DRAWING_Status VG_DRAWING_drawStringOnCircle	(	MICROUI_GraphicsContext *	gc,
		jchar *	text,
		jint	length,
		jint	faceHandle,
		jfloat	size,
		jfloat *	matrix,
		jint	alpha,
		jint	blend,
		jfloat	letterSpacing,
		jfloat	radius,
		jint	direction
	)

Draws a string along a circle, with the color of the Graphics Context.

Parameters

[in]	gc	the MicroUI GraphicsContext target.
[in]	text	the array of characters to draw.
[in]	length	the length of the array
[in]	faceHandle	the font reference handle.
[in]	size	the height of the font in pixels.
[in]	matrix	deformation matrix, may be null (means identity)
[in]	alpha	the opacity level to apply to the character.
[in]	blend	the blend mode to use
[in]	letterSpacing	the extra letter spacing to use
[in]	radius	the radius of the circle
[in]	direction	the direction of the text along the circle

Returns

the drawing status.

VG_DRAWING_drawStringOnCircleGradient()

DRAWING_Status VG_DRAWING_drawStringOnCircleGradient	(	MICROUI_GraphicsContext *	gc,
		jchar *	text,
		jint	length,
		jint	faceHandle,
		jfloat	size,
		jfloat *	matrix,
		jint	alpha,
		jint	blend,
		jfloat	letterSpacing,
		jfloat	radius,
		jint	direction,
		jint *	gradientData,
		jfloat *	gradientMatrix
	)

Draws a string along a circle, with a linear gradient.

Parameters

[in]	gc	the MicroUI GraphicsContext target.
[in]	text	the array of characters to draw.
[in]	length	the length of the array
[in]	faceHandle	the font reference handle.
[in]	size	the height of the font in pixels.
[in]	matrix	deformation matrix, may be null (means identity)
[in]	alpha	the opacity level to apply to the character.
[in]	blend	the blend mode to use
[in]	letterSpacing	the extra letter spacing to use
[in]	radius	the radius of the circle
[in]	direction	the direction of the text along the circle
[in]	gradientData	the gradient to apply
[in]	gradientMatrix	the gradient deformation, may be null (means identity)

Returns

the drawing status.

VG_DRAWING_get_image_size()

void VG_DRAWING_get_image_size	(	const MICROVG_Image *	image,
		float *	width,
		float *	height
	)

Gets the image size. The image structure format is VEE Port specific.

Parameters

[in]	image	the image
[out]	width	the image width
[out]	height	the image height

VG_DRAWING_image_is_closed()

bool VG_DRAWING_image_is_closed

(

const MICROVG_Image *

image

)

Tells if the image is closed (closed just before calling the native function).

Parameters

[in]

image

the image to check.

Returns

true if the image is closed.

VG_DRAWING_initialize()

void VG_DRAWING_initialize

(

void

)

Called when initializing MicroVG.

This function should initialize the necessary variables.