Contents

Overview

1.1

Whats Blend4Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.2

About Engines

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.3

Graphics Engine, Game Engine . . . . . . . . . . . . . . . . . . . . . . .

1.4

Whats WebGL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.5

WebGL Browsers Support . . . . . . . . . . . . . . . . . . . . . . . . . .

1.6

Advantages of WebGL . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.7

Whats Blender . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.8

3D Modeling

1.9

Browser Technologies

. . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.10

Interactive Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.11

Video Cards and Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Engine Features

Installing and Updating

13

3.1

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13

3.2

Updating

16

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Workflow

19

4.1

Authoring Scenes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

19

4.2

Exporting Scenes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

20

4.3

Displaying Scenes in the Viewer . . . . . . . . . . . . . . . . . . . . . . .

21

4.4

Application Development

23

. . . . . . . . . . . . . . . . . . . . . . . . . .

Project Manager

24

5.1

Project Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

25

5.2

Project Creation Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . .

27

5.3

Creating a Web Player Application . . . . . . . . . . . . . . . . . . . . .

30

5.4

Project Information

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

31

5.5

Project Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

33

5.6

Project Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

33

Scene Viewer
6.1

Navigation

35
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

36

6.2

The Side Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

36

6.3

Indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

47

Web Player

49

7.1

Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

51

7.2

Navigation

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

51

7.3

Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

51

7.4

Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

52

7.5

Scene Name as Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

53

7.6

Scene Errors

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

53

Add-on

55

8.1

Local Development Server . . . . . . . . . . . . . . . . . . . . . . . . . .

55

8.2

Running Viewer and Demos . . . . . . . . . . . . . . . . . . . . . . . . .

58

8.3

Export Formats

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

59

8.4

Export Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

60

8.5

Initialization Errors

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

65

8.6

Compatibility Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

66

8.7

Critical Export Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . .

68

8.8

Non-Critical Export Errors

. . . . . . . . . . . . . . . . . . . . . . . . .

71

8.9

Other Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

76

8.10

Add-on Translations . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

76

Scene Settings

79

9.1

Render Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

81

9.2

Scene Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

88

9.3

World Panel

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

95

10 Objects

100

10.1

Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

100

10.2

Static and Dynamic Objects . . . . . . . . . . . . . . . . . . . . . . . . .

101

10.3

Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

102

10.4

Anchor Settings

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

107

10.5

Object Transform API . . . . . . . . . . . . . . . . . . . . . . . . . . . .

109

10.6

Get Object API

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

110

10.7

Object Selection

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

111

10.8

Copying Objects (Instancing) . . . . . . . . . . . . . . . . . . . . . . . .

112

10.9

Quaternions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

113

10.10 Differences Between Coordinate Systems of Blender and Blend4Web

. .

115

10.11 Moving via TSR Vectors . . . . . . . . . . . . . . . . . . . . . . . . . . .

116

11 Meshes

117

11.1

Static and Dynamic Meshes . . . . . . . . . . . . . . . . . . . . . . . . .

117

11.2

Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

118

11.3

Morphing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

119

12 Normal Editor

121

12.1

Main Features of the Normal Editor

. . . . . . . . . . . . . . . . . . . .

124

12.2

Interface

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

124

ii

12.3

Activate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

124

12.4

Show Normals

125

12.5

Rotation

12.6

Absolute and Offset Modes

. . . . . . . . . . . . . . . . . . . . . . . . .

126

12.7

Split Normals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

127

12.8

Average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

128

12.9

Restore

128

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

125

12.10 Tree, Foliage and Face . . . . . . . . . . . . . . . . . . . . . . . . . . . .

129

12.11 Copy/Paste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

131

12.12 Copy From Mesh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

132

13 Camera

135

13.1

Move Styles and General Settings . . . . . . . . . . . . . . . . . . . . . .

135

13.2

Limiting the Camera Movement

. . . . . . . . . . . . . . . . . . . . . .

137

13.3

Viewport Alignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

145

13.4

Camera Controls API

. . . . . . . . . . . . . . . . . . . . . . . . . . . .

146

14.1

Lighting Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

154

14.2

Transparency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

155

14.3

Reflection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

157

14.4

Rendering Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

160

14.5

Viewport Properties

14.6

Engine Specific Parameters

14.7

Halo Materials

14 Materials

153

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

161

. . . . . . . . . . . . . . . . . . . . . . . . .

161

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

162

15 Material Library

164

15.1

Library Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

164

15.2

Material Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

166

15.3

Adding Material to a Scene

. . . . . . . . . . . . . . . . . . . . . . . . .

170

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

174

16 Node Materials

173

16.1

Standard Nodes

16.2

Engine-Specific Nodes

. . . . . . . . . . . . . . . . . . . . . . . . . . . .

17 Logic Editor

175
187

17.1

Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

187

17.2

Control Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

190

17.3

Animation

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

196

17.4

Camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

199

17.5

Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

200

17.6

Operations

208

17.7

Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

212

17.8

Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

213

17.9

Debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

217

17.10 Deprecated
17.11 Layout

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

218

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

219

17.12 Debugging

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

220

iii

18 Lighting, Shadows and Background

221

18.1

Shading Types

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

221

18.2

Lighting with Light Sources . . . . . . . . . . . . . . . . . . . . . . . . .

223

18.3

Environment Lighting (Ambient) . . . . . . . . . . . . . . . . . . . . . .

224

18.4

Shadows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

226

18.5

Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

233

19 Postprocessing Effects

236

19.1

Motion Blur

19.2

Depth of Field

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

236

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

237

19.3

Screen-Space Ambient Occlusion

. . . . . . . . . . . . . . . . . . . . . .

239

19.4

God Rays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

240

19.5

Bloom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

241

19.6

Outlining . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

242

19.7

Glow

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

243

19.8

Anti-Aliasing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

244

20 Stereo Rendering

246

20.1

Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

247

20.2

Additional Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

248

20.3

HMD Settings

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

248

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

251

21 Textures

251

21.1

Texture Types

21.2

Generic Settings

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

252

21.3

Diffuse Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

253

21.4

Specular Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

254

21.5

Normal Map

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

254

21.6

Height Map. Parallax Mapping . . . . . . . . . . . . . . . . . . . . . . .

254

21.7

Stencil Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

256

21.8

Video Textures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

258

21.9

Environment Map

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

260

21.10 Mirror Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

262

21.11 Skydome

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

263

21.12 Special Texture Types . . . . . . . . . . . . . . . . . . . . . . . . . . . .

265

22 Particle System. Fluids

269

22.1

Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

270

22.2

Setup

271

22.3

Textures in Particle Systems

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .

23 Particle System. Instancing

276
279

23.1

Particle System Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . .

281

23.2

Grass

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

286

23.3

Tree Leaves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

287

24 Animation

291

24.1

Animation Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

292

24.2

Object Animation

292

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

iv

24.3

Skinning and Skeletal Animation . . . . . . . . . . . . . . . . . . . . . .

293

24.4

Vertex Animation

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

295

24.5

Default Animation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

297

24.6

Non-Linear Animation . . . . . . . . . . . . . . . . . . . . . . . . . . . .

297

24.7

Audio Source Parametrization . . . . . . . . . . . . . . . . . . . . . . . .

299

24.8

Animation of Value and RGB Nodes . . . . . . . . . . . . . . . . . . . .

299

25 Outdoor Effects

302

25.1

Water . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

303

25.2

Atmosphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

311

25.3

Lens Flare

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

314

25.4

Wind

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

316

26 Color Management

320

26.1

Gamma Overview

26.2

Human Vision and Monitors

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .

321

26.3

Gamma Formula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

321

26.4

Gamma in Node Materials . . . . . . . . . . . . . . . . . . . . . . . . . .

322

26.5

Alpha Compositing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

323

26.6

Color Correction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

324

27 Audio

320

325

27.1

Audio Source Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . .

326

27.2

Audio Mixer

329

27.3

Processing and Decoding

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . .

330

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

331

28 Physics

331

28.1

Preparing for Use

28.2

Static Physics Type

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

332

28.3

Dynamic Physics Type . . . . . . . . . . . . . . . . . . . . . . . . . . . .

333

28.4

Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

335

28.5

Wheeled Vehicles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

337

28.6

Floating Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

339

28.7

Floating Vehicles aka Watercrafts . . . . . . . . . . . . . . . . . . . . . .

340

28.8

Characters

341

28.9

Use in Applications

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

343

29.1

Project Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

345

29.2

Advanced Project Management . . . . . . . . . . . . . . . . . . . . . . .

346

29.3

Application Programming . . . . . . . . . . . . . . . . . . . . . . . . . .

352

29.4

Resource Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

355

29.5

Code Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

359

29.6

Event-Driven Model

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

359

29.7

SDK File Structure

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

361

29.8

Loading Local Resources . . . . . . . . . . . . . . . . . . . . . . . . . . .

363

29.9

Quality Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

364

29.10 Non-FullScreen Web Apps . . . . . . . . . . . . . . . . . . . . . . . . . .

365

29 For Application Developers

344