You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/tutorial-history.md
+31Lines changed: 31 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,6 +5,37 @@
5
5
<aid=Version_History></a>
6
6
## Version History
7
7
8
+
Version 2.0.0-beta2:
9
+
10
+
The changes in beta 2 from beta 1 include:
11
+
12
+
- Added H3DU.PbrMaterial class and supported physically-based shading in the default shader.
13
+
- H3DU.Shape objects contain H3DU.PbrMaterial by default.
14
+
- Extras folder contains a glTF loader, which is preliminary and incomplete.
15
+
- H3DU.Scene3D will create a WebGL 2 rendering context if possible and supported by the browser.
16
+
- H3DU.MeshBuffer stores vertex data by semantic (such as position, normal or texture coordinates), rather than by name.
17
+
- The new H3DU.Semantic class contains constants for attribute and uniform semantics.
18
+
- The new H3DU.TextureInfo class is a lightweight class for storing a texture's settings, but not its data.
19
+
- H3DU.ShaderInfo class can now accept H3DU.TextureInfo objects as uniform values.
20
+
- H3DU.Material can accept a parameter object in the constructor as it can in the setParams method, similarly to the
21
+
new H3DU.PbrMaterial class.
22
+
- Added fromBasic and fromBasicTexture methods to H3DU.Material class.
23
+
- Many new methods were added to the H3DU.Math class, including methods to add and
24
+
subtract 4-element vectors, to clamp vectors, and to convert to and from linear RGB colors,
25
+
as well as vec3proj, vec4proj, mat3invert, and vec3fromWindowPoint methods.
26
+
The frustumHasBox method was improved.
27
+
- The shapeCount, getShape, setShape, and copy methods were added to H3DU.ShapeGroup.
28
+
- New H3DU.CubeMap class holds information on the textures that make up a cube map.
29
+
However, cube maps are not yet supported in the default shader (its code is
30
+
currently commented out)
31
+
- In the H3DU.GraphicsPath extra, added methods for high-level shapes and path
32
+
interpolation and improved code on path triangulation.
33
+
- H3DU.TextFont extra supports multichannel signed distance field fonts.
34
+
- Several new demos were added.
35
+
- Some methods were removed: setMaterialParams methods from both H3DU.Shape and H3DU.ShapeGroup; mapTexture and mapTexturesAll methods from TextureLoader; forShader method from H3DU.Material.
36
+
- Renamed setOrientation and multOrientation in H3DU.Transform to setRotation and multRotation, and deprecated the old names.
37
+
- Bug fixes.
38
+
8
39
Version 2.0.0-beta1:
9
40
10
41
There are many, many changes to version 2.0.0-beta1 from version 1.5.1. Here are some of them, including the most important ones.
Copy file name to clipboardExpand all lines: doc/tutorial-overview.md
+41-5Lines changed: 41 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,6 +13,8 @@ The library differs from many others because this one is in the public domain, s
13
13
14
14
This page includes information on how to use the HTML 3D library, an overview of its features, and an example of a simple 3D-enabled Web page.
15
15
16
+
NOTE: This section and the rest of this page will largely discuss the 2.0.0-beta2 version of the HTML 3D library, which differs considerably from the current release (version 1.5.1) of the library. (See the section "History" for more information.)
17
+
16
18
<aid=Example></a>
17
19
## Example
18
20
@@ -21,7 +23,7 @@ This page includes information on how to use the HTML 3D library, an overview of
21
23
<aid=Contents></a>
22
24
## Contents
23
25
24
-
[Public-Domain HTML 3D Library](#Public_Domain_HTML_3D_Library)<br>[Example](#Example)<br>[Contents](#Contents)<br>[How to Use](#How_to_Use)<br> [List of Classes](#List_of_Classes)<br> [`H3DU.Scene3D`](#H3DU_Scene3D)<br> [The "Camera"](#The_Camera)<br> [3D Models](#3D_Models)<br> [Shapes](#Shapes)<br> [The Render Loop](#The_Render_Loop)<br>[A Skeleton for 3D Apps](#A_Skeleton_for_3D_Apps)<br>[Demos](#Demos)<br> [Simple Demos](#Simple_Demos)<br> [Materials](#Materials)<br> [Shapes and meshes](#Shapes_and_meshes)<br> [Paths](#Paths)<br> [Curves and Surfaces](#Curves_and_Surfaces)<br> [Textures](#Textures)<br> [Shaders](#Shaders)<br> [Particle Systems](#Particle_Systems)<br> [Loading 3D Models](#Loading_3D_Models)<br> [Selecting Objects](#Selecting_Objects)<br> [Text](#Text)<br> [Miscellaneous](#Miscellaneous)<br>[Example](#Example)<br>
26
+
[Public-Domain HTML 3D Library](#Public_Domain_HTML_3D_Library)<br>[Example](#Example)<br>[Contents](#Contents)<br>[How to Use](#How_to_Use)<br> [List of Classes](#List_of_Classes)<br> [`H3DU.Scene3D`](#H3DU_Scene3D)<br> [The "Camera"](#The_Camera)<br> [3D Models](#3D_Models)<br> [Shapes](#Shapes)<br> [The Render Loop](#The_Render_Loop)<br>[A Skeleton for 3D Apps](#A_Skeleton_for_3D_Apps)<br>[Demos](#Demos)<br> [Simple Demos](#Simple_Demos)<br> [Materials](#Materials)<br> [Shapes and meshes](#Shapes_and_meshes)<br> [Paths](#Paths)<br> [Curves and Surfaces](#Curves_and_Surfaces)<br> [Textures](#Textures)<br> [Shaders](#Shaders)<br> [Particle Systems](#Particle_Systems)<br> [Loading 3D Models](#Loading_3D_Models)<br> [Selecting Objects](#Selecting_Objects)<br> [Text](#Text)<br> [Miscellaneous](#Miscellaneous)<br>[Example](#Example)<br>[History](#History)<br> [Version 2.0.0-beta2](#Version_2_0_0_beta2)<br> [Version 2.0.0-beta1:](#Version_2_0_0_beta1)<br>
25
27
26
28
## How to Use
27
29
@@ -370,9 +372,43 @@ The following is a simple example of an HTML page that uses the HTML 3D library.
370
372
</script>
371
373
</body>
372
374
373
-
<h2>History</h2>
374
-
375
-
Version 2.0.0-beta1:
375
+
<aid=History></a>
376
+
## History
377
+
378
+
<aid=Version_2_0_0_beta2></a>
379
+
### Version 2.0.0-beta2
380
+
381
+
The changes in beta 2 from beta 1 include:
382
+
383
+
- Added H3DU.PbrMaterial class and supported physically-based shading in the default shader.
384
+
- H3DU.Shape objects contain H3DU.PbrMaterial by default.
385
+
- Extras folder contains a glTF loader, which is preliminary and incomplete.
386
+
- H3DU.Scene3D will create a WebGL 2 rendering context if possible and supported by the browser.
387
+
- H3DU.MeshBuffer stores vertex data by semantic (such as position, normal or texture coordinates), rather than by name.
388
+
- The new H3DU.Semantic class contains constants for attribute and uniform semantics.
389
+
- The new H3DU.TextureInfo class is a lightweight class for storing a texture's settings, but not its data.
390
+
- H3DU.ShaderInfo class can now accept H3DU.TextureInfo objects as uniform values.
391
+
- H3DU.Material can accept a parameter object in the constructor as it can in the setParams method, similarly to the
392
+
new H3DU.PbrMaterial class.
393
+
- Added fromBasic and fromBasicTexture methods to H3DU.Material class.
394
+
- Many new methods were added to the H3DU.Math class, including methods to add and
395
+
subtract 4-element vectors, to clamp vectors, and to convert to and from linear RGB colors,
396
+
as well as vec3proj, vec4proj, mat3invert, and vec3fromWindowPoint methods.
397
+
The frustumHasBox method was improved.
398
+
- The shapeCount, getShape, setShape, and copy methods were added to H3DU.ShapeGroup.
399
+
- New H3DU.CubeMap class holds information on the textures that make up a cube map.
400
+
However, cube maps are not yet supported in the default shader (its code is
401
+
currently commented out)
402
+
- In the H3DU.GraphicsPath extra, added methods for high-level shapes and path
403
+
interpolation and improved code on path triangulation.
404
+
- H3DU.TextFont extra supports multichannel signed distance field fonts.
405
+
- Several new demos were added.
406
+
- Some methods were removed: setMaterialParams methods from both H3DU.Shape and H3DU.ShapeGroup; mapTexture and mapTexturesAll methods from TextureLoader; and forShader method from H3DU.Material.
407
+
- Renamed setOrientation and multOrientation in H3DU.Transform to setRotation and multRotation, and deprecated the old names.
408
+
- Bug fixes.
409
+
410
+
<aid=Version_2_0_0_beta1></a>
411
+
### Version 2.0.0-beta1:
376
412
377
413
- All classes in the main library are moved to a new namespace called `H3DU`. For example, `Shape` is now <ahref="H3DU.Shape.md">H3DU.Shape</a> and `Mesh` is now <ahref="H3DU.Mesh.md">H3DU.Mesh</a>. Many classes in the "extras" directory are also moved to the `H3DU` namespace.
378
414
-`Scene3D`, now <ahref="H3DU.Scene3D.md">H3DU.Scene3D</a>, is no longer meant to be a scene graph of objects to draw. That job now belongs to the new <ahref="H3DU.Batch3D.md">H3DU.Batch3D</a> class. Scene3D's `render` method now takes an array of `Batch3D`s to render. For compatibility, though, the methods allowing it to manage 3D models and the coordinate system, such as `makeShape` and `setPerspective`, can still be used until `H3DU.Scene3D` renders a custom `H3DU.Batch3D`. This compatibility behavior may be dropped in the future.
@@ -402,7 +438,7 @@ Version 2.0.0-beta1:
402
438
polygons. Path triangulation now supports polygons with holes.
403
439
- The default light configuration is no lights when creating a <ahref="H3DU.LightSource.md">H3DU.LightSource</a>. The exception, for compatibility purposes, is when using a <ahref="H3DU.Scene3D.md">H3DU.Scene3D</a> without rendering a custom `Batch3D`, in which case the default is one light source with its default values.
404
440
- The default value for specular materials (<ahref="H3DU.Material.md">H3DU.Material</a>) is now (0.1, 0.1, 0.1). The default value for shininess is now 32.
405
-
- The Mesh class no longer supports multiple primitive types (lines, triangles, points). Using different modes that use the same primitive type (for example, TRIANGLE_FAN and QUAD_STRIP) in the same mesh is still supported.
441
+
- The Mesh class no longer supports multiple primitive types (lines, triangles, points). Using different modes that use the same primitive type (for example, `TRIANGLE_FAN` and `QUAD_STRIP`) in the same mesh is still supported.
406
442
- Many of the tutorials were edited heavily to accommodate the new version. The `GraphicsPath` tutorial was added.
407
443
- There were also numerous bug fixes.
408
444
- A known issue: When using the <ahref="H3DU.Camera.md">H3DU.Camera</a> in conjunction with the compatibility behavior of <ahref="H3DU.Scene3D.md">H3DU.Scene3D</a>, only one side of the scene will appear lighted by default.
Copy file name to clipboardExpand all lines: tutorials/history.md
+31Lines changed: 31 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,37 @@
1
1
<aid=Version_History></a>
2
2
## Version History
3
3
4
+
Version 2.0.0-beta2:
5
+
6
+
The changes in beta 2 from beta 1 include:
7
+
8
+
- Added H3DU.PbrMaterial class and supported physically-based shading in the default shader.
9
+
- H3DU.Shape objects contain H3DU.PbrMaterial by default.
10
+
- Extras folder contains a glTF loader, which is preliminary and incomplete.
11
+
- H3DU.Scene3D will create a WebGL 2 rendering context if possible and supported by the browser.
12
+
- H3DU.MeshBuffer stores vertex data by semantic (such as position, normal or texture coordinates), rather than by name.
13
+
- The new H3DU.Semantic class contains constants for attribute and uniform semantics.
14
+
- The new H3DU.TextureInfo class is a lightweight class for storing a texture's settings, but not its data.
15
+
- H3DU.ShaderInfo class can now accept H3DU.TextureInfo objects as uniform values.
16
+
- H3DU.Material can accept a parameter object in the constructor as it can in the setParams method, similarly to the
17
+
new H3DU.PbrMaterial class.
18
+
- Added fromBasic and fromBasicTexture methods to H3DU.Material class.
19
+
- Many new methods were added to the H3DU.Math class, including methods to add and
20
+
subtract 4-element vectors, to clamp vectors, and to convert to and from linear RGB colors,
21
+
as well as vec3proj, vec4proj, mat3invert, and vec3fromWindowPoint methods.
22
+
The frustumHasBox method was improved.
23
+
- The shapeCount, getShape, setShape, and copy methods were added to H3DU.ShapeGroup.
24
+
- New H3DU.CubeMap class holds information on the textures that make up a cube map.
25
+
However, cube maps are not yet supported in the default shader (its code is
26
+
currently commented out)
27
+
- In the H3DU.GraphicsPath extra, added methods for high-level shapes and path
28
+
interpolation and improved code on path triangulation.
29
+
- H3DU.TextFont extra supports multichannel signed distance field fonts.
30
+
- Several new demos were added.
31
+
- Some methods were removed: setMaterialParams methods from both H3DU.Shape and H3DU.ShapeGroup; mapTexture and mapTexturesAll methods from TextureLoader; forShader method from H3DU.Material.
32
+
- Renamed setOrientation and multOrientation in H3DU.Transform to setRotation and multRotation, and deprecated the old names.
33
+
- Bug fixes.
34
+
4
35
Version 2.0.0-beta1:
5
36
6
37
There are many, many changes to version 2.0.0-beta1 from version 1.5.1. Here are some of them, including the most important ones.
Copy file name to clipboardExpand all lines: tutorials/overview.md
+41-5Lines changed: 41 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,6 +9,8 @@ The library differs from many others because this one is in the public domain, s
9
9
10
10
This page includes information on how to use the HTML 3D library, an overview of its features, and an example of a simple 3D-enabled Web page.
11
11
12
+
NOTE: This section and the rest of this page will largely discuss the 2.0.0-beta2 version of the HTML 3D library, which differs considerably from the current release (version 1.5.1) of the library. (See the section "History" for more information.)
13
+
12
14
<aid=Example></a>
13
15
## Example
14
16
@@ -17,7 +19,7 @@ This page includes information on how to use the HTML 3D library, an overview of
17
19
<aid=Contents></a>
18
20
## Contents
19
21
20
-
[Public-Domain HTML 3D Library](#Public_Domain_HTML_3D_Library)<br>[Example](#Example)<br>[Contents](#Contents)<br>[How to Use](#How_to_Use)<br> [List of Classes](#List_of_Classes)<br> [`H3DU.Scene3D`](#H3DU_Scene3D)<br> [The "Camera"](#The_Camera)<br> [3D Models](#3D_Models)<br> [Shapes](#Shapes)<br> [The Render Loop](#The_Render_Loop)<br>[A Skeleton for 3D Apps](#A_Skeleton_for_3D_Apps)<br>[Demos](#Demos)<br> [Simple Demos](#Simple_Demos)<br> [Materials](#Materials)<br> [Shapes and meshes](#Shapes_and_meshes)<br> [Paths](#Paths)<br> [Curves and Surfaces](#Curves_and_Surfaces)<br> [Textures](#Textures)<br> [Shaders](#Shaders)<br> [Particle Systems](#Particle_Systems)<br> [Loading 3D Models](#Loading_3D_Models)<br> [Selecting Objects](#Selecting_Objects)<br> [Text](#Text)<br> [Miscellaneous](#Miscellaneous)<br>[Example](#Example)<br>
22
+
[Public-Domain HTML 3D Library](#Public_Domain_HTML_3D_Library)<br>[Example](#Example)<br>[Contents](#Contents)<br>[How to Use](#How_to_Use)<br> [List of Classes](#List_of_Classes)<br> [`H3DU.Scene3D`](#H3DU_Scene3D)<br> [The "Camera"](#The_Camera)<br> [3D Models](#3D_Models)<br> [Shapes](#Shapes)<br> [The Render Loop](#The_Render_Loop)<br>[A Skeleton for 3D Apps](#A_Skeleton_for_3D_Apps)<br>[Demos](#Demos)<br> [Simple Demos](#Simple_Demos)<br> [Materials](#Materials)<br> [Shapes and meshes](#Shapes_and_meshes)<br> [Paths](#Paths)<br> [Curves and Surfaces](#Curves_and_Surfaces)<br> [Textures](#Textures)<br> [Shaders](#Shaders)<br> [Particle Systems](#Particle_Systems)<br> [Loading 3D Models](#Loading_3D_Models)<br> [Selecting Objects](#Selecting_Objects)<br> [Text](#Text)<br> [Miscellaneous](#Miscellaneous)<br>[Example](#Example)<br>[History](#History)<br> [Version 2.0.0-beta2](#Version_2_0_0_beta2)<br> [Version 2.0.0-beta1:](#Version_2_0_0_beta1)<br>
21
23
22
24
## How to Use
23
25
@@ -366,9 +368,43 @@ The following is a simple example of an HTML page that uses the HTML 3D library.
366
368
</script>
367
369
</body>
368
370
369
-
<h2>History</h2>
370
-
371
-
Version 2.0.0-beta1:
371
+
<aid=History></a>
372
+
## History
373
+
374
+
<aid=Version_2_0_0_beta2></a>
375
+
### Version 2.0.0-beta2
376
+
377
+
The changes in beta 2 from beta 1 include:
378
+
379
+
- Added H3DU.PbrMaterial class and supported physically-based shading in the default shader.
380
+
- H3DU.Shape objects contain H3DU.PbrMaterial by default.
381
+
- Extras folder contains a glTF loader, which is preliminary and incomplete.
382
+
- H3DU.Scene3D will create a WebGL 2 rendering context if possible and supported by the browser.
383
+
- H3DU.MeshBuffer stores vertex data by semantic (such as position, normal or texture coordinates), rather than by name.
384
+
- The new H3DU.Semantic class contains constants for attribute and uniform semantics.
385
+
- The new H3DU.TextureInfo class is a lightweight class for storing a texture's settings, but not its data.
386
+
- H3DU.ShaderInfo class can now accept H3DU.TextureInfo objects as uniform values.
387
+
- H3DU.Material can accept a parameter object in the constructor as it can in the setParams method, similarly to the
388
+
new H3DU.PbrMaterial class.
389
+
- Added fromBasic and fromBasicTexture methods to H3DU.Material class.
390
+
- Many new methods were added to the H3DU.Math class, including methods to add and
391
+
subtract 4-element vectors, to clamp vectors, and to convert to and from linear RGB colors,
392
+
as well as vec3proj, vec4proj, mat3invert, and vec3fromWindowPoint methods.
393
+
The frustumHasBox method was improved.
394
+
- The shapeCount, getShape, setShape, and copy methods were added to H3DU.ShapeGroup.
395
+
- New H3DU.CubeMap class holds information on the textures that make up a cube map.
396
+
However, cube maps are not yet supported in the default shader (its code is
397
+
currently commented out)
398
+
- In the H3DU.GraphicsPath extra, added methods for high-level shapes and path
399
+
interpolation and improved code on path triangulation.
400
+
- H3DU.TextFont extra supports multichannel signed distance field fonts.
401
+
- Several new demos were added.
402
+
- Some methods were removed: setMaterialParams methods from both H3DU.Shape and H3DU.ShapeGroup; mapTexture and mapTexturesAll methods from TextureLoader; and forShader method from H3DU.Material.
403
+
- Renamed setOrientation and multOrientation in H3DU.Transform to setRotation and multRotation, and deprecated the old names.
404
+
- Bug fixes.
405
+
406
+
<aid=Version_2_0_0_beta1></a>
407
+
### Version 2.0.0-beta1:
372
408
373
409
- All classes in the main library are moved to a new namespace called `H3DU`. For example, `Shape` is now {@link H3DU.Shape} and `Mesh` is now {@link H3DU.Mesh}. Many classes in the "extras" directory are also moved to the `H3DU` namespace.
374
410
-`Scene3D`, now {@link H3DU.Scene3D}, is no longer meant to be a scene graph of objects to draw. That job now belongs to the new {@link H3DU.Batch3D} class. Scene3D's `render` method now takes an array of `Batch3D`s to render. For compatibility, though, the methods allowing it to manage 3D models and the coordinate system, such as `makeShape` and `setPerspective`, can still be used until `H3DU.Scene3D` renders a custom `H3DU.Batch3D`. This compatibility behavior may be dropped in the future.
@@ -398,7 +434,7 @@ Version 2.0.0-beta1:
398
434
polygons. Path triangulation now supports polygons with holes.
399
435
- The default light configuration is no lights when creating a {@link H3DU.LightSource}. The exception, for compatibility purposes, is when using a {@link H3DU.Scene3D} without rendering a custom `Batch3D`, in which case the default is one light source with its default values.
400
436
- The default value for specular materials ({@link H3DU.Material}) is now (0.1, 0.1, 0.1). The default value for shininess is now 32.
401
-
- The Mesh class no longer supports multiple primitive types (lines, triangles, points). Using different modes that use the same primitive type (for example, TRIANGLE_FAN and QUAD_STRIP) in the same mesh is still supported.
437
+
- The Mesh class no longer supports multiple primitive types (lines, triangles, points). Using different modes that use the same primitive type (for example, `TRIANGLE_FAN` and `QUAD_STRIP`) in the same mesh is still supported.
402
438
- Many of the tutorials were edited heavily to accommodate the new version. The `GraphicsPath` tutorial was added.
403
439
- There were also numerous bug fixes.
404
440
- A known issue: When using the {@link H3DU.Camera} in conjunction with the compatibility behavior of {@link H3DU.Scene3D}, only one side of the scene will appear lighted by default.
0 commit comments