多彩文本使用说明.docVIP

多彩文本使用说明 多彩文本使用说明 1 多彩文本的格式说明 1 多彩文本中颜色的格式 1 将指定的字符串绘制于屏幕指定位置。 1 获取字符串的宽度和高度。 2 获取指定字符的下一个字符的属性 3 获取指定宽度限制下的text需要占用的行数等属性。 3 获取显示字符串实际所需的高度(行间距默认为) 4 多彩文本的格式说明 多彩文本是由连续的字节组成，这些字节中包含以下内容 纯文本（每个字符2个字节） 标志位，包含以下几种 RICH_TAG_CMD = 0x01, /*保留，特殊命令*/ RICH_TAG_COLOR_PREFIX = 0x02,/*当前一color属性开始*/ RICH_TAG_COLOR_SUFFIX = 0x03,/*上一color属性结束*/ RICH_TAG_ICON = 0x04,/*icon标志*/ RICH_TAG_ICON_BG = 0x05/*bg icon for next items*/ 标志位后跟的内容，比如说RICH_TAG_COLOR_PREFIX标致后跟随的颜色 颜色的格式 目前的多彩文本颜色由一对标志位来完成，RICH_TAG_COLOR_PREFIX表示颜色开始，RICH_TAG_COLOR_SUFFIX表示颜色结束，支持10层嵌套（不能超过10）。 例如： 【RICH_TAG_COLOR_PREFIX】【颜色（红色）】【文本内容】【RICH_TAG_COLOR_SUFFIX】 颜色值为16位色，RGB三色按5,6,5的位数来分布。 图标的格式 图标的标志位有2个，一个是RICH_TAG_ICON，另一个是RICH_TAG_ICON_BG，两者的使用格式是一样的。在标志位后跟上BMP图标的ID 例如： 【ICON标志】【图标ID】 两者不同的是，在显示的时候，RICH_TAG_ICON_BG标志位后的图片是作为背景显示。也就是说在这个图片后的文本会重叠在这个图片上显示 将指定的字符串绘制于屏幕指定位置。 输入: pcData: 待显示的字符串 rect: 显示的字符限制范围 font: 字体大小，可能的值是 MR_FONT_SMALL MR_FONT_MEDIUM MR_FONT_BIG flag：可以取如下的值： DRAW_TEXT_EX_IS_AUTO_NEWLINE 2 //是否自动换行 返回值: 指示出在屏幕上第一个未完整显示字符的索引 int32 SGL_RichTextDraw(RichTextDrawInputSt* pcData, mr_screenRectSt *pRect, int flag, uint16 font); 这里主要是RichTextDrawInputSt* pcData这个变量的输入比较难理解，其中包含2个结构体 typedef struct { RichTextSt *text;//in int16 x;//起始x坐标 int16 y;//起始y坐标 //uint16 line_space; RichTextSt *out;//out, 调用者分配空间。指示第一个未显示字符。 }RichTextDrawInputSt; Text，x， y都是必填项。Text是多彩文本内容，xy为起始坐标 其中text的结构如下： /*text 结构*/ typedef struct { uint16* pcText;//rich txt的指针 uint16 color[MAX_COLOREMBED_DEEP];//起始文字的默认颜色(rgb565) uint8 index;//color[] 的当前索引 }RichTextSt; 这里 pcText是文本内容，注意，这个文本内容是包含了多彩格式的，必填项。 这里的Color既做输入也做输出，处理时会从color[0]中提取数值作为默认颜色，所以color[0]必填。 Index输入时请填0，这个值内部处理时使用 获取字符串的宽度和高度。 输入: pcText: 待显示的字符串 font: 字体大小，可能的值是 MR_FONT_SMALL MR_FONT_MEDIUM MR_FONT_BIG 输出: w：字符串的显示宽度 h：字符串的显示高度 返回: MR_SUCCES