lv_test_screenshot_compare.h

Enums

enum lv_test_screenshot_result_t

Return value of lv_test_screenshot_compare

Values:

enumerator LV_TEST_SCREENSHOT_RESULT_FAILED

The screenshot is different than the reference image

enumerator LV_TEST_SCREENSHOT_RESULT_PASSED

The screenshot is the same as the reference image. It is also returned if LV_TEST_SCREENSHOT_CREATE_REFERENCE_IMAGE is enabled and the reference image was missing.

enumerator LV_TEST_SCREENSHOT_RESULT_NO_REFERENCE_IMAGE

If LV_TEST_SCREENSHOT_CREATE_REFERENCE_IMAGE is not enabled and the reference image is missing.

Functions

lv_test_screenshot_result_t lv_test_screenshot_compare(const char *fn_ref)

Compare the current content of the test screen with a reference PNG image

  • If the reference image is not found it will be created automatically from the rendered screen.

  • If the compare fails an <image_name>_err.png file will be created with the rendered content next to the reference image.

It requires lodepng.

Note

This function assumes that the default display is the test display that was created by lv_test_display_create()

Parameters:

fn_ref – path to the reference image. Will be appended to REF_IMGS_PATH if set.

Returns:

An element of lv_test_screenshot_result_t