From b4d8823e9e6e60c2fd82ea57e8261d9691a4d329 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9D=8E=E8=8B=A5=E8=BE=B0?= Date: Wed, 18 Jun 2025 13:51:26 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20HowToUseXericLibrary?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- HowToUseXericLibrary.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/HowToUseXericLibrary.md b/HowToUseXericLibrary.md index 9099cbc..6f2563a 100644 --- a/HowToUseXericLibrary.md +++ b/HowToUseXericLibrary.md @@ -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这样的包裹器,可以直接将返回字符串类型的方法委托传入,blocker 会自动识别;前提是开启对应 blocker 里的compatibility兼容性检查,但这会带来额外的性能开销,如果没有特别的需求,建议还是使用DelegateBlock`进行多态封装,这样也会更安全。 + TextBlockBuilder 可以不依靠如`DelegateBlock这样的包裹器,可以直接将返回字符串类型的方法委托传入,blocker 会自动识别; 前提是开启对应 blocker 里的compatibility兼容性检查,但这会带来额外的性能开销,如果没有特别的需求,建议还是使用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()烘焙的数据就起作用了,通过调用线实例上的RemappingTimeValue()`将时间驱动值转换为速度驱动值,这会带来非常平滑的效果。 2D的线路组件`XericRectSplinePath`工作在Rect上,如果屏幕的工作分辨率实际上是可变的,可能会导致实际线路有时会错位,这是因为线路工作的参考坐标系是静态的。 -如果当前项目的窗口缩放易变,建议每帧调用`UpdateRectDepend()`(一般都很难遇到分辨率亘古不变的情况),这个方法可以刷新曲线构建所依赖的矩形空间坐标。 +如果当前项目的窗口缩放易变,建议每帧调用`UpdateRectDepend()` (一般都很难遇到分辨率亘古不变的情况),这个方法可以刷新曲线构建所依赖的矩形空间坐标。 为了适配速度矫正后的线路,建议使用线路的长度作为循环的时间最大值,而不是强制所有线路从0-1取值,线路总长度可以使用`SplineLength`属性获取。 -这里是一个示例:(这个示例中使用的是二维曲线,但设置ui的方法是世界空间的,并非屏幕空间,这是因为我驱动的目标对象还是世界空间的Sprite,同时较小的ui坐标便于计算尾迹的长度,避免结果速度太快) +这里是一个示例: (这个示例中使用的是二维曲线,但设置ui的方法是世界空间的,并非屏幕空间,这是因为我驱动的目标对象还是世界空间的Sprite,同时较小的ui坐标便于计算尾迹的长度,避免结果速度太快) ``` public void UpdateBySpline(XericRectSplinePath spline) {