1
0

TextGeometry.html 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167
  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:BufferGeometry] &rarr; [page:ExtrudeGeometry] &rarr;
  11. <h1>文本缓冲几何体([name])</h1>
  12. <p class="desc">
  13. 一个用于将文本生成为单一的几何体的类。
  14. 它是由一串给定的文本,以及由加载的font(字体)和该几何体[page:ExtrudeGeometry]父类中的设置所组成的参数来构造的。
  15. 请参阅[page:FontLoader]页面来查看更多详细信息。
  16. </p>
  17. <h2>导入</h2>
  18. <p>
  19. [name] 是一个附加组件,必须显式导入。
  20. See [link:#manual/introduction/Installation Installation / Addons].
  21. </p>
  22. <code>
  23. import { TextGeometry } from 'three/addons/geometries/TextGeometry.js';
  24. </code>
  25. <h2>代码示例</h2>
  26. <code>
  27. const loader = new FontLoader();
  28. loader.load( 'fonts/helvetiker_regular.typeface.json', function ( font ) {
  29. const geometry = new TextGeometry( 'Hello three.js!', {
  30. font: font,
  31. size: 80,
  32. depth: 5,
  33. curveSegments: 12,
  34. bevelEnabled: true,
  35. bevelThickness: 10,
  36. bevelSize: 8,
  37. bevelSegments: 5
  38. } );
  39. } );
  40. </code>
  41. <h2>例子</h2>
  42. <p>
  43. [example:webgl_geometry_text geometry / text ]
  44. </p>
  45. <h2>构造器</h2>
  46. <h3>[name]([param:String text], [param:Object parameters])</h3>
  47. <p>
  48. text — 将要显示的文本。<br />
  49. parameters — 包含有下列参数的对象:
  50. <ul>
  51. <li>font — THREE.Font的实例。</li>
  52. <li>size — Float。字体大小,默认值为100。</li>
  53. <li>depth — Float。挤出文本的厚度。默认值为50。</li>
  54. <li>curveSegments — Integer。(表示文本的)曲线上点的数量。默认值为12。</li>
  55. <li>bevelEnabled — Boolean。是否开启斜角,默认为false。</li>
  56. <li>bevelThickness — Float。文本上斜角的深度,默认值为20。</li>
  57. <li>bevelSize — Float。斜角与原始文本轮廓之间的延伸距离。默认值为8。</li>
  58. <li>bevelSegments — Integer。斜角的分段数。默认值为3。</li>
  59. </ul>
  60. </p>
  61. <h2>可用的字体</h2>
  62. <p>
  63. 文本几何体使用 <a href='http://gero3.github.io/facetype.js/' target="_top">typeface.json</a>所生成的字体。
  64. 一些已有的字体可以在<b>/examples/fonts</b>中找到,且必须在页面中引入。
  65. </p>
  66. <table>
  67. <tr>
  68. <th>字体</th>
  69. <th>字重</th>
  70. <th>风格</th>
  71. <th>文件路径</th>
  72. </tr>
  73. <tr>
  74. <td>helvetiker</td>
  75. <td>normal</td>
  76. <td>normal</td>
  77. <td>/examples/fonts/helvetiker_regular.typeface.json</td>
  78. </tr>
  79. <tr>
  80. <td>helvetiker</td>
  81. <td>bold</td>
  82. <td>normal</td>
  83. <td>/examples/fonts/helvetiker_bold.typeface.json</td>
  84. </tr>
  85. <tr>
  86. <td>optimer</td>
  87. <td>normal</td>
  88. <td>normal</td>
  89. <td>/examples/fonts/optimer_regular.typeface.json</td>
  90. </tr>
  91. <tr>
  92. <td>optimer</td>
  93. <td>bold</td>
  94. <td>normal</td>
  95. <td>/examples/fonts/optimer_bold.typeface.json</td>
  96. </tr>
  97. <tr>
  98. <td>gentilis</td>
  99. <td>normal</td>
  100. <td>normal</td>
  101. <td>/examples/fonts/gentilis_regular.typeface.json</td>
  102. </tr>
  103. <tr>
  104. <td>gentilis</td>
  105. <td>bold</td>
  106. <td>normal</td>
  107. <td>/examples/fonts/gentilis_bold.typeface.json</td>
  108. </tr>
  109. <tr>
  110. <td>droid sans</td>
  111. <td>normal</td>
  112. <td>normal</td>
  113. <td>/examples/fonts/droid/droid_sans_regular.typeface.json</td>
  114. </tr>
  115. <tr>
  116. <td>droid sans</td>
  117. <td>bold</td>
  118. <td>normal</td>
  119. <td>/examples/fonts/droid/droid_sans_bold.typeface.json</td>
  120. </tr>
  121. <tr>
  122. <td>droid serif</td>
  123. <td>normal</td>
  124. <td>normal</td>
  125. <td>/examples/fonts/droid/droid_serif_regular.typeface.json</td>
  126. </tr>
  127. <tr>
  128. <td>droid serif</td>
  129. <td>bold</td>
  130. <td>normal</td>
  131. <td>/examples/fonts/droid/droid_serif_bold.typeface.json</td>
  132. </tr>
  133. </table>
  134. <h2>属性</h2>
  135. <p>共有属性请参见其基类[page:ExtrudeGeometry]。</p>
  136. <h3>[property:Object parameters]</h3>
  137. <p>
  138. 一个包含着构造函数中每个参数的对象。在对象实例化之后,对该属性的任何修改都不会改变这个几何体。
  139. </p>
  140. <h2>方法(Methods)</h2>
  141. <p>共有方法请参见其基类[page:ExtrudeGeometry]。</p>
  142. <h2>源代码</h2>
  143. <p>
  144. [link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/geometries/TextGeometry.js examples/jsm/geometries/TextGeometry.js]
  145. </p>
  146. </body>
  147. </html>