The Gradient module contains the C part of the MicroVG implementation, which manages linear gradients. This module is composed of only one element: an implementation of the Abstraction Layer APIs to create gradient elements compatible with the hardware.
The Gradient module implements the framework of the MicroVG LinearGradient. It provides Abstraction Layer APIs that consist in creating a linear gradient in a VEE Port-specific format. After the gradient creation and encoding, the gradient data should not change when the application draws it: the encoded format should be used by the VEE Port-specific implementation (generally GPU).
A linear gradient is a succession of colors at different positions. The colors from the MicroVG library implementation are encoded in the 32-bit format: ARGB8888. The color encoding in the gradient is a VEE Port-specific implementation.
The buffer where the gradient is encoded is stored in the Java heap. The MicroVG implementation on demand automatically increases the buffer size.
Abstraction Layer API¶
There are two separate Abstraction Layer API header files (see LLVG_GRADIENT: Vector Linear Gradient):
LLVG_GRADIENT_impl.hspecifies the Abstraction Layer APIs used to create and encode the gradient.
LLVG_PAINTER_impl.hlists the Abstraction Layer APIs called by VectorGraphicsPainter to draw the path.
- MicroVG library calls the BSP functions through the header files
- The C module MicroVG provides a default implementation of
LLVG_GRADIENT_impl.h: it manages the gradient buffer creation and filling, then redirect the gradient encoding to
- This C module also provides an implementation of
LLVG_PAINTER_impl.cthat synchronizes the drawing with the MicroUI Graphics Engine and redirects the drawing itself to a third-party drawer.
- A C module dedicated to a GPU provides an implementation of
microvg_gradient.h: it encodes the gradient and implements the drawings over the GPU library.
- These files are automatically copied in the BSP project when fetching the C modules during the VEE Port build.