NGUI-UILabel

最新推荐文章于 2024-04-20 00:00:00 发布

涛涛涛涛涛涛涛涛

最新推荐文章于 2024-04-20 00:00:00 发布

阅读量682

点赞数 1

文章标签： unity 游戏引擎

本文链接：https://blog.csdn.net/qq_63483516/article/details/125409019

版权

1.1 概述
UILabel是NGUI中用于文字显示的组件，支持图文显示，富文本等功能。阅读本文前请熟悉下NGUI的基本用法和基本属性。

基础属性
溢出类型
效果类型
字体类型
对齐方式
图文样式
渐变
边距
支持富文本
多行和最高行数

基本原理

字体方案有两种：Unity的动态字体（trueTypeFont,TTF）和NGUI的BitmapFont（BMFont）
UILabel维护mShouldBeProcessed的bool变量，在设置基本属性的时候都会将mShouldBeProcessed设置为true，并重写父类UIWidget的属性drawingDimensions、localCorners、worldCorners、localSize和方法GetSides中判断shouldBeProcessed是否为true，为true则调用UILabel的ProcessText重新计算信息并重新绘制。
NGUIText作为辅助类，是一个静态类，由于绘制文字的参数很多，由其参数缓存和相应的计算方法，减少相应的内存占用。

UILabel核心方法
ProcessText
流程
计算UILabel设定的矩形大小和真正显示的矩形大小,其设定矩形大小还受OverFlow类型的影响，如类型为Overflow.ResizeFreely或者Overflow.ResizeHeight相应的设定大小不受当前width height的限制。
调用NGUIText.Update(false)：更新最终字形的大小、字符间隔finalSpacingX、一行高度finalLineHeight和是否用符文等信息。
启用for循环不断递减字体大小
- 调用NGUIText.WrapText(mText, out mProcessedText, true);：
  - 根据regionHeight、finalLineHeight和maxLines计算出Label最多显示的行数；不断遍历字符，解析BBCode跳过用于富文本设置的字符，区分普通字符和图文字符分别计算其字形大小glyphWidth，维护每一行剩余的宽度remainingWidth，当宽度不足的时候就换行，最后返回Label是否容纳全部文本，并得到最终显示的文本finalText。
调用NGUIText.CalculatePrintedSize(mProcessedText)：
- 根据显示的文本mProcessedText和字符间隔finalSpacingX、一行高度finalLineHeight得到显示rect大小
根据不同OverFlow类型计算Label的宽度和高度。
OverFlow的处理方式
ShrinkContent：缩放内容；不断递减mPrintedSize调用NGUIText.WrapText(mText, out mProcessedText, true);判断目前字体大小是否能显示全部文字，直至满足条件或者字体大小不能再减小。
ClampContent：裁切内容；调用调用NGUIText.WrapText(mText, out mProcessedText, true);得到最终显示的文字。
- ResizeFreely：自适应宽高；调用调用NGUIText.WrapText(mText, out mProcessedText, true);得到最终显示的文字。并调用NGUIText.CalculatePrintedSize(mProcessedText);得到显示的大小，重新计算widget的宽高
- ResizeHeight：自适应高度；类似ResizeFreely，只是重新计算widget的高度。
- OnFill 流程
- UpdateNGUIText：更新设置当前UILabel的属性给NGUIText
- NGUIText.Print(text, verts, uvs, cols):根据显示的文本填入几何数据到缓存中
- ApplyOffset:根据Pivot类型调整顶点位置
- 对于Effect非None情形，以下是3个类型的原理
  - Effect.Shadow：阴影；调用ApplyShadow增加阴影处理,ApplyShadow的作用是将之前填入的当前UILabel最终显示的文本顶点、UV、Color数据重新填入一次，其中顶点做根据UILabel的mEffectDistance的属性做相应的偏差处理，Effect.Shadow是偏右下，因此呈现出阴影效果。
  - Effect.Outline：描边；调用ApplyShadow增加4个方向的阴影处理，分别是右下，左上，右上，左下，则相当于描边作用
  - Effect.Outline8：8个方向的描边，类似于Effect.Outline，方向相对于前置增加了正右，正上，正左，正下。
- Prepare：当使用动态字体时，调用Font.RequestCharactersInTexture刷新所需字符的纹理
- 遍历text的每个字符
- 处理换行符不处理非法字符
- ParseSymbol 解析BBCode:该函数带有多个ref值，分别为subscriptMode上下标，bold加粗，italic斜体, underline下划线, strikethrough中划线, ignoreColor忽略widget的颜色，即使用富文本的颜色。
- GetSymbol:获取对应的图文字符信息，没有匹配则返回null
  - 处理图文字符
    - 计算符号图文的显示范围
    - 如果宽度容纳不下换行
    - 添加顶点、UV、Color信息到缓存
    - 其中SymbolStyle等于Colored的时候，图案的颜色使用当前字体颜色，其中情况下只使用当前的alpha值，rgb通道均为255。
  - 处理普通字符
    - GetGlyph(ch, prev);获取字形信息，根据使用的是bitmapFont还是dynamicFont计算得到字形数据GlyphInfo，里面包含字形的顶点坐标，uv坐标和颜色channel通道设置。
- - 有上下标
    - glyph的两个顶点glyph.v0和glyph.v1乘以一个比例值sizeShrinkage都缩小，缩小顶点范围
    - 根据上标还是下标对顶点进行上下偏移Y坐标
  - 如果宽度不够换行处理
  - 若字符为空格：若BBCode对应是下划线，则替换为“下划线”；若对应中划线，都不对应，则continue
  - 处理纹理坐标：添加纹理坐标到缓存中
  - 根据GlyphInfo的channel值-》处理顶点颜色，填入Color信息
    - 当前channel为0或者为15的时候，对于渐变情况做下处理，算法是：计算出字体顶点y轴最高点和最低点的在整体字体显示的比例，通过渐变底部和顶部的颜色插值得到对应顶部和底部两个颜色值。
  - 根据粗体斜体处理顶点坐标
    - 粗体相当于每个字符渲染4次，对顶点坐标进行一定的偏移
    - 斜体相当于每个字符顶点有一定偏移
  - 处理下划线或中划线
    - 获取对应GlyphInfo信息
    - 类似上述进行处理
- 处理alignment为居中或右侧的情况：默认按照从左往右，即Alignment.Left方式处理
  - Alignment.Right：计算显示宽度与文本宽度的差值，如果差值padding大于0，将顶点坐标的x坐标向右偏移padding
  - Alignment.Center：计算显示宽度与文本宽度的差值的一半padding，如果差值padding大于0，将顶点坐标的x坐标向右偏移padding
  - Alignment.Justified:
    - 文本宽度需要大于显示宽度的65%；
    - 计算显示宽度与文本宽度的差值的一半padding
    - 将字符平均显示在显示区域上