From 11b04a27728f7da64a32a63fcc7b4f9c00872267 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9D=8E=E8=8B=A5=E8=BE=B0?= Date: Wed, 2 Jul 2025 09:39:45 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20MacroMath?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- MacroMath.md | 159 +++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 140 insertions(+), 19 deletions(-) diff --git a/MacroMath.md b/MacroMath.md index 8b0325a..9ad41a5 100644 --- a/MacroMath.md +++ b/MacroMath.md @@ -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矩阵 \ No newline at end of file +# 数学模块 + +* ● 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 objects = new List(); +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(); // 重量3.14kg +``` +值得注意的是,目前文本包裹器没有脏标记逻辑,所以每次获取值会重新计算所有的成员。 + +### 高级语法包裹 + +在新的更新中,包裹器支持域写法,同时可以省略部分参数: + +``` +_blockBuilder = new TextBlockBuilder() +{ + new ColorBlock() // 默认值就是白色 + { "重量" }, + new NumberValueBlock(3.14f), + new SizeBlock(20) // 默认单位为像素 + { "kg" } +}; + +_blockBuilder.ToString(); // 重量3.14kg +``` +这里的作用与上面的示例完全一致,更新的包裹器中支持自动填入更多的默认值了,比如颜色默认为白色等,并且具有更多的值写法。 +虽然看起来更长了,但是对于较复杂的格式来说可以有更强的可读性,建议这样写。 + +同时,委托包裹器并不是唯一设置动态参数的方式: +* ● `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(); // 重量6.18kg +``` +这样做会让原本不会接收参数的包裹器占用一个值索引。 + + +值得时刻注意的是,`SetParamters`传递的值需要按深度优先的顺序逐一匹对,基本上可以认为是blockBuilder定义时的block先后顺序。 +如果`SetParamters`中参数数量少于需求,在匹配时将会提前退出,导致后续值保持不变; +如果遇到强制类型检查的block且值无法匹配,block不会处理这个值,而是丢给下一个,只有遇到这种情况时,索引才有可能不是一一对应的形式。(默认认为是这么处理的,具体行为可以由block自己定义) + +关于性能:这种做法不是省油的灯,不建议在运行时重复创建,而是声名在当前作用域的全局用作静态,或保持实例唯一。 +``` +// 比如这样在当前类中声名为变量 +public TextBlockBuilder _blockBuilder = new TextBlockBuilder() + +public void ILikeThis() +{ + target.text = _blockBuilder.SetParamters(1, 2, 3).ToString(); +} +```