/**
  **********************************************************************************************************************
  * @file    oled.h
  * @brief   该文件提供OLED驱动所有函数原型
  * @author  周鹏程    any question please send mail to [email protected]
  * @date    2023-06-21
  * 
  **********************************************************************************************************************
  *
  **********************************************************************************************************************
  */

/* Define to prevent recursive inclusion -----------------------------------------------------------------------------*/
#ifndef _COT_OLED_H_
#define _COT_OLED_H_

/* Includes ----------------------------------------------------------------------------------------------------------*/
#include "cot_oled_cfg.h"
#include <stdint.h>

/* Exported types ----------------------------------------------------------------------------------------------------*/

typedef unsigned char oledsize_t;

/**
  * @brief 画笔颜色
  */
typedef enum
{
    OLED_BLACK = 0,
    OLED_WHITE = 0xff,
} eOledcolor;

/* Exported constants ------------------------------------------------------------------------------------------------*/
/* Exported macro ----------------------------------------------------------------------------------------------------*/
/* Exported functions ------------------------------------------------------------------------------------------------*/

/* OLED 初始化函数 ****************************************************************************************************/
extern void cotOled_Init(void);

/* OLED 控制函数 ******************************************************************************************************/
extern void cotOled_DisplayOn(void);
extern void cotOled_DisplayOff(void);

/* 画点/读点函数 ******************************************************************************************************/
extern void cotOled_DrawPoint(oledsize_t x, oledsize_t y, eOledcolor color);
extern void cotOled_DrawRoughPoint(oledsize_t x, oledsize_t y, eOledcolor color, uint8_t size);
extern eOledcolor OLED_ReadPoint(oledsize_t x, oledsize_t y);

/* OLED 清屏函数 ******************************************************************************************************/
extern void cotOled_Clear(uint8_t color);
extern void cotOled_SetFill(oledsize_t sx, oledsize_t sy, oledsize_t width, oledsize_t high, eOledcolor color);

/* 画面操作函数 *******************************************************************************************************/
extern void cotOled_SyncScreen(oledsize_t sx, oledsize_t sy, oledsize_t width, oledsize_t high);
extern void cotOled_ShowTask(void);
extern void cotOled_SetScreenOffset(oledsize_t x, oledsize_t y, oledsize_t width, oledsize_t high, uint8_t dir, uint8_t pixels);
extern void cotOled_ReverseScreen(oledsize_t sx, oledsize_t sy, oledsize_t width, oledsize_t high);

/* 画图形函数 *********************************************************************************************************/
extern void cotOled_DrawLine(oledsize_t sx, oledsize_t sy, oledsize_t ex, oledsize_t ey, uint8_t size);
extern void cotOled_DrawRectangle(oledsize_t sx, oledsize_t sy, oledsize_t width, oledsize_t high, uint8_t size);
extern void cotOled_DrawCircle(oledsize_t x, oledsize_t y, oledsize_t radius, uint8_t size);
extern void cotOled_DrawGraphic(oledsize_t x, oledsize_t y, const char *pkszName, uint8_t size);

/* 设置文本/数字函数 **************************************************************************************************/
extern void cotOled_SetColor(eOledcolor backColor, eOledcolor pointColor);
extern void cotOled_SetText(oledsize_t x, oledsize_t y, const char *pszStr, uint8_t isMultiLine, efontSize size);
extern void cotOled_SetIntegerNum(oledsize_t x, oledsize_t y, int32_t num, uint8_t len, uint8_t zero, efontSize size);
extern void cotOled_SetFloatNum(oledsize_t x, oledsize_t y, float num, uint8_t intLen, uint8_t decLen, uint8_t zero, efontSize size);

/* 格式化输出函数 *****************************************************************************************************/
extern void cotOled_XYPrintf(oledsize_t x, oledsize_t y, uint8_t isMultiLine, efontSize size, const char *format, ...);
extern void cotOled_Printf(const char *format, ...);

#endif  // _COT_OLED_H_