File: DrawModes.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 (79 lines) | stat: -rw-r--r-- 2,245 bytes parent folder | download | duplicates (2)
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
<!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>Draw Mode Constants</h1>

		<p class="desc">
			These are valid values for [page:Mesh.drawMode], and control how the list of vertices is interpeted once sent to the GPU.
		</p>

		<h2>Draw Modes</h2>

		<code>
			THREE.TrianglesDrawMode
		</code>
		<p>
			This is the default, and results in every three consecutive vertices (v0, v1, v2), (v3, v4, v5), ...
			being interpreted as a separate triangle. <br />
			If the number of vertices is not a multiple of 3, excess vertices are ignored.
		</p>

		<code>
			THREE.TriangleStripDrawMode
		</code>
		<p>
			This will result in a series of triangles connected in a strip, given by (v0, v1, v2), (v2, v1, v3), (v2, v3, v4), ...
			so that every subsequent triangle shares two vertices with the previous triangle.
		</p>

		<code>
			THREE.TriangleFanDrawMode
		</code>
		<p>
			This will result in a series of triangles each sharing the first vertex (like a fan),
			given by (v0, v1, v2), (v0, v2, v3), (v0, v3, v4), ... <br /><br />

			<em>Note:</em> As of [link:https://en.wikipedia.org/wiki/DirectX#DirectX_10 DirectX10], this mode is not supported. As Chrome and Firefox
			render WebGL using [link:https://en.wikipedia.org/wiki/ANGLE_(software) ANGLE] on Windows,
			internally this mode will be converted to a supported mode, which will likely lead to lowered
			performance on those browsers.
		</p>


		<h2>Usage</h2>

		<code>
		var geometry = new THREE.BufferGeometry();

		var vertices = [];

		vertices.push( -10,  10, 0 );
		vertices.push( -10, -10, 0 );
		vertices.push(  10, -10, 0 );

		// ...

		geometry.addAttribute( 'position', new THREE.Float32BufferAttribute( vertices, 3 ) );

		var material = new THREE.MeshBasicMaterial( { color: 0xffff00 } );

		var mesh = new THREE.Mesh( geometry, material );
		mesh.drawMode = THREE.TrianglesDrawMode; //default

		scene.add( mesh );
		</code>

		<h2>Source</h2>

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