LVGL 库提交

2026-08-30 08:57:07 +08:00
parent 26c9098630
commit e2f199c6bf
1056 changed files with 556743 additions and 45 deletions
@@ -0,0 +1,136 @@
+/**
+ * @file lv_matrix.h
+ *
+ */
+
+#ifndef LV_MATRIX_H
+#define LV_MATRIX_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*********************
+ *      INCLUDES
+ *********************/
+
+#include "../lv_conf_internal.h"
+
+#if LV_USE_MATRIX
+
+#include "lv_types.h"
+#include "lv_area.h"
+
+/*********************
+ *      DEFINES
+ *********************/
+
+#if !LV_USE_FLOAT
+#error "LV_USE_FLOAT is required for lv_matrix"
+#endif
+
+/**********************
+ *      TYPEDEFS
+ **********************/
+
+struct _lv_matrix_t {
+    float m[3][3];
+};
+
+/**********************
+ * GLOBAL PROTOTYPES
+ **********************/
+
+/**
+ * Set matrix to identity matrix
+ * @param matrix           pointer to a matrix
+ */
+void lv_matrix_identity(lv_matrix_t * matrix);
+
+/**
+ * Translate the matrix to new position
+ * @param matrix           pointer to a matrix
+ * @param tx               the amount of translate in x direction
+ * @param tx               the amount of translate in y direction
+ */
+void lv_matrix_translate(lv_matrix_t * matrix, float tx, float ty);
+
+/**
+ * Change the scale factor of the matrix
+ * @param matrix           pointer to a matrix
+ * @param scale_x          the scale factor for the X direction
+ * @param scale_y          the scale factor for the Y direction
+ */
+void lv_matrix_scale(lv_matrix_t * matrix, float scale_x, float scale_y);
+
+/**
+ * Rotate the matrix with origin
+ * @param matrix           pointer to a matrix
+ * @param degree           angle to rotate
+ */
+void lv_matrix_rotate(lv_matrix_t * matrix, float degree);
+
+/**
+ * Change the skew factor of the matrix
+ * @param matrix           pointer to a matrix
+ * @param skew_x           the skew factor for x direction
+ * @param skew_y           the skew factor for y direction
+ */
+void lv_matrix_skew(lv_matrix_t * matrix, float skew_x, float skew_y);
+
+/**
+ * Multiply two matrix and store the result to the first one
+ * @param matrix           pointer to a matrix
+ * @param matrix2          pointer to another matrix
+ */
+void lv_matrix_multiply(lv_matrix_t * matrix, const lv_matrix_t * mul);
+
+/**
+ * Invert the matrix
+ * @param matrix           pointer to a matrix
+ * @param m                pointer to another matrix (optional)
+ * @return true: the matrix is invertible, false: the matrix is singular and cannot be inverted
+ */
+bool lv_matrix_inverse(lv_matrix_t * matrix, const lv_matrix_t * m);
+
+/**
+ * Transform a point by a matrix
+ * @param matrix           pointer to a matrix
+ * @param point            pointer to a point
+ * @return the transformed point
+ */
+lv_point_precise_t lv_matrix_transform_precise_point(const lv_matrix_t * matrix, const lv_point_precise_t * point);
+
+/**
+ * Transform an area by a matrix
+ * @param matrix           pointer to a matrix
+ * @param area             pointer to an area
+ * @return the transformed area
+ */
+lv_area_t lv_matrix_transform_area(const lv_matrix_t * matrix, const lv_area_t * area);
+
+/**
+ * Check if the matrix is identity
+ * @param matrix           pointer to a matrix
+ * @return true: the matrix is identity , false: the matrix is not identity
+ */
+bool lv_matrix_is_identity(const lv_matrix_t * matrix);
+
+/**
+ * Check if the matrix is identity or translation matrix
+ * @param matrix           pointer to a matrix
+ * @return true: the matrix is identity or translation matrix, false: the matrix is not identity or translation matrix
+ */
+bool lv_matrix_is_identity_or_translation(const lv_matrix_t * matrix);
+
+/**********************
+ *      MACROS
+ **********************/
+
+#endif /*LV_USE_MATRIX*/
+
+#ifdef __cplusplus
+} /*extern "C"*/
+#endif
+
+#endif /*LV_MATRIX_H*/