FreeBSD Manual Pages
add_3dmesh(3) Arcan Lua API add_3dmesh(3) NAME add_3dmesh - Load/build a mesh and attach to a model. SYNOPSIS int:meshindex add_3dmesh( vid:dstmodel, str/tbl:source ) add_3dmesh( vid:dstmodel, str/tbl:source, int:nmaps ) DESCRIPTION This function can be used to setup and attach a mesh to an open model. If source is a string, it is treated as a resource that will be passed through an internal model loader. Right now, this method of model loading is disabled and will always fail soft. The reason for that is that the parsing stage needs to move out of the main engine into the decode frame- server for safety and security. This is a temporary measure. The intermedi- ate workaround for the time being is to use the table structure along with a mesh to .lua or mesh to .json along with the builtin/json.lua parser. If source is a table, the following fields are expected: .vertices (in- dexed table) {x1, y1, z1, x2, y2, z2, ...} If the 'indices' field is provided, the number of triangles becomes #in- dices/3, otherwise the vertices field will be used directly. If the 'txcos' field is provided, it is used to add an additional set of texture coordinates. It is expected to be #vertices/3*2 in size. If the 'txcos_2' field is provided, it is used to add an addition set of texture coordinates. It is expected to be #vertices/3*2 in size. If the 'normals' field is provided, it is used to define per-vertex nor- mals, and should match #vertices. It is expected to match #vertices. If the 'colors' field is provided, it is used to define per-vertex colors, and should match #vertices/3*4. If the 'tangent' field is provided, it is used to define the tangent space to use, and the bitangents will be generated automatically. It should match #vertices/3*4. If the 'joints' field is provided, it is expected to be #vertices/3*4 uints that refer to a bone matrix uniform. If the 'weights' field is provided, it is expected to be #vertices/3*4 floats that weigh the different joint indices together. If the nmaps argument is provided (default:1), it is used specify how many texture slots that should be assigned to the mesh, and there should either be one set of texture coordinates for the entire mesh or an amount that matches the number of desired slots. Slots are consumed from the global amount of slots in the frameset attached to dstmodel . A correct model thus has model(framesetsize) = mesh(0).nmaps + ... + mesh(n).nmaps and will be divided based on the order the individual meshes were added to the model. NOTES 1 Nmaps is hard- limited to 8, matching the minimum of texture units according to the GLES 2.0 standard. 2 This function is currently only intended for static meshes. It does not provide more advanced features like interrelations/bones/skin- ning or streaming updates, though it is likely that the format will be extended to accomodate that in time. EXAMPLE function add_3dmesh0() vid = new_3dmodel(); add_3dmesh(vid, "testmesh1.ctm", 1); finalize_model(vid); show_image(vid); end MISUSE function add_3dmesh0() vid = fill_surface(32, 32, 255, 0, 0, 0); add_3dmesh(vid, "testmesh1.ctm"); end MISUSE function add_3dmesh1() vid = new_3dmodel(); add_3dmesh(vid, "testmesh1.ctm", -1); end MISUSE function add_3dmesh2() vid = new_3dmodel(); add_3dmesh(vid, "testmesh1.ctm", 10000000); end MISUSE function add_3dmesh3() vid = new_3dmodel(); add_3dmesh(vid, nil, "test"); end MISUSE function add_3dmesh4() vid = new_3dmodel(); while(true) do add_3dmesh(vid, "testmesh1.ctm", 8); end end SEE ALSO: new_3dmodel(3) finalize_3dmodel(3) swizzle_model(3) 3d August 2026 add_3dmesh(3)
NAME | SYNOPSIS | DESCRIPTION | NOTES | EXAMPLE | MISUSE | MISUSE | MISUSE | MISUSE | MISUSE | SEE ALSO:
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=add_3dmesh&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>