| parent (optional) - This optional parameter allows you to specify another entity which will act as the parent to this mesh. |
|
Create a 'blank' mesh entity and returns its handle. When a mesh is first created it has no surfaces, vertices or triangles associated with it. To add geometry to this mesh, you will need to: dxCreateSurface() ; To make a surface dxAddVertex ; You will need to add at least 3 to make a Triangle dxAddTriangle ; This will add a triangle by connecting the Vertices (points) you added to the mesh. |
|
; dxCreateMesh Example ; ------------------ ; In this example, we will create a custom mesh. This custom mesh will be in the shape of a ramp. dxGraphics3D 640,480 dxSetBuffer dxBackBuffer() camera=dxCreateCamera() light=dxCreateLight() dxRotateEntity light,45,0,0 ; Create blank mesh ramp=dxCreateMesh() ; Create blank surface which is attached to mesh (surfaces must always be attached to a mesh) surf=dxCreateSurface(ramp) ; Now we have our blank mesh and surface, we can start adding vertices to it, to form the shape of our ; ramp. ; Vertices are invisible 'points' in a 3D object that we can attach triangles too later. ; To create a single triangle, you need three vertices, one for each corner. ; However, you can share vertices between triangles, so you do not always need 3 new vertices per ; triangle. ; In the case of our ramp mesh, we will require 6 vertices, one for each corner v0=dxAddVertex(surf,0,0,0) ; bottom corner 1 v1=dxAddVertex(surf,0,0,1) ; bottom corner 2 v2=dxAddVertex(surf,4,0,1) ; bottom corner 3 v3=dxAddVertex(surf,4,0,0) ; bottom corner 4 v4=dxAddVertex(surf,0,2,0) ; top corner 1 v5=dxAddVertex(surf,0,2,1) ; top corner 2 ; Having created our blank mesh and surface, and added our vertices to form the shape of the mesh, we ; now need to add triangles to it in order to make it solid and visible to the user. We create ; triangles simply by connecting vertices up, very much like a 3D dot-to-dot. ; When adding triangles, we need to remember that they are only one sided, and the side they are ; visible from is determined by the order in which we specify the vertices when using dxAddTriangle. ; If the vertices, in the order that they are specified, are aligned in a clockwise fashion relative ; to the camera then they will appear visible, otherwise they won't. ; So, to make our ramp visible from the outside, we will be connecting all vertices in a clockwise ; fashion, relative to the camera. t0=dxAddTriangle(surf,v0,v3,v2) ; bottom triangle 1 t1=dxAddTriangle(surf,v0,v2,v1) ; bottom triangle 2 t2=dxAddTriangle(surf,v0,v4,v3) ; front triangle t3=dxAddTriangle(surf,v1,v2,v5) ; back triangle t4=dxAddTriangle(surf,v0,v1,v5) ; side triangle 1 t5=dxAddTriangle(surf,v0,v5,v4) ; side triangle 2 t6=dxAddTriangle(surf,v2,v4,v5) ; top triangle 1 t7=dxAddTriangle(surf,v2,v3,v4) ; top triangle 2 ; Now we will position our ramp in front of the camera so we can see it! dxPositionEntity ramp,0,-4,10 ; Enable dxWireframe mode so we can see structure of model more clearly dxWireframe True ; And a quick loop that renders the scene and displays the contents on the screen until we press esc While Not dxKeyDown(1) ; Constantly turn our ramp entity to show it off a bit dxTurnEntity ramp,0,1,0 dxRenderWorld dxFlip Wend ; The end! End |