mirror of
https://github.com/lvgl/lvgl.git
synced 2026-05-13 07:18:06 +08:00
liamHowatt
103 lines
2.5 KiB
C
103 lines
2.5 KiB
C
/**
|
|
* @file lv_text.h
|
|
*
|
|
*/
|
|
|
|
#ifndef LV_TEXT_H
|
|
#define LV_TEXT_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*********************
|
|
* INCLUDES
|
|
*********************/
|
|
#include "../lv_conf_internal.h"
|
|
|
|
#include "lv_types.h"
|
|
#include "lv_area.h"
|
|
#include "../font/lv_font.h"
|
|
#include "../stdlib/lv_sprintf.h"
|
|
|
|
/*********************
|
|
* DEFINES
|
|
*********************/
|
|
|
|
#define LV_TXT_ENC_UTF8 1
|
|
#define LV_TXT_ENC_ASCII 2
|
|
|
|
/**********************
|
|
* TYPEDEFS
|
|
**********************/
|
|
|
|
/**
|
|
* Options for text rendering.
|
|
*/
|
|
|
|
enum _lv_text_flag_t {
|
|
LV_TEXT_FLAG_NONE = 0x00,
|
|
LV_TEXT_FLAG_EXPAND = 0x01, /**< Ignore max-width to avoid automatic word wrapping*/
|
|
LV_TEXT_FLAG_FIT = 0x02, /**< Max-width is already equal to the longest line. (Used to skip some calculation)*/
|
|
};
|
|
|
|
#ifdef DOXYGEN
|
|
typedef _lv_text_flag_t lv_text_flag_t;
|
|
#else
|
|
typedef uint8_t lv_text_flag_t;
|
|
#endif /*DOXYGEN*/
|
|
|
|
/** Label align policy*/
|
|
enum _lv_text_align_t {
|
|
LV_TEXT_ALIGN_AUTO, /**< Align text auto*/
|
|
LV_TEXT_ALIGN_LEFT, /**< Align text to left*/
|
|
LV_TEXT_ALIGN_CENTER, /**< Align text to center*/
|
|
LV_TEXT_ALIGN_RIGHT, /**< Align text to right*/
|
|
};
|
|
|
|
#ifdef DOXYGEN
|
|
typedef _lv_text_align_t lv_text_align_t;
|
|
#else
|
|
typedef uint8_t lv_text_align_t;
|
|
#endif /*DOXYGEN*/
|
|
|
|
/**********************
|
|
* GLOBAL PROTOTYPES
|
|
**********************/
|
|
|
|
/**
|
|
* Get size of a text
|
|
* @param size_res pointer to a 'point_t' variable to store the result
|
|
* @param text pointer to a text
|
|
* @param font pointer to font of the text
|
|
* @param letter_space letter space of the text
|
|
* @param line_space line space of the text
|
|
* @param max_width max width of the text (break the lines to fit this size). Set COORD_MAX to avoid
|
|
* @param flag settings for the text from ::lv_text_flag_t
|
|
|
|
* line breaks
|
|
*/
|
|
void lv_text_get_size(lv_point_t * size_res, const char * text, const lv_font_t * font, int32_t letter_space,
|
|
int32_t line_space, int32_t max_width, lv_text_flag_t flag);
|
|
|
|
/**
|
|
* Give the length of a text with a given font
|
|
* @param txt a '\0' terminate string
|
|
* @param length length of 'txt' in byte count and not characters (Á is 1 character but 2 bytes in
|
|
* UTF-8)
|
|
* @param font pointer to a font
|
|
* @param letter_space letter space
|
|
* @return length of a char_num long text
|
|
*/
|
|
int32_t lv_text_get_width(const char * txt, uint32_t length, const lv_font_t * font, int32_t letter_space);
|
|
|
|
/**********************
|
|
* MACROS
|
|
**********************/
|
|
|
|
#ifdef __cplusplus
|
|
} /*extern "C"*/
|
|
#endif
|
|
|
|
#endif /*LV_TEXT_H*/
|