Blend4Web.

User Manual
Release v17.12.0

Triumph LLC

December 29, 2017

 Contents

1 Overview 1
1.1 What’s Blend4Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 “About Engines” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.3 Graphics Engine, Game Engine . . . . . . . . . . . . . . . . . . . . . . . 1
1.4 What’s WebGL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.5 WebGL Browsers Support . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.6 Advantages of WebGL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.7 What’s Blender . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.8 3D Modeling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.9 Browser Technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.10 Interactive Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.11 Video Cards and Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2 Engine Features 6
3 Blender User Interface 13
3.1 3D View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.2 Timeline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.3 Graph Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.4 Dope Sheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.5 NLA Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.6 UV/Image Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.7 Video Sequence Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.8 Movie Clip Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.9 Text Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.10 Node Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3.11 Logic Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3.12 Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
3.13 Outliner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.14 User Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.15 Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.16 File Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
3.17 Python Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

i
4 Installing and Updating 32
4.1 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.2 Updating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
5 Workflow 39
5.1 Creating a New Project . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
5.2 Creating Scenes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
5.3 Preparing a Scene to Use in Blend4Web . . . . . . . . . . . . . . . . . . 42
5.4 Exporting Scenes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
5.5 Application Development . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.6 Project Building . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.7 Project Deploying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
6 Project Management 45
6.1 Project Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
6.2 Advanced Project Management . . . . . . . . . . . . . . . . . . . . . . . 62
7 Scene Viewer 70
7.1 Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
7.2 The Side Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
7.3 Indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
8 Web Player 84
8.1 Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
8.2 Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
8.3 Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
8.4 Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
8.5 Scene Name as Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
8.6 Scene Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
9 Add-on 90
9.1 Local Development Server . . . . . . . . . . . . . . . . . . . . . . . . . . 90
9.2 Running Viewer and Demos . . . . . . . . . . . . . . . . . . . . . . . . . 94
9.3 Export Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
9.4 Export Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
9.5 Initialization Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
9.6 Compatibility Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
9.7 Critical Export Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
9.8 Non-Critical Export Errors . . . . . . . . . . . . . . . . . . . . . . . . . 104
9.9 Other Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
9.10 Add-on Translations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
10 Scene Settings 113
10.1 Render Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
10.2 Scene Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
10.3 World Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
11 Objects 139
11.1 Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

ii
 11.2 Static and Dynamic Objects . . . . . . . . . . . . . . . . . . . . . . . . . 140
11.3 Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
11.4 Object Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
11.5 Anchor Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
11.6 Object Transform API . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
11.7 Get Object API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
11.8 Object Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
11.9 Copying Objects (Instancing) . . . . . . . . . . . . . . . . . . . . . . . . 154
11.10 Quaternions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
11.11 Moving via TSR Vectors . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
11.12 Line Rendering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
11.13 Levels Of Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
12 Meshes 164
12.1 Static and Dynamic Meshes . . . . . . . . . . . . . . . . . . . . . . . . . 164
12.2 Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
12.3 Morphing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
13 Normal Editor 168
13.1 Main Features of the Normal Editor . . . . . . . . . . . . . . . . . . . . 171
13.2 Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
13.3 Activate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
13.4 Show Normals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
13.5 Rotate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
13.6 Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
13.7 Absolute and Offset Modes . . . . . . . . . . . . . . . . . . . . . . . . . 174
13.8 Split Normals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
13.9 Average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
13.10 Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
13.11 3D Cursor, Axis and Face . . . . . . . . . . . . . . . . . . . . . . . . . . 177
13.12 Copy/Paste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
13.13 Copy From Mesh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
14 Camera 183
14.1 Move Styles and General Settings . . . . . . . . . . . . . . . . . . . . . . 183
14.2 Limiting the Camera Movement . . . . . . . . . . . . . . . . . . . . . . 185
14.3 Viewport Alignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
14.4 Camera Controls API . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
15 Materials 201
15.1 Lighting Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
15.2 Transparency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
15.3 Reflection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
15.4 Rendering Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
15.5 Viewport Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
15.6 Engine Specific Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 210
15.7 Halo Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
15.8 Material API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
15.9 Inherit Material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
iii
16 Material Library 217
16.1 Library Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
16.2 Material Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
16.3 Adding Material to a Scene . . . . . . . . . . . . . . . . . . . . . . . . . 223
17 Node Materials 226
17.1 Standard Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
17.2 Engine-Specific Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
17.3 Cycles Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
17.4 Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
18 Logic Editor 242
18.1 Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
18.2 Control Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
18.3 Animation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
18.4 Camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
18.5 Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
18.6 Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
18.7 Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
18.8 Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
18.9 Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
18.10 Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
18.11 Debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
18.12 Other Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
19 Lighting, Shadows and Background 287
19.1 Shading Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
19.2 Lighting with Light Sources . . . . . . . . . . . . . . . . . . . . . . . . . 289
19.3 Environment Lighting (Ambient) . . . . . . . . . . . . . . . . . . . . . . 290
19.4 Shadows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
19.5 Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
20 Postprocessing Effects 302
20.1 Motion Blur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
20.2 Depth of Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
20.3 Screen-Space Ambient Occlusion . . . . . . . . . . . . . . . . . . . . . . 305
20.4 God Rays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
20.5 Bloom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
20.6 Outlining . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
20.7 Glow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
20.8 Anti-Aliasing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
21 VR and AR 312
21.1 Virtual Reality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
21.2 Augmented Reality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
22 Textures 318
22.1 Texture Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
22.2 Generic Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319

iv
 22.3 Diffuse Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
22.4 Specular Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
22.5 Normal Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
22.6 Height Map. Parallax Mapping . . . . . . . . . . . . . . . . . . . . . . . 322
22.7 Stencil Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
22.8 Video Textures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
22.9 Environment Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
22.10 Mirror Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
22.11 Skydome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
22.12 Special Texture Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
23 Particle System. Fluids 336
23.1 Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
23.2 Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
23.3 Textures in Particle Systems . . . . . . . . . . . . . . . . . . . . . . . . 343
24 Particle System. Instancing 346
24.1 Particle System Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
24.2 Grass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
24.3 Tree Leaves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
25 Animation 358
25.1 Animation Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
25.2 Object Animation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
25.3 Skinning and Skeletal Animation . . . . . . . . . . . . . . . . . . . . . . 360
25.4 Vertex Animation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
25.5 Default Animation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
25.6 Non-Linear Animation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
25.7 Audio Source Parametrization . . . . . . . . . . . . . . . . . . . . . . . . 367
25.8 Animation of Value and RGB Nodes . . . . . . . . . . . . . . . . . . . . 367
26 Outdoor Effects 370
26.1 Water . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
26.2 Atmosphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
26.3 Lens Flare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
26.4 Wind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
27 Color Management 388
27.1 Gamma Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
27.2 Human Vision and Monitors . . . . . . . . . . . . . . . . . . . . . . . . 389
27.3 Gamma Formula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
27.4 Gamma in Node Materials . . . . . . . . . . . . . . . . . . . . . . . . . . 390
27.5 Alpha Compositing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
27.6 Color Correction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
28 Audio 393
28.1 Audio Source Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
28.2 Audio Mixer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
28.3 Processing and Decoding . . . . . . . . . . . . . . . . . . . . . . . . . . 398

v
29 Physics 399
29.1 Preparing for Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
29.2 Static Physics Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
29.3 Dynamic Physics Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
29.4 Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
29.5 Wheeled Vehicles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
29.6 Floating Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
29.7 Floating Vehicles aka Watercrafts . . . . . . . . . . . . . . . . . . . . . . 408
29.8 Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
29.9 Navigation Meshes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
29.10 Use in Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
30 For Application Developers 419
30.1 Application Development . . . . . . . . . . . . . . . . . . . . . . . . . . 419
30.2 Background Transparency . . . . . . . . . . . . . . . . . . . . . . . . . . 426
30.3 Resource Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
30.4 GZIP Compression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
30.5 Code Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
30.6 Loading Application Assets . . . . . . . . . . . . . . . . . . . . . . . . . 436
30.7 Event-Driven Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
30.8 SDK File Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
30.9 Loading Local Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
30.10 Quality Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
30.11 Non-Standard Canvas Position and Orientation . . . . . . . . . . . . . . 443
30.12 Mobile Web Apps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
31 For Engine Developers 446
31.1 Coding Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
31.2 Building the Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
31.3 Building the Add-on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
31.4 Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
31.5 Naming Functions and Variables . . . . . . . . . . . . . . . . . . . . . . 449
31.6 Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
31.7 Shader Compilation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
31.8 Updating Add-on Translations . . . . . . . . . . . . . . . . . . . . . . . 456
32 Team Work. Using Git 457
32.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
32.2 Typical Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
32.3 Individual Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
32.4 Checking the Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
32.5 Before the Commit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
32.6 Preparing for Commit . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
32.7 Commit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
32.8 Syncing Between Repositories . . . . . . . . . . . . . . . . . . . . . . . . 462
32.9 Resolving Conflicts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
32.10 Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
32.11 Other Useful Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 467

vi
33 Problems and Solutions 469
33.1 WebGL Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
33.2 Problems Upon Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
33.3 WebGL Failed to Initialize . . . . . . . . . . . . . . . . . . . . . . . . . 471
33.4 More In-Depth Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . 476
33.5 Known Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
34 Release Notes 479
34.1 v17.12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
34.2 v17.10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
34.3 v17.08 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
34.4 v17.06 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
34.5 v17.04 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
34.6 v17.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
34.7 v16.12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
34.8 v16.11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
34.9 v16.10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
34.10 v16.09 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
34.11 v16.08 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
34.12 v16.07 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
34.13 v16.06 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
34.14 v16.05 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
34.15 v16.04 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
34.16 v16.03 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
34.17 v16.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
34.18 v16.01 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
34.19 v15.12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
34.20 v15.11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
34.21 v15.10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
34.22 v15.09 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
34.23 v15.08 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
34.24 v15.07 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
34.25 v15.06 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
34.26 v15.05 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
34.27 v15.04 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
34.28 v15.03 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
34.29 v15.02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
34.30 v15.01 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565
34.31 v14.12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
34.32 v14.11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
34.33 v14.10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572
34.34 v14.09 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
Index 578

vii
viii
 CHAPTER 1

Overview

What’s Blend4Web

Blend4Web is a web-oriented 3D engine - a software framework for authoring and inter-

active rendering of three-dimensional graphics and audio in browsers.
The platform is intended for visualizations, presentations, online-shops, games and other
rich internet applications.
The Blend4Web framework is integrated tightly with Blender - a 3D modeling and ani-
mation tool (hence the name). The content is rendered by means of WebGL and other
browser technologies, without the use of plugins.
Technically Blend4Web is a library for web pages, a Blender add-on and some tools for
debugging and optimization.
The Blend4Web 3D engine has been developed by Triumph LLC employees since 2010.
The engine was first released on March 28 2014.

“About Engines”

An engine is a separate part of software code which is used by external applications for
implementing the required functionality.
Engine examples are: site engine, blog engine, online shop engine, wiki engine, search
engine, game engine etc. The economical reason for the existence of software engines is
multiple usage of the same functionality. For example developers may create relatively
cheap online shops or games using one or another engine.

Graphics Engine, Game Engine

A graphics engine performs special functions in displaying graphics. It is an intermediary

between:

1
 Blend4Web. User Manual, Release v17.12.0

• high-level application part (game logic, business logic) and

• low-level system part (for example, the graphics library WebGL and underlying
drivers).
A graphics engine may be combined with the sound system, the physics engine, the artifi-
cial intelligence system, the networking system and the scene and logic editors producing
a three-dimensional engine - an integrated environment for authoring 3D applications.

What’s WebGL

WebGL (Web Graphics Library) is one of the modern browser technologies which allows
authoring 3D graphics applications. In other words WebGL is “3D in a browser”.

WebGL Browsers Support

At the moment WebGL is supported in to a varying degree by all browsers.

Desktop Browsers
• Chrome
• Yandex Browser
• Firefox
• Opera
• Safari 8+
• Internet Explorer 11
• Microsoft Edge

Mobile Platforms
• Android
• BlackBerry
• Firefox OS
• iOS 8
• Sailfish OS
• Tizen
• Ubuntu Touch

1.4. What’s WebGL 2