LineSegments2.html 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>LineSegments2 - Three.js Docs</title>
  6. <meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
  7. <script src="../scripts/highlight.min.js"></script>
  8. <link type="text/css" rel="stylesheet" href="../styles/highlight-three.css">
  9. <link type="text/css" rel="stylesheet" href="../styles/page.css">
  10. </head>
  11. <body>
  12. <p class="inheritance" translate="no"><a href="EventDispatcher.html">EventDispatcher</a> → <a href="Object3D.html">Object3D</a> → <a href="Mesh.html">Mesh</a> → </p>
  13. <h1 translate="no">LineSegments2</h1>
  14. <section>
  15. <header>
  16. <div class="class-description"><p>A series of lines drawn between pairs of vertices.</p>
  17. <p>This adds functionality beyond <a href="LineSegments.html">LineSegments</a>, like arbitrary line width and changing width
  18. to be in world units. <a href="Line2.html">Line2</a> extends this object, forming a polyline instead of individual
  19. segments.</p>
  20. <p>This module can only be used with <a href="WebGLRenderer.html">WebGLRenderer</a>. When using <a href="WebGPURenderer.html">WebGPURenderer</a>,
  21. import the class from <code>lines/webgpu/LineSegments2.js</code>.</p></div>
  22. <h2>Code Example</h2>
  23. <div translate="no"><pre><code class="language-js">const geometry = new LineSegmentsGeometry();
  24. geometry.setPositions( positions );
  25. geometry.setColors( colors );
  26. const material = new LineMaterial( { linewidth: 5, vertexColors: true } };
  27. const lineSegments = new LineSegments2( geometry, material );
  28. scene.add( lineSegments );
  29. </code></pre></div>
  30. </header>
  31. <article>
  32. <h2 class="subsection-title">Import</h2>
  33. <p><span translate="no">LineSegments2</span> is an addon, and must be imported explicitly, see <a href="https://threejs.org/manual/#en/installation" target="_blank" rel="noopener">Installation#Addons</a>.</p>
  34. <pre><code class="language-js">import { LineSegments2 } from 'three/addons/lines/LineSegments2.js';</code></pre>
  35. <div class="container-overview">
  36. <h2>Constructor</h2>
  37. <h3 class="name name-method" id="LineSegments2" translate="no">new <a href="#LineSegments2">LineSegments2</a><span class="signature">( geometry : <span class="param-type"><a href="LineSegmentsGeometry.html">LineSegmentsGeometry</a></span>, material : <span class="param-type"><a href="LineMaterial.html">LineMaterial</a></span> )</span> </h3>
  38. <div class="method">
  39. <div class="description">
  40. <p>Constructs a new wide line.</p>
  41. </div>
  42. <table class="params">
  43. <tbody>
  44. <tr>
  45. <td class="name">
  46. <strong>geometry</strong>
  47. </td>
  48. <td class="description last">
  49. <p>The line geometry.</p>
  50. </td>
  51. </tr>
  52. <tr>
  53. <td class="name">
  54. <strong>material</strong>
  55. </td>
  56. <td class="description last">
  57. <p>The line material.</p>
  58. </td>
  59. </tr>
  60. </tbody>
  61. </table>
  62. </div>
  63. </div>
  64. <h2 class="subsection-title">Properties</h2>
  65. <div class="member">
  66. <h3 class="name" id="isLineSegments2" translate="no">.<a href="#isLineSegments2">isLineSegments2</a><span class="type-signature"> : boolean</span> <span class="type-signature">(readonly) </span></h3>
  67. <div class="description">
  68. <p>This flag can be used for type testing.</p>
  69. <p>Default is <code>true</code>.</p>
  70. </div>
  71. </div>
  72. <h2 class="subsection-title">Methods</h2>
  73. <h3 class="name name-method" id="computeLineDistances" translate="no">.<a href="#computeLineDistances">computeLineDistances</a><span class="signature">()</span><span class="type-signature"> : <a href="LineSegments2.html">LineSegments2</a></span> </h3>
  74. <div class="method">
  75. <div class="description">
  76. <p>Computes an array of distance values which are necessary for rendering dashed lines.
  77. For each vertex in the geometry, the method calculates the cumulative length from the
  78. current point to the very beginning of the line.</p>
  79. </div>
  80. <dl class="details">
  81. <dt class="tag-returns"><strong>Returns:</strong> A reference to this instance.</dt>
  82. </dl>
  83. </div>
  84. <h3 class="name name-method" id="raycast" translate="no">.<a href="#raycast">raycast</a><span class="signature">( raycaster : <span class="param-type"><a href="Raycaster.html">Raycaster</a></span>, intersects : <span class="param-type">Array.&lt;Object></span> )</span> </h3>
  85. <div class="method">
  86. <div class="description">
  87. <p>Computes intersection points between a casted ray and this instance.</p>
  88. </div>
  89. <table class="params">
  90. <tbody>
  91. <tr>
  92. <td class="name">
  93. <strong>raycaster</strong>
  94. </td>
  95. <td class="description last">
  96. <p>The raycaster.</p>
  97. </td>
  98. </tr>
  99. <tr>
  100. <td class="name">
  101. <strong>intersects</strong>
  102. </td>
  103. <td class="description last">
  104. <p>The target array that holds the intersection points.</p>
  105. </td>
  106. </tr>
  107. </tbody>
  108. </table>
  109. <dl class="details">
  110. <dt class="tag-overrides"><strong>Overrides:</strong> <a href="Mesh.html#raycast">Mesh#raycast</a></dt>
  111. </dl>
  112. </div>
  113. <h2 class="subsection-title">Source</h2>
  114. <p>
  115. <a href="https://github.com/mrdoob/three.js/blob/master/examples/jsm/lines/LineSegments2.js" translate="no" target="_blank" rel="noopener">examples/jsm/lines/LineSegments2.js</a>
  116. </p>
  117. </article>
  118. </section>
  119. <script src="../scripts/linenumber.js"></script>
  120. <script src="../scripts/page.js"></script>
  121. </body>
  122. </html>
粤ICP备19079148号