File: Curve.html

package info (click to toggle)
three.js 111%2Bdfsg1-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 15,184 kB
  • sloc: javascript: 133,174; makefile: 24; sh: 1
file content (118 lines) | stat: -rw-r--r-- 4,130 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
<!DOCTYPE html>
<html lang="en">
	<head>
		<meta charset="utf-8" />
		<base href="../../../../" />
		<script src="list.js"></script>
		<script src="page.js"></script>
		<link type="text/css" rel="stylesheet" href="page.css" />
	</head>
	<body>
		<h1>[name]</h1>

		<p class="desc">
		An abstract base class for creating a [name] object that contains methods for interpolation.
		For an array of [name]s see [page:CurvePath].
		</p>

		<h2>Constructor</h2>


		<h3>[name]()</h3>
		<p>
		This constructor creates a new [name].
		</p>

		<h2>Properties</h2>

		<h3>[property:Integer arcLengthDivisions]</h3>
		<p>This value determines the amount of divisions when calculating the cumulative segment lengths of a curve via [page:.getLengths].
			To ensure precision when using methods like [page:.getSpacedPoints], it is recommended to increase [page:.arcLengthDivisions] if the curve is very large. Default is 200.</p>

		<h2>Methods</h2>

		<h3>[method:Vector getPoint]( [param:Float t], [param:Vector optionalTarget] )</h3>
		<p>
			[page:Float t] - A position on the curve. Must be in the range [ 0, 1 ]. <br>
			[page:Vector optionalTarget] — (optional) If specified, the result will be copied into this Vector,
			otherwise a new Vector will be created. <br /><br />

			Returns a vector for a given position on the curve.
		</p>

		<h3>[method:Vector getPointAt]( [param:Float u], [param:Vector optionalTarget] )</h3>
		<p>
			[page:Float u] - A position on the curve according to the arc length. Must be in the range [ 0, 1 ]. <br>
			[page:Vector optionalTarget] — (optional) If specified, the result will be copied into this Vector,
			otherwise a new Vector will be created. <br /><br />

			Returns a vector for a given position on the curve according to the arc length.
		</p>

		<h3>[method:Array getPoints]( [param:Integer divisions] )</h3>
		<p>
			divisions -- number of pieces to divide the curve into. Default is *5*.<br /><br />

			Returns a set of divisions + 1 points using getPoint( t ).
		</p>

		<h3>[method:Array getSpacedPoints]( [param:Integer divisions] )</h3>
		<p>
			divisions -- number of pieces to divide the curve into. Default is *5*.<br /><br />

			Returns a set of divisions + 1 equi-spaced points using getPointAt( u ).
		</p>

		<h3>[method:Float getLength]()</h3>
		<p>Get total curve arc length.</p>

		<h3>[method:Array getLengths]( [param:Integer divisions] )</h3>
		<p>Get list of cumulative segment lengths.</p>

		<h3>[method:null updateArcLengths]()</h3>
		<p>Update the cumlative segment distance cache.</p>

		<h3>[method:Float getUtoTmapping]( [param:Float u], [param:Float distance] )</h3>
		<p>
			Given u in the range ( 0 .. 1 ), returns [page:Float t] also in the range ( 0 .. 1 ).
			u and t can then be used to give you points which are equidistant from the ends of the curve,
			using [page:.getPoint].
		 </p>

		<h3>[method:Vector getTangent]( [param:Float t] )</h3>
		<p>
			Returns a unit vector tangent at t. If the derived curve does not implement its
			tangent derivation, two points a small delta apart will be used to find its gradient
			which seems to give a reasonable approximation.
		</p>

		<h3>[method:Vector getTangentAt]( [param:Float u] )</h3>
		<p>
			Returns tangent at a point which is equidistant to the ends of the curve from the
			point given in [page:.getTangent].
		</p>

		<h3>[method:Object computeFrenetFrames]( [param:Integer segments], [param:Boolean closed] )</h3>
		<p>
		Generates the Frenet Frames. Used in geometries like [page:TubeGeometry] or [page:ExtrudeGeometry].
		</p>

		<h3>[method:Curve clone]()</h3>
		<p>Creates a clone of this instance.</p>

		<h3>[method:Curve copy]( [param:Curve source] )</h3>
		<p>Copies another [name] object to this instance.</p>

		<h3>[method:Object toJSON]()</h3>
		<p>Returns a JSON object representation of this instance.</p>

		<h3>[method:Curve fromJSON]( [param:Object json] )</h3>
		<p>Copies the data from the given JSON object to this instance.</p>

		<h2>Source</h2>

		<p>
			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
		</p>
	</body>
</html>