Migration Guide

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 the C Module MicroUI over VGLite.

  • [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 C Module MicroUI-VGLite 8.0.0.

  • [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 C Module MicroUI-VGLite 7.1.0.

  • [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 of C Module MicroUI-VGLite 6.0.1.

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