Adde first version of the mesh component docs

docs/en/manuals/components.md

@@ -18,6 +18,7 @@ Defold supports the following component types:
 * [Factory](/manuals/factory) - Spawn game objects
 * [GUI](/manuals/gui) - Render a graphical user interface
 * [Label](/manuals/label) - Render a piece of text
+* [Mesh](/manuals/mesh) Show a 3D mesh (with run-time creation and manipulation)
 * [Model](/manuals/model) Show a 3D model (with optional animations)
 * [Particle FX](/manuals/particlefx) -  Spawn particles
 * [Script](/manuals/script) - Add game logic

docs/en/manuals/mesh.md

@@ -0,0 +1,57 @@
+---
+title: 3D meshes in Defold
+brief: This manual describes how to create 3D meshes at run-time in your game.
+---
+
+# Mesh component
+
+Defold is at its core a 3D engine. Even when you work with 2D material only all rendering is done in 3D, but orthographically projected onto the screen. Defold allows you to utilize full 3D content by adding and creating 3D meshes at run-time in your collections. You can build games in strictly 3D with only 3D assets, or you can mix 3D and 2D content as you wish.
+
+## Creating a mesh component
+
+Mesh components are created just like any other game object component. You can do it two ways:
+
+- Create a *Mesh file* by <kbd>right-clicking</kbd> a location in the *Assets* browser and select <kbd>New... ▸ Mesh</kbd>.
+- Create the component embedded directly into a game object by <kbd>right-clicking</kbd> a game object in the *Outline* view and selecting <kbd>Add Component ▸ Mesh</kbd>.
+
+![Mesh in game object](images/mesh/mesh.png)
+
+With the mesh created you need to specify a number of properties:
+
+### Mesh properties
+
+Apart from the properties *Id*, *Position* and *Rotation* the following component specific properties exist:
+
+*Material*
+: The material to use for rendering the mesh.
+
+*Vertices*
+: A buffer file describing the mesh data per stream.
+
+*Primitive Type*
+: Lines, Triangles or Triangle Strip.
+
+*Position Stream*
+: This property should be the name of the *position* stream. The stream is automatically provided as input to the vertex shader.
+
+*Normal Stream*
+: This property should be the name of the *normal* stream. The stream is automatically provided as input to the vertex shader.
+
+*tex0*
+: Set this to texture to use for the mesh.
+
+## Editor manipulation
+
+With the mesh component in place you are free to edit and manipulate the component and/or the encapsulating game object with the regular *Scene Editor* tools to move, rotate and scale the mesh to your liking.
+
+## Runtime manipulation
+
+You can manipulate meshes at runtime using Defold buffers.
+
+## Vertex local vs world space
+If the Vertex Space setting of the mesh material is set to Local Space the data will be provided as-is to you in your shader, and you will have to transform vertices/normals as usual on the GPU.
+
+If the Vertex Space setting of the mesh material is set to World Space you have to either provide a default “position” and “normal”, stream, or you can select it from the dropdown, when editing the mesh. This is so that the engine can transform the data to world space for batching with other objects.
+
+## Examples
+Refer to the forum announcement post: https://forum.defold.com/t/mesh-component-in-defold-1-2-169-beta/65137

docs/en/manuals/model.md

@@ -5,7 +5,7 @@ brief: This manual describes how to bring 3D models, skeletons and animations in
 
 # Model component
 
-Defold is at its core a 3D engine. Even when you work with 2D material only all rendering is done in 3D, but orthographically projected onto the screen.  Defold allows you to utilize full 3D content by including 3D assets, or _Models_ into your collections. You can build games in strictly 3D with only 3D assets, or you can mix 3D and 2D content as you wish.
+Defold is at its core a 3D engine. Even when you work with 2D material only all rendering is done in 3D, but orthographically projected onto the screen. Defold allows you to utilize full 3D content by including 3D assets, or _Models_ into your collections. You can build games in strictly 3D with only 3D assets, or you can mix 3D and 2D content as you wish.
 
 ## Creating a model component