更新 MacroMath
+140
-19
@@ -2,22 +2,143 @@
|
||||
|
||||
数学宏包含多个模块内容。
|
||||
|
||||
* RandomFloat/Vector/Matrix:通过一个随机生成器快速获得随机值。
|
||||
* Pmod:在正数空间上对值取余,负数情况下仍然会保持与正数相同的曲线形状。
|
||||
* RoundToAny:将一个矢量四舍五入到任意的倍数,比如4.8舍入3.5得到3.5,6.2则得到7
|
||||
* MinPositive:获取正数空间上的最小值。
|
||||
* SmoothStep:获取t在(a,b)之间的埃尔米特过度
|
||||
* LinearStep:获取t在(a,b)之间的线性过度
|
||||
* RoundBasedOnMinimumDifference:将一个值根据最小的差值进行四舍五入
|
||||
* DiscardLeastSignificantDecimal:舍弃不重要的小数位
|
||||
* ClampWrapAngle:钳制角度
|
||||
* GetNumberOfDecimalsForMinimumDifference:获取最小插值的小数个数
|
||||
* CosineSimilarity:余弦相似度
|
||||
* FibonacciRecursive:斐波那契迭代方式计算(会产生大量循环)
|
||||
* FastInvSqrt:快速平方根倒数
|
||||
* IsPrimeNumberRw:检查一个数是否是质数(这是一个娱乐用法,利用正则表达式判断是否为质数,性能消耗较高)
|
||||
* GetCirclePoints:获取圆上的点
|
||||
* GetRayIntersectionCircle:获取切于圆的线两点坐标
|
||||
* GetHeightOfRoundArch:获取圆拱高度
|
||||
* GetListFormAToB:获取从A到B的列表
|
||||
* LerpTransform:创建lerp矩阵
|
||||
# 数学模块
|
||||
|
||||
* ● RandomFloat/Vector/Matrix:通过一个随机生成器快速获得随机值。
|
||||
* ● Pmod:在正数空间上对值取余,负数情况下仍然会保持与正数相同的曲线形状。
|
||||
* ● RoundToAny:将一个矢量四舍五入到任意的倍数,比如4.8舍入3.5得到3.5,6.2则得到7
|
||||
* ● MinPositive:获取正数空间上的最小值。
|
||||
* ● SmoothStep:获取t在(a,b)之间的埃尔米特过度
|
||||
* ● LinearStep:获取t在(a,b)之间的线性过度
|
||||
* ● RoundBasedOnMinimumDifference:将一个值根据最小的差值进行四舍五入
|
||||
* ● DiscardLeastSignificantDecimal:舍弃不重要的小数位
|
||||
* ● ClampWrapAngle:钳制角度
|
||||
* ● GetNumberOfDecimalsForMinimumDifference:获取最小插值的小数个数
|
||||
* ● CosineSimilarity:余弦相似度
|
||||
* ● FibonacciRecursive:斐波那契迭代方式计算(会产生大量循环)
|
||||
* ● FastInvSqrt:快速平方根倒数
|
||||
* ● IsPrimeNumberRw:检查一个数是否是质数(这是一个娱乐用法,利用正则表达式判断是否为质数,性能消耗较高)
|
||||
* ● GetCirclePoints:获取圆上的点
|
||||
* ● GetRayIntersectionCircle:获取切于圆的线两点坐标
|
||||
* ● GetHeightOfRoundArch:获取圆拱高度
|
||||
* ● GetListFormAToB:获取从A到B的列表
|
||||
* ● LerpTransform:创建lerp矩阵
|
||||
|
||||
# 文本模块
|
||||
|
||||
## 文本转换
|
||||
|
||||
自动值转换为文本。
|
||||
|
||||
## 将数值转为中文大写
|
||||
|
||||
NumberToChinese
|
||||
|
||||
## 沃格纳费舍尔拼写检查器
|
||||
|
||||
检查一对或多对文本是否相似,返回最相似的文本序列,及相似度。
|
||||
|
||||
## 打印数组
|
||||
|
||||
ListToString
|
||||
|
||||
|
||||
## 文本构建池
|
||||
|
||||
提供`StringBuilderPool`对象池,可以使用常规的方法访问这个池,或使用`GetStrBuilder`直接获取一个StringBuilder,然后使用完毕后通过`ReleaseStrBuilder`立刻获取StringBuilder里拼接的文本,并释放这个stringBuilder。
|
||||
|
||||
XericLibrary里的所有需要文本拼接的地方都会用到这个成员,请严格按照池化对象操作流程使用,如果错误的使用释放的对象,可能会造成意外的错误。
|
||||
|
||||
## 链式语法的文本序列拼接。
|
||||
|
||||
提供`Join`扩展方法。用法与直接使用`string.Join()`类似。
|
||||
|
||||
```
|
||||
List<object> objects = new List<object>();
|
||||
objects.Join(obj => obj.ToString())
|
||||
|
||||
```
|
||||
|
||||
## 文本判断
|
||||
|
||||
空判断,空格判断,相等判断,字符集判断
|
||||
|
||||
## 格式包裹
|
||||
|
||||
支持TMP的26个富文本标签,或者自行扩展更多包裹器。
|
||||
包裹器可以依靠多态模型来构建文本,而不依赖字面量构建。下面是一个示例:
|
||||
```
|
||||
public float value = 3.14f;
|
||||
_blockBuilder = new TextBlockBuilder(
|
||||
new ColorBlock(Color.white, "重量"),
|
||||
new DelegateBlock(() => value.ToString()),
|
||||
new SizeBlock(20, "kg")));
|
||||
```
|
||||
* ● `TextBlockBuilder` 是所有blocker的基类,使用它包裹所有文本将起到单纯拼接文本的作用;
|
||||
* ● TextBlockBuilder 里的三个block的作用是使用相应的富文本标签包裹,根据标签的类型,包裹器会自动决定标签格式。
|
||||
* ● `DelegateBlock`的作用是通过委托来实时获取一个变量,示例中直接获取value的文本值,拼接到结果中。
|
||||
* ● TextBlockBuilder 可以不依靠如`DelegateBlock`这样的包裹器,可以直接将返回字符串类型的方法委托传入,blocker 会自动识别;前提是开启对应 blocker 里的`compatibility`兼容性检查,但这会带来额外的性能开销,如果没有特别的需求,建议还是使用类似`DelegateBlock`这样的预设值包裹进行多态封装,也会更安全。
|
||||
|
||||
最后这样获取文本:
|
||||
```
|
||||
_blockBuilder.ToString(); // <color=white>重量</color>3.14<size=20>kg</size>
|
||||
```
|
||||
值得注意的是,目前文本包裹器没有脏标记逻辑,所以每次获取值会重新计算所有的成员。
|
||||
|
||||
### 高级语法包裹
|
||||
|
||||
在新的更新中,包裹器支持域写法,同时可以省略部分参数:
|
||||
|
||||
```
|
||||
_blockBuilder = new TextBlockBuilder()
|
||||
{
|
||||
new ColorBlock() // 默认值就是白色
|
||||
{ "重量" },
|
||||
new NumberValueBlock(3.14f),
|
||||
new SizeBlock(20) // 默认单位为像素
|
||||
{ "kg" }
|
||||
};
|
||||
|
||||
_blockBuilder.ToString(); // <color=white>重量</color>3.14<size=20>kg</size>
|
||||
```
|
||||
这里的作用与上面的示例完全一致,更新的包裹器中支持自动填入更多的默认值了,比如颜色默认为白色等,并且具有更多的值写法。
|
||||
虽然看起来更长了,但是对于较复杂的格式来说可以有更强的可读性,建议这样写。
|
||||
|
||||
同时,委托包裹器并不是唯一设置动态参数的方式:
|
||||
* ● `SetParamters`:在根包裹器上使用赋值方法,可以将一系列值一一对应地填入到后续一系列包裹器中。
|
||||
* ● `RefernceBlock`:反射包裹器允许传入一个对象,以及成员名称来访问属性 (字段,访问器,方法均可) 。
|
||||
* ● `ValueBlock`:值包裹器,搭配`SetParamters`来设置值,目标需要实现Tostring方法。
|
||||
* ● `NumberValueBlock`数值类型包裹器,搭配`SetParamters`来设置值,设置值会自动限制在最大最小范围内,如果给定的参数是字符串类型,将尝试通过默认的格式化方法转为数值。
|
||||
|
||||
在实际使用时,只有`ValueBlock`这样的纯值包裹器默认会从`SetParamters`参数列表中获取值,
|
||||
其他包裹器需要手动通过`SetParameterization`设置为参数化包裹器,否则不会响应参数列表。
|
||||
就像这样:
|
||||
```
|
||||
_blockBuilder = new TextBlockBuilder()
|
||||
{
|
||||
new ColorBlock()
|
||||
{ "重量" }.SetParameterization(),
|
||||
new NumberValueBlock(3.14f),
|
||||
new SizeBlock(20)
|
||||
{ "kg" }.SetParameterization()
|
||||
};
|
||||
|
||||
_blockBuilder.SetParamters(Color.green, 6.18f, 10).ToString(); // <color=#00FF00>重量</color>6.18<size=10>kg</size>
|
||||
```
|
||||
这样做会让原本不会接收参数的包裹器占用一个值索引。
|
||||
|
||||
|
||||
值得时刻注意的是,`SetParamters`传递的值需要按深度优先的顺序逐一匹对,基本上可以认为是blockBuilder定义时的block先后顺序。
|
||||
如果`SetParamters`中参数数量少于需求,在匹配时将会提前退出,导致后续值保持不变;
|
||||
如果遇到强制类型检查的block且值无法匹配,block不会处理这个值,而是丢给下一个,只有遇到这种情况时,索引才有可能不是一一对应的形式。(默认认为是这么处理的,具体行为可以由block自己定义)
|
||||
|
||||
关于性能:这种做法不是省油的灯,不建议在运行时重复创建,而是声名在当前作用域的全局用作静态,或保持实例唯一。
|
||||
```
|
||||
// 比如这样在当前类中声名为变量
|
||||
public TextBlockBuilder _blockBuilder = new TextBlockBuilder()
|
||||
|
||||
public void ILikeThis()
|
||||
{
|
||||
target.text = _blockBuilder.SetParamters(1, 2, 3).ToString();
|
||||
}
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user