Migration Guide

From 1.7.1 to 1.7.2

Install the C Module MicroVG 7.0.2.
Install the C Module MicroVG over NemaVG 2.0.2.
Add the defines RESX and RESY in vg/inc/vg_configuration.h or in the C project global options.

Follow the migration steps of BSP with VGLite for the new UI Pack.
Install the C Module MicroVG over VGLite 9.0.0.
Set the define UI_GC_SUPPORTED_FORMATS to 2 or more in ui_configuration.h.
Set the define UI_FEATURE_FONT_CUSTOM_FORMATS in ui_configuration.h.

Follow the migration steps of BSP with NemaGFX for the new UI Pack.
Install the C Module MicroVG over NemaVG 2.0.0.
Set the define UI_GC_SUPPORTED_FORMATS to 2 or more in ui_configuration.h.
Set the define UI_FEATURE_FONT_CUSTOM_FORMATS in ui_configuration.h.

Optionally, update the C Module FreeType to use FreeType version 2.13.3:

Delete the directory thirdparty/freetype.
Remove thirdparty/freetype/inc and thirdparty/freetype/inc/ftvector from your include path.
Add thirdparty/freetype/include, thirdparty/freetype/src and freetype_support/src to your include path.
Remove thirdparty/freetype/lib/freetype.a from your build path.
Build FreeType and add the library and support files following the C Module FreeType’s instructions.

Optionally, update the C Module HarfBuzz to use HafBuzz version 10.0.1:

Delete the directory thirdparty/harfbuzz.
Remove thirdparty/harfbuzz/inc from your include path.
Add thirdparty/harfbuzz/src to your include path.
Remove thirdparty/harfbuzz/lib/harfbuzz.a and thirdparty/harfbuzz/src/hb-alloc.c from your build path.
Build HarfBuzz and add the library and support files following C Module HarfBuzz’s instructions.

Follow the migration steps of BSP with VGLite for the new UI Pack.
Install the C Module MicroVG over VGLite 8.0.1.
Delete the following file in the ui directory:
- src/ui_drawing_bvi.c.
Delete the following files in the vg directory:
- inc/microvg_font_freetype.h,
- inc/microvg_gradient.h,
- inc/microvg_helper.h,
- inc/microvg_path.h,
- inc/microvg_trace.h,
- src/LLVG_BVI_stub.c,
- src/LLVG_FONT_freetype.c,
- src/LLVG_FONT_stub.c,
- src/LLVG_GRADIENT_impl.c,
- src/LLVG_impl.c,
- src/LLVG_PATH_impl.c,
- src/LLVG_PATH_stub.c,
- src/microvg_helper.c,
- inc/vg_bvi_vglite.h,
- inc/vg_drawing_vglite.h,
- inc/vg_vglite_helper.h,
- src/LLVG_GRADIENT_impl_vglite.c,
- src/LLVG_impl_vglite.c,
- src/vg_drawing_bvi.c,
- src/vg_drawing_vglite_image.c,
- src/vg_drawing_vglite.c,
- src/vg_path_vglite.c,
- src/vg_vglite_helper.c.
Delete the properties files cco_microvg.properties and cco_microvg-vglite.properties.
Build the VEE Port.
Configure the C Module MicroVG in vg/inc/vg_configuration.h, based on your previous settings in vg/inc/microvg_configuration.h.
Delete vg/inc/microvg_configuration.h.
Add the source files in vg/src and vg_vglite/src to the project.
Add the path vg_vglite/inc to the include path.

Follow the migration steps BSP with VGLite for the new UI Pack.
Install the C Modules MicroVG 3.0.0 and MicroVG-VGLite 5.0.1.
Delete the content of dropins/include folder.
Delete the C files freetype_bitmap_helper.h, freetype_bitmap_helper.c, LLVG_BVI_impl.c, LLVG_FONT_PAINTER_freetype_bitmap.c and LLVG_PATH_PAINTER_vglite.c and remove them from the C project configuration.
In the C project configuration, include the new C files ui_drawing_bvi.c, LLVG_BVI_stub.c, LLVG_PAINTER_impl.c, vg_drawing_bvi.c, vg_drawing_stub.c, vg_drawing_vglite.c and vg_drawing.c.
In the C project configuration, set the define LLUI_GC_SUPPORTED_FORMATS=2 to enable the BufferedVectorImage support.
Verify the options in microvg_configuration.h.
Build the FreeType library (in case of a dedicated project), and then the BSP.