-
Notifications
You must be signed in to change notification settings - Fork 0
/
threejs-pilot.js
162 lines (125 loc) · 4.37 KB
/
threejs-pilot.js
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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
/**
* three.js-pilot - Simple functions for diagnostic purposes or to kickstart a three.js app
*
* @author Nguyen Hoang Duong / [email protected]
*/
/* eslint no-unused-vars: "off" */
/**
* Add a mesh to a three.js scene
*
* Only the first parameter is required. Note that if you provide a geometry or
* a material to compose the mesh from, this function does not clone the
* geometry or the material, so provide clones if necessary.
*
* @param {object} scene The three.js scene to add the mesh to
* @param {object} geo The geometry for the mesh (optional, default to a cube)
* @param {object} mat The material for the mesh (optional, default to standard)
* @return {object} The mesh
*/
function addCube( scene, geo, mat ) {
let geometry = geo || new THREE.BoxBufferGeometry( 1, 1, 1 );
let material = mat || new THREE.MeshStandardMaterial( {
color: 0xaaaaaa
} );
let mesh = new THREE.Mesh( geometry, material );
scene.add( mesh );
return mesh;
}
/**
* Add a plane to a three.js scene
*
* Only the first parameter is required.
*
* @param {object} scene The three.js scene to add the plane to
* @param {object} geo The geometry for the plane (optional)
* @param {object} mat The material for the plane (optional)
* @return {object} The plane
*/
function addPlane( scene, geo, mat ) {
let geometry = geo || new THREE.PlaneBufferGeometry( 10, 10, 10, 10 );
let material = mat || new THREE.MeshBasicMaterial( {
color: 0x000000,
wireframe: true
} );
let plane = new THREE.Mesh( geometry, material );
plane.rotation.x = - Math.PI / 2;
scene.add( plane );
return plane;
}
/**
* Add a directional light to a three.js scene
*
* Only the first parameter is required.
*
* @param {object} scene The three.js scene to add the light to
* @param {object} position An object that has the properties x, y, and z
* @param {number} color Hexadecimal color of the light
* @param {number} intensity Numeric value of the light's intensity
* @param {boolean} helper Add a directional light helper too? (default to true)
* @return {object} An object that contains the light and its helper
*/
function addDirectionalLight( scene, position, color, intensity, helper = true ) {
position = position || { x: 5, y: 10, z: 7.5 };
color = color || 0xffffff;
intensity = intensity || 1;
let light = new THREE.DirectionalLight( color, intensity );
light.position.x = position.x;
light.position.y = position.y;
light.position.z = position.z;
helper = helper ? new THREE.DirectionalLightHelper( light ) : null;
scene.add( light, helper );
return { light, helper };
}
/**
* Add a point light to a three.js scene
*
* Only the first parameter is required.
*
* @param {object} scene The three.js scene to add the light to
* @param {object} position An object that has the properties x, y, and z
* @param {number} color Hexadecimal color of the light
* @param {number} intensity Numeric value of the light's intensity
* @param {number} distance Maximum range of the light
* @param {number} decay The amount the light dims along the distance of the light
* @param {boolean} helper Add a point light helper too? (default to true)
* @return {object} An object that contains the light and its helper
*/
function addPointLight( scene, position, color, intensity, distance, decay, helper = true ) {
position = position || { x: 5, y: 10, z: 7.5 };
color = color || 0xffffff;
intensity = intensity || 1;
distance = distance || 0;
decay = decay || 1;
let light = new THREE.PointLight( color, intensity, distance, decay );
light.position.x = position.x;
light.position.y = position.y;
light.position.z = position.z;
helper = helper ? new THREE.PointLightHelper( light ) : null;
scene.add( light, helper );
return { light, helper };
}
/**
* Add an AxesHelper to a three.js scene
*
* Only the first parameter is required.
*
* @param {object} scene The three.js scene to add the helper to
* @param {object} size The size of the lines representing the axes
* @return {object} The helper
*/
function addAxesHelper( scene, size = 1 ) {
let helper = new THREE.AxesHelper( size );
scene.add( helper );
return helper;
}
/**
* addPlane + addCube + addDirectionalLight + addAxesHelper (defaults)
*
* @param {object} scene The three.js scene to add objects to
*/
function kickstart( scene ) {
addPlane( scene );
addCube( scene );
addDirectionalLight( scene );
addAxesHelper( scene );
}