From 61b1289c43635944b844061be3567f42ff0bc555 Mon Sep 17 00:00:00 2001 From: Peter O Date: Fri, 21 Apr 2017 06:00:55 -0400 Subject: [PATCH] edit overview --- doc/tutorial-overview.md | 36 +++++++++++++++++++++++++++++++++- dochtml/tutorial-overview.html | 36 ++++++++++++++++++++++++++++++++-- tutorials/overview.md | 36 +++++++++++++++++++++++++++++++++- 3 files changed, 104 insertions(+), 4 deletions(-) diff --git a/doc/tutorial-overview.md b/doc/tutorial-overview.md index 6877e614..b2f5c26a 100644 --- a/doc/tutorial-overview.md +++ b/doc/tutorial-overview.md @@ -23,7 +23,7 @@ NOTE: This section and the rest of this page will largely discuss the 2.0.0-beta ## Contents -[Public-Domain HTML 3D Library](#Public_Domain_HTML_3D_Library)
[Example](#Example)
[Contents](#Contents)
[How to Use](#How_to_Use)
  [List of Classes](#List_of_Classes)
  [`H3DU.Scene3D`](#H3DU_Scene3D)
  [The "Camera"](#The_Camera)
  [3D Models](#3D_Models)
  [Shapes](#Shapes)
  [The Render Loop](#The_Render_Loop)
[A Skeleton for 3D Apps](#A_Skeleton_for_3D_Apps)
[Demos](#Demos)
  [Simple Demos](#Simple_Demos)
  [Materials](#Materials)
  [Shapes and meshes](#Shapes_and_meshes)
  [Paths](#Paths)
  [Curves and Surfaces](#Curves_and_Surfaces)
  [Textures](#Textures)
  [Shaders](#Shaders)
  [Particle Systems](#Particle_Systems)
  [Loading 3D Models](#Loading_3D_Models)
  [Selecting Objects](#Selecting_Objects)
  [Lights](#Lights)
  [Text](#Text)
  [Projections](#Projections)
  [Miscellaneous](#Miscellaneous)
[Example](#Example)
[History](#History)
  [Version 2.0.0-beta2](#Version_2_0_0_beta2)
  [Version 2.0.0-beta1:](#Version_2_0_0_beta1)
+[Public-Domain HTML 3D Library](#Public_Domain_HTML_3D_Library)
[Example](#Example)
[Contents](#Contents)
[How to Use](#How_to_Use)
  [List of Classes](#List_of_Classes)
  [`H3DU.Scene3D`](#H3DU_Scene3D)
  [The "Camera"](#The_Camera)
  [3D Models](#3D_Models)
  [Shapes](#Shapes)
  [The Render Loop](#The_Render_Loop)
[A Skeleton for 3D Apps](#A_Skeleton_for_3D_Apps)
[Demos](#Demos)
  [Simple Demos](#Simple_Demos)
  [Materials](#Materials)
  [Shapes and meshes](#Shapes_and_meshes)
  [Paths](#Paths)
  [Curves and Surfaces](#Curves_and_Surfaces)
  [Textures](#Textures)
  [Shaders](#Shaders)
  [Particle Systems](#Particle_Systems)
  [Loading 3D Models](#Loading_3D_Models)
  [Selecting Objects](#Selecting_Objects)
  [Lights](#Lights)
  [Text](#Text)
  [Projections](#Projections)
  [Miscellaneous](#Miscellaneous)
[Example](#Example)
[History](#History)
  [Version 2.0.0-beta3](#Version_2_0_0_beta3)
  [Version 2.0.0-beta2](#Version_2_0_0_beta2)
  [Version 2.0.0-beta1:](#Version_2_0_0_beta1)
## How to Use @@ -399,6 +399,40 @@ The following is a simple example of an HTML page that uses the HTML 3D library. ## History + +### Version 2.0.0-beta3 + +The changes in beta 3 from beta 2 include: + +- The main library files were converted to ECMAScript's import/export convention. The `rollup` tool + is used to help generate the `h3du_min.js` file. +- HTML documentation included in distribution. +- "Norm" methods in H3DU.Math were renamed to use "Normalize" instead. +- New `convex.js` in extras folder generates the convex hull of a set of points. +- New `interp.js` in extras folder provides a cubic Bézier interpolation function. +- New `spline.js` in extras folder generates piecewise interpolating curves. +- New demos added, including demos showing how to generate procedural content using shaders. +- Several methods in H3DU.GraphicsPath were reimplemented. +- H3DU.BezierCurve and H3DU.BezierSpline are deprecated. +- H3DU.CurveBuilder and H3DU.SurfaceBuilder classes were created; they replace now-deprecated + H3DU.CurveEval and H3DU.SurfaceEval classes. +- H3DU.MeshBuffer contains many new methods; in exchange, many of the H3DU.Mesh + methods reimplemented in H3DU.MeshBuffer are deprecated. +- H3DU.Mesh is considerably deemphasized in this version; that class should only be used + for building meshes, not storing them. +- H3DU.Curve and H3DU.Surface were created; these classes represent parametric curves + and surfaces and offer methods for querying information at a given point on the curve or surface. + Made several class derive from either class, including H3DU.BSplineCurve, H3DU.BSplineSurface, + and new class H3DU.PiecewiseCurve. +- H3DU.RenderPass3D renamed to H3DU.RenderPass. +- Deleted fromBasic and fromBasicTexture methods from H3DU.PbrMaterial. +- Added JOINTS and WEIGHTS constants to H3DU.Semantic. +- Preliminary support for occlusion maps. +- Default diffuse/albedo in Material and PbrMaterial is now (1,1,1,1). +- New H3DU.BufferAccessor class represents a single vertex buffer. +- Many methods outside H3DU.Mesh now return H3DU.MeshBuffer instead of H3DU.Mesh. +- Bug fixes. + ### Version 2.0.0-beta2 diff --git a/dochtml/tutorial-overview.html b/dochtml/tutorial-overview.html index ccea5700..7e293b45 100644 --- a/dochtml/tutorial-overview.html +++ b/dochtml/tutorial-overview.html @@ -7,7 +7,7 @@

Public-Domain HTML 3D Library

This page will introduce the

-

Contents

Public-Domain HTML 3D Library
Example
Contents
How to Use
  List of Classes
  H3DU.Scene3D
  The "Camera"
  3D Models
  Shapes
  The Render Loop
A Skeleton for 3D Apps
Demos
  Simple Demos
  Materials
  Shapes and meshes
  Paths
  Curves and Surfaces
  Textures
  Shaders
  Particle Systems
  Loading 3D Models
  Selecting Objects
  Lights
  Text
  Projections
  Miscellaneous
Example
History
  Version 2.0.0-beta2
  Version 2.0.0-beta1:

+

Contents

Public-Domain HTML 3D Library
Example
Contents
How to Use
  List of Classes
  H3DU.Scene3D
  The "Camera"
  3D Models
  Shapes
  The Render Loop
A Skeleton for 3D Apps
Demos
  Simple Demos
  Materials
  Shapes and meshes
  Paths
  Curves and Surfaces
  Textures
  Shaders
  Particle Systems
  Loading 3D Models
  Selecting Objects
  Lights
  Text
  Projections
  Miscellaneous
Example
History
  Version 2.0.0-beta3
  Version 2.0.0-beta2
  Version 2.0.0-beta1:

How to Use

  1. Download the HTML 3D library.

  2. Extract the file "h3du_min.js", and write the following code in every HTML page where you will use the library.

    @@ -318,7 +318,39 @@

    Example

    The following is a simple example of an HTML page that uses t //--> </script> </body>

    -

    History

    +

    History

    +

    Version 2.0.0-beta3

    The changes in beta 3 from beta 2 include:

    +
      +
    • The main library files were converted to ECMAScript's import/export convention. The rollup tool +is used to help generate the h3du_min.js file.
      • +
    • HTML documentation included in distribution.
      • +
    • "Norm" methods in H3DU.Math were renamed to use "Normalize" instead.
      • +
    • New convex.js in extras folder generates the convex hull of a set of points.
      • +
    • New interp.js in extras folder provides a cubic Bézier interpolation function.
      • +
    • New spline.js in extras folder generates piecewise interpolating curves.
      • +
    • New demos added, including demos showing how to generate procedural content using shaders.
      • +
    • Several methods in H3DU.GraphicsPath were reimplemented.
      • +
    • H3DU.BezierCurve and H3DU.BezierSpline are deprecated.
      • +
    • H3DU.CurveBuilder and H3DU.SurfaceBuilder classes were created; they replace now-deprecated +H3DU.CurveEval and H3DU.SurfaceEval classes.
      • +
    • H3DU.MeshBuffer contains many new methods; in exchange, many of the H3DU.Mesh +methods reimplemented in H3DU.MeshBuffer are deprecated.
      • +
    • H3DU.Mesh is considerably deemphasized in this version; that class should only be used +for building meshes, not storing them.
      • +
    • H3DU.Curve and H3DU.Surface were created; these classes represent parametric curves + and surfaces and offer methods for querying information at a given point on the curve or surface. + Made several class derive from either class, including H3DU.BSplineCurve, H3DU.BSplineSurface, + and new class H3DU.PiecewiseCurve.
      • +
    • H3DU.RenderPass3D renamed to H3DU.RenderPass.
      • +
    • Deleted fromBasic and fromBasicTexture methods from H3DU.PbrMaterial.
      • +
    • Added JOINTS and WEIGHTS constants to H3DU.Semantic.
      • +
    • Preliminary support for occlusion maps.
      • +
    • Default diffuse/albedo in Material and PbrMaterial is now (1,1,1,1).
      • +
    • New H3DU.BufferAccessor class represents a single vertex buffer.
      • +
    • Many methods outside H3DU.Mesh now return H3DU.MeshBuffer instead of H3DU.Mesh.
      • +
    • Bug fixes.
      • +
    +

    Version 2.0.0-beta2

    The changes in beta 2 from beta 1 include:

    • Added H3DU.PbrMaterial class and supported physically-based shading in the default shader.
      • diff --git a/tutorials/overview.md b/tutorials/overview.md index aecd2aeb..bd883f0f 100644 --- a/tutorials/overview.md +++ b/tutorials/overview.md @@ -19,7 +19,7 @@ NOTE: This section and the rest of this page will largely discuss the 2.0.0-beta ## Contents -[Public-Domain HTML 3D Library](#Public_Domain_HTML_3D_Library)
      [Example](#Example)
      [Contents](#Contents)
      [How to Use](#How_to_Use)
        [List of Classes](#List_of_Classes)
        [`H3DU.Scene3D`](#H3DU_Scene3D)
        [The "Camera"](#The_Camera)
        [3D Models](#3D_Models)
        [Shapes](#Shapes)
        [The Render Loop](#The_Render_Loop)
      [A Skeleton for 3D Apps](#A_Skeleton_for_3D_Apps)
      [Demos](#Demos)
        [Simple Demos](#Simple_Demos)
        [Materials](#Materials)
        [Shapes and meshes](#Shapes_and_meshes)
        [Paths](#Paths)
        [Curves and Surfaces](#Curves_and_Surfaces)
        [Textures](#Textures)
        [Shaders](#Shaders)
        [Particle Systems](#Particle_Systems)
        [Loading 3D Models](#Loading_3D_Models)
        [Selecting Objects](#Selecting_Objects)
        [Lights](#Lights)
        [Text](#Text)
        [Projections](#Projections)
        [Miscellaneous](#Miscellaneous)
      [Example](#Example)
      [History](#History)
        [Version 2.0.0-beta2](#Version_2_0_0_beta2)
        [Version 2.0.0-beta1:](#Version_2_0_0_beta1)
      +[Public-Domain HTML 3D Library](#Public_Domain_HTML_3D_Library)
      [Example](#Example)
      [Contents](#Contents)
      [How to Use](#How_to_Use)
        [List of Classes](#List_of_Classes)
        [`H3DU.Scene3D`](#H3DU_Scene3D)
        [The "Camera"](#The_Camera)
        [3D Models](#3D_Models)
        [Shapes](#Shapes)
        [The Render Loop](#The_Render_Loop)
      [A Skeleton for 3D Apps](#A_Skeleton_for_3D_Apps)
      [Demos](#Demos)
        [Simple Demos](#Simple_Demos)
        [Materials](#Materials)
        [Shapes and meshes](#Shapes_and_meshes)
        [Paths](#Paths)
        [Curves and Surfaces](#Curves_and_Surfaces)
        [Textures](#Textures)
        [Shaders](#Shaders)
        [Particle Systems](#Particle_Systems)
        [Loading 3D Models](#Loading_3D_Models)
        [Selecting Objects](#Selecting_Objects)
        [Lights](#Lights)
        [Text](#Text)
        [Projections](#Projections)
        [Miscellaneous](#Miscellaneous)
      [Example](#Example)
      [History](#History)
        [Version 2.0.0-beta3](#Version_2_0_0_beta3)
        [Version 2.0.0-beta2](#Version_2_0_0_beta2)
        [Version 2.0.0-beta1:](#Version_2_0_0_beta1)
      ## How to Use @@ -395,6 +395,40 @@ The following is a simple example of an HTML page that uses the HTML 3D library. ## History + +### Version 2.0.0-beta3 + +The changes in beta 3 from beta 2 include: + +- The main library files were converted to ECMAScript's import/export convention. The `rollup` tool + is used to help generate the `h3du_min.js` file. +- HTML documentation included in distribution. +- "Norm" methods in H3DU.Math were renamed to use "Normalize" instead. +- New `convex.js` in extras folder generates the convex hull of a set of points. +- New `interp.js` in extras folder provides a cubic Bézier interpolation function. +- New `spline.js` in extras folder generates piecewise interpolating curves. +- New demos added, including demos showing how to generate procedural content using shaders. +- Several methods in H3DU.GraphicsPath were reimplemented. +- H3DU.BezierCurve and H3DU.BezierSpline are deprecated. +- H3DU.CurveBuilder and H3DU.SurfaceBuilder classes were created; they replace now-deprecated + H3DU.CurveEval and H3DU.SurfaceEval classes. +- H3DU.MeshBuffer contains many new methods; in exchange, many of the H3DU.Mesh + methods reimplemented in H3DU.MeshBuffer are deprecated. +- H3DU.Mesh is considerably deemphasized in this version; that class should only be used + for building meshes, not storing them. +- H3DU.Curve and H3DU.Surface were created; these classes represent parametric curves + and surfaces and offer methods for querying information at a given point on the curve or surface. + Made several class derive from either class, including H3DU.BSplineCurve, H3DU.BSplineSurface, + and new class H3DU.PiecewiseCurve. +- H3DU.RenderPass3D renamed to H3DU.RenderPass. +- Deleted fromBasic and fromBasicTexture methods from H3DU.PbrMaterial. +- Added JOINTS and WEIGHTS constants to H3DU.Semantic. +- Preliminary support for occlusion maps. +- Default diffuse/albedo in Material and PbrMaterial is now (1,1,1,1). +- New H3DU.BufferAccessor class represents a single vertex buffer. +- Many methods outside H3DU.Mesh now return H3DU.MeshBuffer instead of H3DU.Mesh. +- Bug fixes. + ### Version 2.0.0-beta2