acid-drop

- Hacking the planet from a LilyGo T-Deck using custom firmware
git clone git://git.acid.vegas/acid-drop.git
lv_gpu_nxp_vglite.h (5192B)
      1 /**
      2  * @file lv_gpu_nxp_vglite.h
      3  *
      4  */
      5 
      6 /**
      7  * MIT License
      8  *
      9  * Copyright (c) 2020 NXP
     10  *
     11  * Permission is hereby granted, free of charge, to any person obtaining a copy
     12  * of this software and associated documentation files (the "Software"), to deal
     13  * in the Software without restriction, including without limitation the rights to
     14  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
     15  * the Software, and to permit persons to whom the Software is furnished to do so,
     16  * subject to the following conditions:
     17  *
     18  * The above copyright notice and this permission notice (including the next paragraph)
     19  * shall be included in all copies or substantial portions of the Software.
     20  *
     21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
     22  * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
     23  * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
     24  * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
     25  * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
     26  * OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
     27  *
     28  */
     29 
     30 #ifndef LV_SRC_LV_GPU_LV_GPU_NXP_VGLITE_H_
     31 #define LV_SRC_LV_GPU_LV_GPU_NXP_VGLITE_H_
     32 
     33 #ifdef __cplusplus
     34 extern "C" {
     35 #endif
     36 
     37 /*********************
     38  *      INCLUDES
     39  *********************/
     40 #include "../../lv_conf_internal.h"
     41 
     42 #if LV_USE_GPU_NXP_VG_LITE
     43 
     44 /*********************
     45  *      DEFINES
     46  *********************/
     47 
     48 /** Use this symbol as limit to disable feature (value has to be larger than supported resolution) */
     49 #define LV_GPU_NXP_VG_LITE_FEATURE_DISABLED (1920*1080+1)
     50 
     51 /** Stride in px required by VG-Lite HW. Don't change this. */
     52 #define LV_GPU_NXP_VG_LITE_STRIDE_ALIGN_PX 16U
     53 
     54 #ifndef LV_GPU_NXP_VG_LITE_FILL_SIZE_LIMIT
     55 /** Minimum area (in pixels) to be filled by VG-Lite with 100% opacity*/
     56 #define LV_GPU_NXP_VG_LITE_FILL_SIZE_LIMIT 32
     57 #endif
     58 
     59 #ifndef LV_GPU_NXP_VG_LITE_FILL_OPA_SIZE_LIMIT
     60 /** Minimum area (in pixels) to be filled by VG-Lite with transparency*/
     61 #define LV_GPU_NXP_VG_LITE_FILL_OPA_SIZE_LIMIT 32
     62 #endif
     63 
     64 #ifndef LV_GPU_NXP_VG_LITE_BLIT_SIZE_LIMIT
     65 /** Minimum area (in pixels) for image copy with 100% opacity to be handled by VG-Lite*/
     66 #define LV_GPU_NXP_VG_LITE_BLIT_SIZE_LIMIT 32
     67 #endif
     68 
     69 #ifndef LV_GPU_NXP_VG_LITE_BUFF_SYNC_BLIT_SIZE_LIMIT
     70 /** Minimum invalidated area (in pixels) to be synchronized by VG-Lite during buffer sync */
     71 #define LV_GPU_NXP_VG_LITE_BUFF_SYNC_BLIT_SIZE_LIMIT 32
     72 #endif
     73 
     74 #ifndef LV_GPU_NXP_VG_LITE_BLIT_OPA_SIZE_LIMIT
     75 /** Minimum area (in pixels) for image copy with transparency to be handled by VG-Lite*/
     76 #define LV_GPU_NXP_VG_LITE_BLIT_OPA_SIZE_LIMIT 32
     77 #endif
     78 
     79 #ifndef LV_GPU_NXP_VG_LITE_LOG_ERRORS
     80 /** Enable logging of VG-Lite errors (\see LV_LOG_ERROR)*/
     81 #define LV_GPU_NXP_VG_LITE_LOG_ERRORS 1
     82 #endif
     83 
     84 /**********************
     85  *      TYPEDEFS
     86  **********************/
     87 
     88 /**
     89  * BLock Image Transfer descriptor structure
     90  */
     91 typedef struct {
     92 
     93     const lv_color_t * src;  /**< Source buffer pointer (must be aligned on 32 bytes)*/
     94     lv_area_t src_area;      /**< Area to be copied from source*/
     95     lv_coord_t src_width;    /**< Source buffer width*/
     96     lv_coord_t src_height;   /**< Source buffer height*/
     97     uint32_t src_stride;     /**< Source buffer stride in bytes (must be aligned on 16 px)*/
     98 
     99     const lv_color_t * dst;  /**< Destination buffer pointer (must be aligned on 32 bytes)*/
    100     lv_area_t dst_area;      /**< Target area in destination buffer (must be the same as src_area)*/
    101     lv_coord_t dst_width;    /**< Destination buffer width*/
    102     lv_coord_t dst_height;   /**< Destination buffer height*/
    103     uint32_t dst_stride;     /**< Destination buffer stride in bytes (must be aligned on 16 px)*/
    104 
    105     lv_opa_t opa;            /**< Opacity - alpha mix (0 = source not copied, 255 = 100% opaque)*/
    106 
    107 } lv_gpu_nxp_vglite_blit_info_t;
    108 
    109 /**********************
    110  *      MACROS
    111  **********************/
    112 
    113 /**********************
    114  *   GLOBAL FUNCTIONS
    115  **********************/
    116 
    117 /***
    118  * Fills rectangular area in buffer.
    119  * @param[in] dest_buf Destination buffer pointer (must be aligned on 32 bytes)
    120  * @param[in] dest_width Destination buffer width in pixels ((must be aligned on 16 px)
    121  * @param[in] dest_height Destination buffer height in pixels
    122  * @param[in] fill_area Area to be filled
    123  * @param[in] color Fill color
    124  * @param[in] opa Opacity (255 = full, 128 = 50% background/50% color, 0 = no fill)
    125  * @retval LV_RES_OK Fill completed
    126  * @retval LV_RES_INV Error occurred (\see LV_GPU_NXP_VG_LITE_LOG_ERRORS)
    127  */
    128 lv_res_t lv_gpu_nxp_vglite_fill(lv_color_t * dest_buf, lv_coord_t dest_width, lv_coord_t dest_height,
    129                                 const lv_area_t * fill_area, lv_color_t color, lv_opa_t opa);
    130 
    131 /***
    132  * BLock Image Transfer.
    133  * @param[in] blit Description of the transfer
    134  * @retval LV_RES_OK Transfer complete
    135  * @retval LV_RES_INV Error occurred (\see LV_GPU_NXP_VG_LITE_LOG_ERRORS)
    136  */
    137 lv_res_t lv_gpu_nxp_vglite_blit(lv_gpu_nxp_vglite_blit_info_t * blit);
    138 
    139 #endif /*LV_USE_GPU_NXP_VG_LITE*/
    140 
    141 #ifdef __cplusplus
    142 } /*extern "C"*/
    143 #endif
    144 
    145 #endif /*LV_SRC_LV_GPU_LV_GPU_NXP_VGLITE_H_*/