LVGL笔记13–lv_led指示灯

LVGL笔记13–lv_led指示灯

LV_LED控件就是一个简单的指示灯，在屏幕上绘制一个LED灯样式的图形，这个外形可以通过LV_style来修改，通常设置为圆形或小矩形，led灯控件具有0–255级的可调亮度属性，设置为0时代表最暗，设置为255时代表最亮，基于此亮度属性又分为OFF和ON两种状态的概念，不过设置OFF时亮度值不是0合适100，设置为ON时，亮度值是255

---

API函数接口

• 创建LED对象

  /*---------------------------------------------------------------------------------
  	这个函数用来创建LED
  	par: 父对象
      copy: 拷贝的对象,如果无拷贝的话,传 NULL 值 
      返回值:
      	返回创建出来的对象,如果返回 NULL 的话,说明堆空间不够了
  ----------------------------------------------------------------------------------*/
  lv_obj_t * lv_led_create(lv_obj_t * par, const lv_obj_t * copy);
  

• 设置亮度值

  /*---------------------------------------------------------------------------------
  	这个函数用来设置LED灯的亮度值
  	led：指示灯对象
  	bright：亮度值，范围为[0,255]
  ----------------------------------------------------------------------------------*/
  void lv_led_set_bright(lv_obj_t * led, uint8_t bright);
  

• 设置为ON状态

  /*---------------------------------------------------------------------------------
  	这个函数用来设置LED灯的ON状态（这个 API 接口的实现本质就是在调用 lv_led_set_bright 接口）
  	led：指示灯对象
  ----------------------------------------------------------------------------------*/
  void lv_led_on(lv_obj_t * led);
  

• 设置为off状态

  /*---------------------------------------------------------------------------------
  	这个函数用来设置LED灯的OFF状态（这个 API 接口的实现本质就是在调用 lv_led_set_bright 接口）
  	led：指示灯对象
  ----------------------------------------------------------------------------------*/
  void lv_led_off(lv_obj_t * led);
  

• 切换指示灯的ON和OFF状态

  /*---------------------------------------------------------------------------------
  	如果指示灯当前为 ON 状态,调用此接口之后,就会变成 OFF 状态,如果当前为 OFF 状态,调用此接口之后,就会变成 ON 状态
  	led：指示灯对象
  ----------------------------------------------------------------------------------*/
  void lv_led_toggle(lv_obj_t * led);
  

• 设置样式

  /*---------------------------------------------------------------------------------
  	这个函数用来设置样式
  	led: 指示灯对象
      type: 设置那部分的样式,目前就 LV_LED_STYLE_MAIN 这一个可选值
      style: 样式
  ----------------------------------------------------------------------------------*/
  static inline void lv_led_set_style(lv_obj_t * led, lv_led_style_t type, const lv_style_t * style);
  

• 获取亮度值

  /*---------------------------------------------------------------------------------
  	这个函数用来获取当前的亮度值
  	led: 指示灯对象
  	返回值：返回当前的亮度值
  ----------------------------------------------------------------------------------*/
  uint8_t lv_led_get_bright(const lv_obj_t * led);
  

2021–2--14–wrs