Migration Guide

From 1.7.0 to 1.7.1

BSP with VGLite

• [VEE Port configuration project]

  • Fetch the VG Pack 1.7.1 and the C Module MicroVG over VGLite 9.0.1.

BSP with NemaVG

• [VEE Port configuration project]

  • Fetch the VG Pack 1.7.1 and the C Module MicroVG over NemaVG 2.0.1.

From 1.6.0 to 1.7.0

VEE Port Configuration project

• Update the UI Pack to version 14.1.1 or higher.

BSP with VGLite

• Follow the migration steps of BSP with VGLite for the new UI Pack.

• [VEE Port configuration project]

  • Fetch the VG Pack 1.7.0 and the C Module MicroVG over VGLite 9.0.0.

BSP with NemaVG

• Follow the migration steps of BSP with NemaGFX for the new UI Pack.

• [VEE Port configuration project]

  • Fetch the VG Pack 1.7.0 and the C Module MicroVG over NemaVG 2.0.0.

FreeType

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.

HarfBuzz

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.

From 1.5.x to 1.6.0

VEE Port Configuration project

• Update the UI Pack to version 14.0.1 or higher.

• Specify the implementation property, as written in the section Installation.

LLAPIs

• Update your implementation of the following functions to match the signature changes.

  • LLVG_GRADIENT_IMPL_initializeGradient,

  • LLVG_MATRIX_IMPL_copy,

  • LLVG_MATRIX_IMPL_multiply,

  • LLVG_MATRIX_IMPL_setConcat,

  • LLVG_MATRIX_IMPL_concatenate,

  • LLVG_MATRIX_IMPL_postConcat,

  • LLVG_BVI_IMPL_map_context,

  • LLVG_PAINTER_IMPL_drawImage.

BSP with VGLite

• Follow the migration steps of BSP with VGLite for the new UI Pack.

• [VEE Port configuration project]

  • Fetch the VG Pack 1.6.0 and the C Module MicroVG over VGLite 8.0.1.

• [BSP project]

  • 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.

From 1.4.x to 1.5.1

VEE Port Configuration Project

• Update UI Pack version: 14.0.0 or higher.

BSP with VGLite

• Follow the migration steps of BSP with VGLite for the new UI Pack.

• [VEE Port configuration project]

  • Fetch VG Pack 1.5.1, C Modules MicroVG 5.0.0 and MicroVG-VGLite 7.0.1.

• [BSP project]

  • Delete the properties files cco_microvg.properties and cco_microvg-vglite.properties.

From 1.3.x to 1.4.2

BSP with VGLite

• Follow the migration steps of BSP with VGLite for the new UI Pack.

• [VEE Port configuration project]

  • Fetch VG Pack 1.4.2, C Modules MicroVG 4.0.0 and MicroVG-VGLite 6.1.1.

  • Delete the content of dropins/include folder.

• [BSP project]

  • Delete the properties files cco_microvg.properties and cco_microvg-vglite.properties.

• Build the VEE Port, the FreeType library (in case of a dedicated project), and the BSP.

From 1.2.x to 1.3.0

VEE Port Configuration Project

• Update UI Pack version: 13.5.0 or higher.

BSP with VGLite

• Follow the migration steps BSP with VGLite for the new UI Pack.

• [VEE Port configuration project]

  • Fetch VG Pack 1.3.0, C Modules MicroVG 3.0.0 and MicroVG-VGLite 5.0.1.

  • Delete the content of dropins/include folder.

• [BSP project]

  • Delete the properties files cco_microvg.properties and cco_microvg-vglite.properties.

  • 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 VEE Port, the FreeType library (in case of a dedicated project), and the BSP.