Migration Guide

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

BSP with NemaVG

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]

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