TextGeometry.html 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176
  1. <!DOCTYPE html>
  2. <html lang="en">
  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. A class for generating text as a single geometry. It is constructed by providing a string of text, and a hash of
  14. parameters consisting of a loaded [page:Font] and settings for the geometry's parent [page:ExtrudeGeometry].
  15. See the [page:Font], [page:FontLoader] and [page:Creating_Text] pages for additional details.
  16. </p>
  17. <iframe id="scene" src="scenes/geometry-browser.html#TextGeometry"></iframe>
  18. <script>
  19. // iOS iframe auto-resize workaround
  20. if ( /(iPad|iPhone|iPod)/g.test( navigator.userAgent ) ) {
  21. const scene = document.getElementById( 'scene' );
  22. scene.style.width = getComputedStyle( scene ).width;
  23. scene.style.height = getComputedStyle( scene ).height;
  24. scene.setAttribute( 'scrolling', 'no' );
  25. }
  26. </script>
  27. <h2>Code Example</h2>
  28. <code>
  29. const loader = new THREE.FontLoader();
  30. loader.load( 'fonts/helvetiker_regular.typeface.json', function ( font ) {
  31. const geometry = new THREE.TextGeometry( 'Hello three.js!', {
  32. font: font,
  33. size: 80,
  34. height: 5,
  35. curveSegments: 12,
  36. bevelEnabled: true,
  37. bevelThickness: 10,
  38. bevelSize: 8,
  39. bevelOffset: 0,
  40. bevelSegments: 5
  41. } );
  42. } );
  43. </code>
  44. <h2>Examples</h2>
  45. <p>
  46. [example:webgl_geometry_text geometry / text ]
  47. </p>
  48. <h2>Constructor</h2>
  49. <h3>[name]([param:String text], [param:Object parameters])</h3>
  50. <p>
  51. text — The text that needs to be shown. <br />
  52. parameters — Object that can contains the following parameters.
  53. <ul>
  54. <li>font — an instance of THREE.Font.</li>
  55. <li>size — Float. Size of the text. Default is 100.</li>
  56. <li>height — Float. Thickness to extrude text. Default is 50.</li>
  57. <li>curveSegments — Integer. Number of points on the curves. Default is 12.</li>
  58. <li>bevelEnabled — Boolean. Turn on bevel. Default is False.</li>
  59. <li>bevelThickness — Float. How deep into text bevel goes. Default is 10.</li>
  60. <li>bevelSize — Float. How far from text outline is bevel. Default is 8.</li>
  61. <li>bevelOffset — Float. How far from text outline bevel starts. Default is 0.</li>
  62. <li>bevelSegments — Integer. Number of bevel segments. Default is 3.</li>
  63. </ul>
  64. </p>
  65. <h2>Available Fonts</h2>
  66. <p>
  67. TextGeometry uses <a href='http://gero3.github.io/facetype.js/' target="_top">typeface.json</a> generated fonts.
  68. Some existing fonts can be found located in <b>/examples/fonts</b> and must be included in the page.
  69. </p>
  70. <table>
  71. <tr>
  72. <th>Font</th>
  73. <th>Weight</th>
  74. <th>Style</th>
  75. <th>File Path</th>
  76. </tr>
  77. <tr>
  78. <td>helvetiker</td>
  79. <td>normal</td>
  80. <td>normal</td>
  81. <td>/examples/fonts/helvetiker_regular.typeface.json</td>
  82. </tr>
  83. <tr>
  84. <td>helvetiker</td>
  85. <td>bold</td>
  86. <td>normal</td>
  87. <td>/examples/fonts/helvetiker_bold.typeface.json</td>
  88. </tr>
  89. <tr>
  90. <td>optimer</td>
  91. <td>normal</td>
  92. <td>normal</td>
  93. <td>/examples/fonts/optimer_regular.typeface.json</td>
  94. </tr>
  95. <tr>
  96. <td>optimer</td>
  97. <td>bold</td>
  98. <td>normal</td>
  99. <td>/examples/fonts/optimer_bold.typeface.json</td>
  100. </tr>
  101. <tr>
  102. <td>gentilis</td>
  103. <td>normal</td>
  104. <td>normal</td>
  105. <td>/examples/fonts/gentilis_regular.typeface.json</td>
  106. </tr>
  107. <tr>
  108. <td>gentilis</td>
  109. <td>bold</td>
  110. <td>normal</td>
  111. <td>/examples/fonts/gentilis_bold.typeface.json</td>
  112. </tr>
  113. <tr>
  114. <td>droid sans</td>
  115. <td>normal</td>
  116. <td>normal</td>
  117. <td>/examples/fonts/droid/droid_sans_regular.typeface.json</td>
  118. </tr>
  119. <tr>
  120. <td>droid sans</td>
  121. <td>bold</td>
  122. <td>normal</td>
  123. <td>/examples/fonts/droid/droid_sans_bold.typeface.json</td>
  124. </tr>
  125. <tr>
  126. <td>droid serif</td>
  127. <td>normal</td>
  128. <td>normal</td>
  129. <td>/examples/fonts/droid/droid_serif_regular.typeface.json</td>
  130. </tr>
  131. <tr>
  132. <td>droid serif</td>
  133. <td>bold</td>
  134. <td>normal</td>
  135. <td>/examples/fonts/droid/droid_serif_bold.typeface.json</td>
  136. </tr>
  137. </table>
  138. <h2>Properties</h2>
  139. <p>See the base [page:ExtrudeGeometry] class for common properties.</p>
  140. <h3>[property:Object parameters]</h3>
  141. <p>
  142. An object with a property for each of the constructor parameters. Any modification after instantiation does not change the geometry.
  143. </p>
  144. <h2>Methods</h2>
  145. <p>See the base [page:ExtrudeGeometry] class for common methods.</p>
  146. <h2>Source</h2>
  147. <p>
  148. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  149. </p>
  150. </body>
  151. </html>