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 load- ing 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 frameserver for safety and security. This is a temporary measure. The intermediate workaround for the time being is to use the table struc- ture 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 (indexed table) {x1, y1, z1, x2, y2, z2, ...} If the 'indices' field is provided, the number of triangles becomes #indices/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 normals, and should match #vertices. It is expected to match #vertices. If the 'colors' field is provided, it is used to define per-vertex col- ors, 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 at- tached 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 interrela- tions/bones/skinning 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 April 2025 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+14.3.quarterly>