Path.html 5.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150
  1. <!DOCTYPE html>
  2. <html lang="it">
  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:Curve] &rarr; [page:CurvePath] &rarr;
  11. <h1>[name]</h1>
  12. <p class="desc">
  13. Una rappresentazione del percorso 2D. La classe mette a dispozione metodi per la
  14. creazione di tracciati e contorni di forme 2D simili all'API Canvas 2D.
  15. </p>
  16. <h2>Codice di Esempio</h2>
  17. <code>
  18. const path = new THREE.Path();
  19. path.lineTo( 0, 0.8 );
  20. path.quadraticCurveTo( 0, 1, 0.2, 1 );
  21. path.lineTo( 1, 1 );
  22. const points = path.getPoints();
  23. const geometry = new THREE.BufferGeometry().setFromPoints( points );
  24. const material = new THREE.LineBasicMaterial( { color: 0xffffff } );
  25. const line = new THREE.Line( geometry, material );
  26. scene.add( line );
  27. </code>
  28. <h2>Costruttore</h2>
  29. <h3>[name]( [param:Array points] )</h3>
  30. <p>
  31. points -- (opzionale) array di [page:Vector2 Vector2].<br /><br />
  32. Crea un Path dai punti. Il primo punto definisce l'offset, quindi i punti successivi sono
  33. aggiunti all'array [page:CurvePath.curves curves] come [page:LineCurve LineCurves].<br /><br />
  34. Se non ci sono punti specificati, viene creato un path vuoto e il [page:.currentPoint] viene impostato
  35. nell'origine.
  36. </p>
  37. <h2>Proprietà</h2>
  38. <p>Vedi la classe base [page:CurvePath] per le proprietà comuni.</p>
  39. <h3>[property:Vector2 currentPoint]</h3>
  40. <p>L'offset corrente del path. Qualsiasi nuova [page:Curve] aggiunta inizierà da qui.</p>
  41. <h2>Metodi</h2>
  42. <p>Vedi la classe base [page:CurvePath] per i metodi comuni.</p>
  43. <h3>[method:this absarc]( [param:Float x], [param:Float y], [param:Float radius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise] )</h3>
  44. <p>
  45. x, y -- Il centro assoluto dell'arco.<br />
  46. radius -- Il raggio dell'arco.<br />
  47. startAngle -- L'angolo iniziale in radianti.<br />
  48. endAngle -- L'angolo finale in radianti.<br />
  49. clockwise -- Scorre l'arco in senso orario. Il valore predefinito è `false`.<br /><br />
  50. Aggiunge al path un'[page:EllipseCurve EllipseCurve] posizionata in modo assoluto.
  51. </p>
  52. <h3>[method:this absellipse]( [param:Float x], [param:Float y], [param:Float xRadius], [param:Float yRadius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise], [param:Float rotation] )</h3>
  53. <p>
  54. x, y -- Il centro assoluto dell'ellisse.<br />
  55. xRadius -- Il raggio dell'ellisse nell'asse x.<br />
  56. yRadius -- Il raggio dell'ellisse nell'asse y.<br />
  57. startAngle -- L'angolo iniziale in radianti.<br />
  58. endAngle -- L'angolo finale in radianti.<br />
  59. clockwise -- Scorre l'ellisse in senso orario. Il valore predefinito è `false`.<br />
  60. rotation -- L'angolo di rotazione dell'ellisse in radianti, in senso antiorario dall'asse X. Opzionale, il valore predefinito è 0.<br /><br />
  61. Aggiunge al path un'[page:EllipseCurve EllipseCurve] posizionata in modo assoluto.
  62. </p>
  63. <h3>[method:this arc]( [param:Float x], [param:Float y], [param:Float radius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise] )</h3>
  64. <p>
  65. x, y -- Il centro dell'arco offsettato dall'ultima chiamata.<br />
  66. radius -- Il raggio dell'arco.<br />
  67. startAngle -- L'angolo iniziale in radianti.<br />
  68. endAngle -- L'angolo finale in radianti.<br />
  69. clockwise -- Scorre l'arco in senso orario. Il valore predefinito è `false`.<br /><br />
  70. Aggiunge al path un'[page:EllipseCurve EllipseCurve] posizionata in modo relativo al [page:.currentPoint].
  71. </p>
  72. <h3>[method:this bezierCurveTo]( [param:Float cp1X], [param:Float cp1Y], [param:Float cp2X], [param:Float cp2Y], [param:Float x], [param:Float y] )</h3>
  73. <p>
  74. Crea una curva bezier da [page:.currentPoint] con (cp1X, cp1Y) e (cp2X, cp2Y) come punti di controllo e aggiorna [page:.currentPoint] a x e y.
  75. </p>
  76. <h3>[method:this ellipse]( [param:Float x], [param:Float y], [param:Float xRadius], [param:Float yRadius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise], [param:Float rotation] )</h3>
  77. <p>
  78. x, y -- Il centro dell'arco offsettato dall'ultima chiamata.<br />
  79. xRadius -- Il raggio dell'ellisse nell'asse x.<br />
  80. yRadius -- Il raggio dell'ellisse nell'asse y.<br />
  81. startAngle -- L'angolo iniziale in radianti.<br />
  82. endAngle -- L'angolo finale in radianti.<br />
  83. clockwise -- Scorre l'arco in senso orario. Il valore predefinito è `false`.<br /><br />
  84. rotation -- L'angolo di rotazione dell'ellisse in radianti, in senso antiorario dall'asse X. Opzionale, il valore predefinito è 0.<br /><br />
  85. Aggiunge al path un'[page:EllipseCurve EllipseCurve] posizionata in modo relativo al [page:.currentPoint].
  86. </p>
  87. <h3>[method:this lineTo]( [param:Float x], [param:Float y] )</h3>
  88. <p>Collega una [page:LineCurve] da il [page:.currentPoint] a x, y sul percorso.</p>
  89. <h3>[method:this moveTo]( [param:Float x], [param:Float y] )</h3>
  90. <p>Muove il [page:.currentPoint] a x, y.</p>
  91. <h3>[method:this quadraticCurveTo]( [param:Float cpX], [param:Float cpY], [param:Float x], [param:Float y] )</h3>
  92. <p>
  93. Crea una curva quadratica da [page:.currentPoint] con cpX e cpY come punto di controllo e aggiorna [page:.currentPoint] a x e y.
  94. </p>
  95. <h3>[method:this setFromPoints]( [param:Array vector2s] )</h3>
  96. <p>
  97. points -- array di [page:Vector2 Vector2].<br /><br />
  98. I punti vengono aggiunti all'array [page:CurvePath.curves curves] come [page:LineCurve LineCurves].
  99. </p>
  100. <h3>[method:this splineThru] ( [param:Array points] ) </h3>
  101. <p>
  102. points - array di [page:Vector2 Vector2].<br /><br />
  103. Collega un nuovo [page:SplineCurve] al percorso.
  104. </p>
  105. <h2>Source</h2>
  106. <p>
  107. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  108. </p>
  109. </body>
  110. </html>