gapSize
gapSize
提供一个浮点数值,代表一个“间隙”的尺寸,主要用于在 `LineDashedNodeMaterial` 中定义虚线的空白部分长度。
核心优势
提供了极其直观的 `material.gapSize = value` API,将底层的 Uniform 管理完全抽象化,并为虚线等效果提供了标准化的控制参数。
常见用途
在 `LineDashedNodeMaterial` 中定义虚线的空白部分长度。
控制程序化网格或点状图案的间距。
设定条纹或百叶窗效果中透明部分的高度。
调整 CRT 扫描线效果中黑色空隙的厚度。
如何调整
在 JavaScript 中直接修改 `material.gapSize` 属性(一个数字)。对于虚线,增大该值会使线段间的空白变长,使线更稀疏;将该值设为 0 会使线段首尾相连,形成一条实线。
代码示例
1// 在虚线着色器中,vLineDistance 是沿线的距离
2// 如果当前片元位于图案的“间隙”部分,则将其丢弃
3if ( mod( vLineDistance, dashSize.add( gapSize ) ).greaterThan( dashSize ) ) {
4
5 discard;
6
7}