|
|
@@ -1,26 +1,24 @@
|
|
1
|
|
-# Create the augmented scene
|
|
|
1
|
+# Augment the scene
|
|
2
|
2
|
|
|
3
|
|
-Now that the image is being tracked, the next step is to render a virtual scene on top of it. You need a 3D rendering technology to do that.
|
|
|
3
|
+We're already tracking an image of the physical world. The next step is to augment it with computer graphics. You'll use a different technology to render the graphics.
|
|
4
|
4
|
|
|
5
|
5
|
## Pick a 3D rendering technology
|
|
6
|
6
|
|
|
7
|
|
-encantar.js is not a 3D rendering technology. It is an Augmented Reality technology that provides the data you need in order to augment your physical scenes. There are free and open-source 3D rendering technologies for the web that you can find online and use with encantar.js. Popular solutions include: [A-Frame](#a-frame), [Babylon.js](#babylonjs) and [Three.js](#threejs). You can also use other solutions. encantar.js lets you pick any 3D rendering technology.
|
|
|
7
|
+encantar.js is not a 3D rendering technology. It is an Augmented Reality technology that provides the data you need in order to augment your physical scenes. There are free and open-source 3D rendering technologies that you can use with encantar.js. Popular solutions include: [A-Frame](#a-frame), [Babylon.js](#babylonjs) and [Three.js](#threejs). You can also use other solutions. encantar.js lets you pick any web-based 3D rendering technology.
|
|
8
|
8
|
|
|
9
|
9
|
Once you pick a 3D rendering technology, you need to integrate it with encantar.js. There is a code that is responsible for that integration. I call it a _plugin_. Among other things, a plugin transports the tracking results from encantar.js to the 3D rendering technology of your choice.
|
|
10
|
10
|
|
|
11
|
11
|
## Use a plugin
|
|
12
|
12
|
|
|
13
|
|
-Writing a plugin is a task of moderate complexity. It requires dealing with matrices, with performance issues, and with some idiosyncrasies of the 3D rendering technologies in order to make sure that it all works as intended. It is advisable to have specialized knowledge of computer graphics programming in order to write a plugin that works correctly.
|
|
14
|
|
-
|
|
15
|
|
-I provide easy-to-use plugins that work with different 3D rendering technologies, so that you don't need to deal with the complexity. Those plugins are JavaScript (.js) files. You just need to add a plugin to your web page, via a `<script>` tag, and then the integration will be done for you. It's really that simple!
|
|
|
13
|
+Writing a plugin is a task of moderate complexity. It requires dealing with maths and with some idiosyncrasies of the 3D rendering technologies in order to make sure that it all works as intended. I provide easy-to-use plugins that work with different 3D rendering technologies, so that you don't need to deal with that complexity yourself. Plugins are shipped as JavaScript (.js) files. You just need to add a plugin to your web page, and then the integration will be done for you!
|
|
16
|
14
|
|
|
17
|
15
|
[Get the plugins](https://github.com/alemart/encantar-js/tree/master/plugins){ .md-button .md-button--primary ._blank }
|
|
18
|
16
|
|
|
19
|
17
|
## Create the virtual scene
|
|
20
|
18
|
|
|
21
|
|
-You will create the virtual scene using the 3D rendering technology of your choice. As soon as you combine it with a plugin, the physical scene will be automagically augmented with the virtual scene, thus creating the augmented scene.
|
|
|
19
|
+You will create the virtual scene using the 3D rendering technology of your choice. As soon as you combine it with an appropriate plugin, the physical scene will be automagically augmented with the virtual scene, thus creating the augmented scene.
|
|
22
|
20
|
|
|
23
|
|
-Let me tell you a bit more about the 3D rendering technologies I just mentioned.
|
|
|
21
|
+Let me tell you more about the 3D rendering technologies I just mentioned.
|
|
24
|
22
|
|
|
25
|
23
|
### A-Frame
|
|
26
|
24
|
|
|
|
@@ -32,15 +30,15 @@ A-Frame is built on top of [Three.js](#threejs) and extends it in powerful ways.
|
|
32
|
30
|
|
|
33
|
31
|
### Babylon.js
|
|
34
|
32
|
|
|
35
|
|
-[Babylon.js](https://www.babylonjs.com){ ._blank } is a powerful open-source game and 3D rendering engine for the web. It includes pretty much all features you commonly find in 3D rendering engines (scene graphs, lights, materials, meshes, etc.), plus systems that are specific to game engines (animation engine, audio engine, collision system, physics system, support for sprites, etc.), plus all kinds of sophisticated features for various applications.
|
|
|
33
|
+[Babylon.js](https://www.babylonjs.com){ ._blank } is a powerful open-source game and 3D rendering engine for the web. It includes pretty much all features you commonly find in 3D rendering engines (scene graphs, lights, materials, meshes, animations, etc.), plus systems that are specific to game engines (audio engine, collision system, physics system, support for sprites, etc.), plus all kinds of sophisticated features for various applications.
|
|
36
|
34
|
|
|
37
|
|
-Babylon.js has an amazing documentation with plenty of learning resources. Even though it can be used by beginners, it's recommended to have JavaScript experience before creating projects with it.
|
|
|
35
|
+Babylon.js has an amazing documentation with plenty of learning resources, as well as a helpful and friendly community! Even though it can be used by beginners, it's recommended to have experience with JavaScript before creating projects with it.
|
|
38
|
36
|
|
|
39
|
37
|
[Launch a Babylon.js demo](/encantar-js/demos/hello-babylon/README.html){ ._blank .md-button }
|
|
40
|
38
|
|
|
41
|
39
|
### Three.js
|
|
42
|
40
|
|
|
43
|
|
-[Three.js](https://threejs.org){ ._blank } is a popular open-source JavaScript library used to render 3D graphics in web browsers. It supports many features, including: scene graphs, cameras, animations, lights, materials, loading of 3D models, mathematical utilities, special effects, and more. It has an active and vibrant community. Many community-made extensions are available.
|
|
|
41
|
+[Three.js](https://threejs.org){ ._blank } is a popular open-source JavaScript library used to render 3D graphics in web browsers. It has many features, including: scene graphs, cameras, animations, lights, materials, loading of 3D models, mathematical utilities, special effects, and more. It has an active and vibrant community. Many community-made extensions are available.
|
|
44
|
42
|
|
|
45
|
43
|
Using Three.js requires more JavaScript experience than using A-Frame in most cases, but it's also a great choice if you're comfortable with coding. Compared to A-Frame, Three.js offers you additional freedom on how you can organize your code, because it's a library, not a framework.
|
|
46
|
44
|
|
alemart
10ヶ月前