更新 HowToUseXericLibrary

2025-06-18 13:51:26 +08:00
parent 605c3a4f56
commit b4d8823e9e
+13 -13
@@ -68,7 +68,7 @@ Xeric中使用宏 (Macro) 作为隔离用法的的单元,所有的操作都可
----
#### [文本宏 MacroMath](../wiki/MacroMath)
提供:
提供:
* StringBuilderPool: 文本构建池
* join: 文本序列拼接。
```
@@ -76,9 +76,9 @@ Xeric中使用宏 (Macro) 作为隔离用法的的单元,所有的操作都可
objects.Join(obj => obj.ToString(), )
```
* 文本判断:空判断,空格判断,相等判断,字符集判断
* 格式包裹:支持TMP的26个富文本标签,或者自行扩展更多包裹器。
包裹器可以依靠多态模型来构建文本,而不依赖字面量构建。下面是一个示例:
* 文本判断: 空判断,空格判断,相等判断,字符集判断
* 格式包裹: 支持TMP的26个富文本标签,或者自行扩展更多包裹器。
包裹器可以依靠多态模型来构建文本,而不依赖字面量构建。下面是一个示例:
```
_blockBuilder = new TextBlockBuilder(
new ColorBlock(Color.white, "重量"),
@@ -87,9 +87,9 @@ Xeric中使用宏 (Macro) 作为隔离用法的的单元,所有的操作都可
```
TextBlockBuilder 是所有blocker的基类,使用它包裹所有文本将起到单纯拼接文本的作用;TextBlockBuilder 里的三个block的作用是使用相应的富文本标签包裹,根据标签的类型,包裹器会自动决定标签格式。
`DelegateBlock`的作用是通过委托来实时获取一个变量,示例中直接获取value的文本值,拼接到结果中。
TextBlockBuilder 可以不依靠如`DelegateBlock</code>这样的包裹器,可以直接将返回字符串类型的方法委托传入,blocker 会自动识别;前提是开启对应 blocker 里的<code>compatibility</code>兼容性检查,但这会带来额外的性能开销,如果没有特别的需求,建议还是使用<code>DelegateBlock`进行多态封装,这样也会更安全。
TextBlockBuilder 可以不依靠如`DelegateBlock</code>这样的包裹器,可以直接将返回字符串类型的方法委托传入,blocker 会自动识别; 前提是开启对应 blocker 里的<code>compatibility</code>兼容性检查,但这会带来额外的性能开销,如果没有特别的需求,建议还是使用<code>DelegateBlock`进行多态封装,这样也会更安全。
在新的更新中,包裹器支持域写法,同时可以省略部分参数:
在新的更新中,包裹器支持域写法,同时可以省略部分参数:
```
_blockBuilder = new TextBlockBuilder()
{
@@ -120,12 +120,12 @@ Xeric中使用宏 (Macro) 作为隔离用法的的单元,所有的操作都可
如果`SetParamters`中参数数量少于需求,在匹配时将会提前退出,导致后续值保持不变;
如果遇到强制类型检查的block且值无法匹配,block不会处理这个值,而是丢给下一个,只有遇到这种情况时,索引才有可能不是一一对应的形式。(默认认为是这么处理的,具体行为可以由block自己定义)
关于性能:这种做法绝对不是省油的灯,绝对不要在运行时重复创建,而是声名在当前作用域的全局用作静态,或保持实例唯一。
关于性能: 这种做法绝对不是省油的灯,绝对不要在运行时重复创建,而是声名在当前作用域的全局用作静态,或保持实例唯一。
* 文本转换:自动值转换为文本。
* NumberToChinese:将数值转为中文大写。
* 沃格纳费舍尔拼写检查器:检查一对或多对文本是否相似,返回最相似的文本序列,及相似度。
* ListToString:打印数组
* 文本转换: 自动值转换为文本。
* NumberToChinese: 将数值转为中文大写。
* 沃格纳费舍尔拼写检查器: 检查一对或多对文本是否相似,返回最相似的文本序列,及相似度。
* ListToString: 打印数组
----
#### [时间宏]
@@ -169,10 +169,10 @@ UI界面上的Spline组件会通过RectTransform控制,有区别与三维世
而开头我们使用`BakePoint()</code>烘焙的数据就起作用了,通过调用线实例上的<code>RemappingTimeValue()`将时间驱动值转换为速度驱动值,这会带来非常平滑的效果。
2D的线路组件`XericRectSplinePath`工作在Rect上,如果屏幕的工作分辨率实际上是可变的,可能会导致实际线路有时会错位,这是因为线路工作的参考坐标系是静态的。
如果当前项目的窗口缩放易变,建议每帧调用`UpdateRectDepend()`(一般都很难遇到分辨率亘古不变的情况),这个方法可以刷新曲线构建所依赖的矩形空间坐标。
如果当前项目的窗口缩放易变,建议每帧调用`UpdateRectDepend()` (一般都很难遇到分辨率亘古不变的情况),这个方法可以刷新曲线构建所依赖的矩形空间坐标。
为了适配速度矫正后的线路,建议使用线路的长度作为循环的时间最大值,而不是强制所有线路从0-1取值,线路总长度可以使用`SplineLength`属性获取。
这里是一个示例:(这个示例中使用的是二维曲线,但设置ui的方法是世界空间的,并非屏幕空间,这是因为我驱动的目标对象还是世界空间的Sprite,同时较小的ui坐标便于计算尾迹的长度,避免结果速度太快)
这里是一个示例: (这个示例中使用的是二维曲线,但设置ui的方法是世界空间的,并非屏幕空间,这是因为我驱动的目标对象还是世界空间的Sprite,同时较小的ui坐标便于计算尾迹的长度,避免结果速度太快)
```
public void UpdateBySpline(XericRectSplinePath spline)
{