LineMaterial.html 3.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  1. <!DOCTYPE html>
  2. <html lang="zh">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="page.js"></script>
  7. <link type="text/css" rel="stylesheet" href="page.css" />
  8. </head>
  9. <body>
  10. [page:Material] &rarr; [page:ShaderMaterial] &rarr;
  11. <h1>线段材质([name])</h1>
  12. <p class="desc">
  13. 用于绘制线框样式几何体的材质。
  14. 与 [page:LineBasicMaterial] 不同,它支持任意线宽,并允许使用世界单位而不是屏幕空间单位。
  15. 此材质与 [page:LineSegments2] 和 [page:Line2] 一起使用。
  16. </p>
  17. <p class="desc">
  18. 线段始终以圆形端点和圆形接头渲染。
  19. </p>
  20. <h2>示例</h2>
  21. <p>
  22. [example:webgl_lines_fat WebGL / lines / fat ]<br />
  23. [example:webgl_lines_fat_raycasting WebGL / lines / fat / raycasting ]<br />
  24. [example:webgl_lines_fat_wireframe WebGL / lines / fat / wireframe ]<br />
  25. [example:webgpu_lines_fat WebGPU / lines / fat / raycasting ]
  26. </p>
  27. <h2>构造函数</h2>
  28. <h3>[name]( [param:Object parameters] )</h3>
  29. <p>
  30. [page:Object parameters] - (可选)一个包含一个或多个定义材质外观属性的对象。
  31. 材质的任何属性(包括从 [page:ShaderMaterial] 继承的任何属性)都可以在此传入。
  32. </p>
  33. <p>
  34. 特例是属性 [page:Hexadecimal color],可以作为数字或十六进制字符串传入,默认值为 `0xffffff`(白色)。
  35. 内部会调用 [page:Color.set]( color )。
  36. </p>
  37. <h2>属性</h2>
  38. <p>有关共同属性,请参见基类 [page:ShaderMaterial]。</p>
  39. <h3>[property:Color color]</h3>
  40. <p>材质的 [page:Color] 颜色,默认设置为白色(0xffffff)。</p>
  41. <h3>[property:Boolean dashed]</h3>
  42. <p>线段是否为虚线。默认值为 `false`(实线)。</p>
  43. <h3>[property:number dashOffset]</h3>
  44. <p>虚线循环的起始偏移量。默认值为 `0`。</p>
  45. <h3>[property:number dashScale]</h3>
  46. <p>虚线和间隔的缩放比例。默认值为 `1`。</p>
  47. <h3>[property:number dashSize]</h3>
  48. <p>虚线的大小。默认值为 `1`。</p>
  49. <h3>[property:number gapSize]</h3>
  50. <p>间隔的大小。默认值为 `1`。</p>
  51. <h3>[property:Float linewidth]</h3>
  52. <p>当 [page:worldUnits] 为 `false`(默认值)时,以 CSS 像素单位控制线宽;当 [page:worldUnits] 为 `true` 时,以世界单位控制线宽。默认值为 `1`。</p>
  53. <h3>[property:Vector2 resolution]</h3>
  54. <p>
  55. 视口大小,以屏幕像素为单位。
  56. 必须保持更新以确保屏幕空间渲染的准确性。
  57. [page:LineSegments2.onBeforeRender] 回调函数会为可见对象执行更新。
  58. 默认值为 `[1, 1]`。
  59. </p>
  60. <h3>[property:Boolean worldUnits]</h3>
  61. <p>
  62. 材质的尺寸(宽度、虚线间隔)是否使用世界单位。
  63. 默认值为 `false`(使用屏幕空间单位)。
  64. </p>
  65. <h2>方法</h2>
  66. <p>有关共同方法,请参见基类 [page:ShaderMaterial]。</p>
  67. <h2>源代码</h2>
  68. <p>
  69. [link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/lines/LineMaterial.js examples/jsm/lines/LineMaterial.js]
  70. </p>
  71. </body>
  72. </html>
粤ICP备19079148号