2 * Copyright (C) 2021-2023 Mt.ZERO Software, Harry Godden - All Rights Reserved
10 #define MDL_VERSION_MIN 101
11 #define MDL_VERSION_NR 105
14 k_shader_standard
= 0,
15 k_shader_standard_cutout
= 1,
16 k_shader_terrain_blend
= 2,
17 k_shader_standard_vertex_blend
= 3,
19 k_shader_invisible
= 5,
20 k_shader_boundary
= 6,
24 k_shader_foliage
= 10,
25 k_shader_override
= 30000
28 enum mdl_surface_prop
{
29 k_surface_prop_concrete
= 0,
30 k_surface_prop_wood
= 1,
31 k_surface_prop_grass
= 2,
32 k_surface_prop_tiles
= 3,
33 k_surface_prop_metal
= 4,
34 k_surface_prop_snow
= 5,
35 k_surface_prop_sand
= 6
39 k_material_flag_skate_target
= 0x0001,
40 k_material_flag_collision
= 0x0002,
41 k_material_flag_grow_grass
= 0x0004,
42 k_material_flag_grindable
= 0x0008,
43 k_material_flag_invisible
= 0x0010,
44 k_material_flag_boundary
= 0x0020,
45 k_material_flag_preview_visibile
= 0x0040,
46 k_material_flag_walking
= 0x0080,
48 k_material_flag_ghosts
=
49 k_material_flag_boundary
|
50 k_material_flag_invisible
|
51 k_material_flag_walking
63 u8 colour
[4]; /* 4*8 */
64 u16 weights
[4];/* 4*16 */
65 u8 groups
[4]; /* 4*8 */
70 typedef u32 mdl_indice
;
72 typedef struct mdl_context mdl_context
;
73 typedef struct mdl_array_ptr mdl_array_ptr
;
74 typedef struct mdl_vert mdl_vert
;
75 typedef struct mdl_transform mdl_transform
;
76 typedef struct mdl_submesh mdl_submesh
;
77 typedef struct mdl_material mdl_material
;
78 typedef struct mdl_bone mdl_bone
;
79 typedef struct mdl_armature mdl_armature
;
80 typedef struct mdl_animation mdl_animation
;
81 typedef struct mdl_transform mdl_keyframe
;
82 typedef struct mdl_mesh mdl_mesh
;
83 typedef struct mdl_file mdl_file
;
84 typedef struct mdl_texture mdl_texture
;
85 typedef struct mdl_array mdl_array
;
86 typedef struct mdl_header mdl_header
;
88 typedef struct glmesh glmesh
;
102 static void transform_identity( mdl_transform
*transform
)
104 v3_zero( transform
->co
);
105 q_identity( transform
->q
);
106 v3_fill( transform
->s
, 1.0f
);
109 static void mdl_transform_vector( mdl_transform
*transform
, v3f vec
, v3f dest
)
111 v3_mul( transform
->s
, vec
, dest
);
112 q_mulv( transform
->q
, dest
, dest
);
115 static void mdl_transform_point( mdl_transform
*transform
, v3f co
, v3f dest
)
117 mdl_transform_vector( transform
, co
, dest
);
118 v3_add( transform
->co
, dest
, dest
);
121 static void mdl_transform_mul( mdl_transform
*a
, mdl_transform
*b
,
124 mdl_transform_point( a
, b
->co
, d
->co
);
125 q_mul( a
->q
, b
->q
, d
->q
);
127 v3_mul( a
->s
, b
->s
, d
->s
);
156 v3f conevx
, conevy
, coneva
;
162 k_bone_flag_deform
= 0x00000001,
163 k_bone_flag_ik
= 0x00000002,
164 k_bone_flag_cone_constraint
= 0x00000004
169 k_bone_collider_none
= 0,
170 k_bone_collider_box
= 1,
171 k_bone_collider_capsule
= 2
176 mdl_transform transform
;
199 u16 material_id
, flags
;
204 k_submesh_flag_none
= 0x0000,
205 k_submesh_flag_consumed
= 0x0001
210 mdl_transform transform
;
214 entity_id
, /* upper 16 bits: type, lower 16 bits: index */
250 struct mdl_array_ptr
{
266 /* animation buffers */
272 u32 pack_base_offset
;
279 static void mdl_load_fatal_corrupt( mdl_context
*mdl
)
282 vg_file_print_invalid( mdl
->file
);
283 vg_fatal_error( "Corrupt model" );
287 * Model implementation
290 static const char *mdl_pstr( mdl_context
*mdl
, u32 pstr
);
292 void mdl_fread_pack_file( mdl_context
*mdl
, mdl_file
*info
, void *dst
)
294 if( !info
->pack_size
){
295 vg_warn( "path: %s\n", mdl_pstr( mdl
, info
->pstr_path
) );
296 vg_fatal_error( "Packed file is only a header; it is not packed" );
299 fseek( mdl
->file
, mdl
->pack_base_offset
+info
->pack_offset
, SEEK_SET
);
300 u64 l
= fread( dst
, info
->pack_size
, 1, mdl
->file
);
302 if( l
!= 1 ) mdl_load_fatal_corrupt( mdl
);
305 /* TODO: Rename these */
306 static void mdl_load_array_file_buffer( mdl_context
*mdl
, mdl_array
*arr
,
307 void *buffer
, u32 stride
)
309 if( arr
->item_count
){
310 fseek( mdl
->file
, arr
->file_offset
, SEEK_SET
);
312 if( stride
== arr
->item_size
){
313 u64 l
= fread( buffer
, arr
->item_size
*arr
->item_count
, 1, mdl
->file
);
314 if( l
!= 1 ) mdl_load_fatal_corrupt( mdl
);
317 vg_warn( "Applying alignment fixup to array @%p [%u -> %u] x %u\n",
318 buffer
, arr
->item_size
, stride
, arr
->item_count
);
319 if( stride
< arr
->item_size
)
320 vg_fatal_error( "not safe\n" );
322 for( u32 i
=0; i
<arr
->item_count
; i
++ ){
323 u64 l
= fread( buffer
+i
*stride
, arr
->item_size
, 1, mdl
->file
);
324 if( l
!= 1 ) mdl_load_fatal_corrupt( mdl
);
330 static void mdl_load_array_file( mdl_context
*mdl
, mdl_array_ptr
*ptr
,
331 mdl_array
*arr
, void *lin_alloc
, u32 stride
)
333 if( stride
< arr
->item_size
){
334 vg_error( "Structure max: %u. Got: %u\n", stride
, arr
->item_size
);
335 vg_fatal_error( "not safe\n" );
338 if( arr
->item_count
){
339 u32 size
= stride
*arr
->item_count
;
340 ptr
->data
= vg_linear_alloc( lin_alloc
, vg_align8(size
) );
341 mdl_load_array_file_buffer( mdl
, arr
, ptr
->data
, stride
);
347 ptr
->stride
= stride
;
348 ptr
->count
= arr
->item_count
;
351 static void *mdl_arritm( mdl_array_ptr
*arr
, u32 index
)
353 return ((u8
*)arr
->data
) + index
*arr
->stride
;
356 static u32
mdl_arrcount( mdl_array_ptr
*arr
)
361 static mdl_array
*mdl_find_array( mdl_context
*mdl
, const char *name
)
363 for( u32 i
=0; i
<mdl_arrcount(&mdl
->index
); i
++ ){
364 mdl_array
*arr
= mdl_arritm( &mdl
->index
, i
);
366 if( !strncmp(arr
->name
,name
,16) ){
374 static int _mdl_load_array( mdl_context
*mdl
, mdl_array_ptr
*ptr
,
375 const char *name
, void *lin_alloc
, u32 stride
)
377 mdl_array
*arr
= mdl_find_array( mdl
, name
);
380 mdl_load_array_file( mdl
, ptr
, arr
, lin_alloc
, stride
);
391 #define MDL_LOAD_ARRAY( MDL, PTR, STRUCT, ALLOCATOR ) \
392 _mdl_load_array( MDL, PTR, #STRUCT, ALLOCATOR, sizeof(STRUCT) )
394 static int mdl_load_mesh_block( mdl_context
*mdl
, void *lin_alloc
){
397 success
&= MDL_LOAD_ARRAY( mdl
, &mdl
->verts
, mdl_vert
, lin_alloc
);
398 success
&= MDL_LOAD_ARRAY( mdl
, &mdl
->indices
, mdl_indice
, lin_alloc
);
403 static int mdl_load_metadata_block( mdl_context
*mdl
, void *lin_alloc
){
406 success
&= _mdl_load_array( mdl
, &mdl
->strings
, "strings", lin_alloc
, 1 );
407 success
&= MDL_LOAD_ARRAY( mdl
, &mdl
->meshs
, mdl_mesh
, lin_alloc
);
408 success
&= MDL_LOAD_ARRAY( mdl
, &mdl
->submeshs
, mdl_submesh
, lin_alloc
);
409 success
&= MDL_LOAD_ARRAY( mdl
, &mdl
->materials
, mdl_material
, lin_alloc
);
410 success
&= MDL_LOAD_ARRAY( mdl
, &mdl
->textures
, mdl_texture
, lin_alloc
);
411 success
&= MDL_LOAD_ARRAY( mdl
, &mdl
->armatures
, mdl_armature
, lin_alloc
);
412 success
&= MDL_LOAD_ARRAY( mdl
, &mdl
->bones
, mdl_bone
, lin_alloc
);
413 success
&= MDL_LOAD_ARRAY( mdl
, &mdl
->animations
,mdl_animation
,lin_alloc
);
418 static int mdl_load_animation_block( mdl_context
*mdl
, void *lin_alloc
){
419 return MDL_LOAD_ARRAY( mdl
, &mdl
->keyframes
, mdl_keyframe
, lin_alloc
);
423 * if calling mdl_open, and the file does not exist, the game will fatal quit
425 static void mdl_open( mdl_context
*mdl
, const char *path
, void *lin_alloc
)
427 memset( mdl
, 0, sizeof( mdl_context
) );
428 mdl
->file
= fopen( path
, "rb" );
431 vg_error( "mdl_open('%s'): %s\n", path
, strerror(errno
) );
432 vg_fatal_error( "see above for details" );
435 u64 l
= fread( &mdl
->info
, sizeof(mdl_header
), 1, mdl
->file
);
437 mdl_load_fatal_corrupt( mdl
);
439 if( mdl
->info
.version
< MDL_VERSION_MIN
){
440 vg_warn( "For model: %s\n", path
);
441 vg_warn( " version: %u (min: %u, current: %u)\n",
442 mdl
->info
.version
, MDL_VERSION_MIN
, MDL_VERSION_NR
);
444 vg_fatal_error( "Legacy model version incompatable" );
447 mdl_load_array_file( mdl
, &mdl
->index
, &mdl
->info
.index
, lin_alloc
,
450 mdl_array
*pack
= mdl_find_array( mdl
, "pack" );
451 if( pack
) mdl
->pack_base_offset
= pack
->file_offset
;
452 else mdl
->pack_base_offset
= 0;
458 static void mdl_close( mdl_context
*mdl
)
464 /* useful things you can do with the model */
466 static void mdl_transform_m4x3( mdl_transform
*transform
, m4x3f mtx
)
468 q_m3x3( transform
->q
, mtx
);
469 v3_muls( mtx
[0], transform
->s
[0], mtx
[0] );
470 v3_muls( mtx
[1], transform
->s
[1], mtx
[1] );
471 v3_muls( mtx
[2], transform
->s
[2], mtx
[2] );
472 v3_copy( transform
->co
, mtx
[3] );
475 static const char *mdl_pstr( mdl_context
*mdl
, u32 pstr
)
477 return ((char *)mdl_arritm( &mdl
->strings
, pstr
)) + 4;
482 mdl_pstreq( mdl_context
*mdl
, u32 pstr
, const char *str
, u32 djb2
)
484 u32 hash
= *((u32
*)mdl_arritm( &mdl
->strings
, pstr
));
486 if( !strcmp( str
, mdl_pstr( mdl
, pstr
))) return 1;
492 #define MDL_CONST_PSTREQ( MDL, Q, CONSTSTR )\
493 mdl_pstreq( MDL, Q, CONSTSTR, vg_strdjb2( CONSTSTR ) )
496 * Simple mesh interface for OpenGL
497 * ----------------------------------------------------------------------------
500 static void mesh_upload( glmesh
*mesh
,
501 mdl_vert
*verts
, u32 vert_count
,
502 u32
*indices
, u32 indice_count
)
504 //assert( mesh->loaded == 0 );
506 glGenVertexArrays( 1, &mesh
->vao
);
507 glGenBuffers( 1, &mesh
->vbo
);
508 glGenBuffers( 1, &mesh
->ebo
);
509 glBindVertexArray( mesh
->vao
);
511 size_t stride
= sizeof(mdl_vert
);
513 glBindBuffer( GL_ARRAY_BUFFER
, mesh
->vbo
);
514 glBufferData( GL_ARRAY_BUFFER
, vert_count
*stride
, verts
, GL_STATIC_DRAW
);
516 glBindVertexArray( mesh
->vao
);
517 glBindBuffer( GL_ELEMENT_ARRAY_BUFFER
, mesh
->ebo
);
518 glBufferData( GL_ELEMENT_ARRAY_BUFFER
, indice_count
*sizeof(u32
),
519 indices
, GL_STATIC_DRAW
);
522 glVertexAttribPointer( 0, 3, GL_FLOAT
, GL_FALSE
, stride
, (void*)0 );
523 glEnableVertexAttribArray( 0 );
526 glVertexAttribPointer( 1, 3, GL_FLOAT
, GL_FALSE
,
527 stride
, (void *)offsetof(mdl_vert
, norm
) );
528 glEnableVertexAttribArray( 1 );
531 glVertexAttribPointer( 2, 2, GL_FLOAT
, GL_FALSE
,
532 stride
, (void *)offsetof(mdl_vert
, uv
) );
533 glEnableVertexAttribArray( 2 );
536 glVertexAttribPointer( 3, 4, GL_UNSIGNED_BYTE
, GL_TRUE
,
537 stride
, (void *)offsetof(mdl_vert
, colour
) );
538 glEnableVertexAttribArray( 3 );
541 glVertexAttribPointer( 4, 4, GL_UNSIGNED_SHORT
, GL_TRUE
,
542 stride
, (void *)offsetof(mdl_vert
, weights
) );
543 glEnableVertexAttribArray( 4 );
546 glVertexAttribIPointer( 5, 4, GL_UNSIGNED_BYTE
,
547 stride
, (void *)offsetof(mdl_vert
, groups
) );
548 glEnableVertexAttribArray( 5 );
552 mesh
->indice_count
= indice_count
;
556 static void mesh_bind( glmesh
*mesh
)
558 glBindVertexArray( mesh
->vao
);
561 static void mesh_drawn( u32 start
, u32 count
)
563 glDrawElements( GL_TRIANGLES
, count
, GL_UNSIGNED_INT
,
564 (void *)(start
*sizeof(u32
)) );
567 static void mesh_draw( glmesh
*mesh
)
569 mesh_drawn( 0, mesh
->indice_count
);
572 static void mesh_free( glmesh
*mesh
)
575 glDeleteVertexArrays( 1, &mesh
->vao
);
576 glDeleteBuffers( 1, &mesh
->ebo
);
577 glDeleteBuffers( 1, &mesh
->vbo
);
582 static void mdl_draw_submesh( mdl_submesh
*sm
)
584 mesh_drawn( sm
->indice_start
, sm
->indice_count
);
587 static mdl_mesh
*mdl_find_mesh( mdl_context
*mdl
, const char *name
)
589 for( u32 i
=0; i
<mdl_arrcount( &mdl
->meshs
); i
++ ){
590 mdl_mesh
*mesh
= mdl_arritm( &mdl
->meshs
, i
);
591 if( !strcmp( name
, mdl_pstr( mdl
, mesh
->pstr_name
))){
598 struct payload_glmesh_load
{
608 static void async_mdl_load_glmesh( void *payload
, u32 size
)
610 struct payload_glmesh_load
*job
= payload
;
611 mesh_upload( job
->mesh
, job
->verts
, job
->vertex_count
,
612 job
->indices
, job
->indice_count
);
615 static void mdl_async_load_glmesh( mdl_context
*mdl
, glmesh
*mesh
,
617 mdl_array
*arr_vertices
= mdl_find_array( mdl
, "mdl_vert" );
618 mdl_array
*arr_indices
= mdl_find_array( mdl
, "mdl_indice" );
620 if( arr_vertices
&& arr_indices
){
621 u32 size_verts
= vg_align8(sizeof(mdl_vert
)*arr_vertices
->item_count
),
622 size_indices
= vg_align8(sizeof(mdl_indice
)*arr_indices
->item_count
),
623 size_hdr
= vg_align8(sizeof(struct payload_glmesh_load
)),
624 total
= size_hdr
+ size_verts
+ size_indices
;
626 vg_async_item
*call
= vg_async_alloc( total
);
627 struct payload_glmesh_load
*job
= call
->payload
;
629 u8
*payload
= call
->payload
;
632 job
->verts
= (void*)(payload
+ size_hdr
);
633 job
->indices
= (void*)(payload
+ size_hdr
+ size_verts
);
634 job
->vertex_count
= arr_vertices
->item_count
;
635 job
->indice_count
= arr_indices
->item_count
;
637 mdl_load_array_file_buffer( mdl
, arr_vertices
,
638 job
->verts
, sizeof(mdl_vert
) );
639 mdl_load_array_file_buffer( mdl
, arr_indices
, job
->indices
,
640 sizeof(mdl_indice
) );
643 for( u32 i
=0; i
<job
->vertex_count
; i
++ ){
644 mdl_vert
*vert
= &job
->verts
[i
];
646 for( u32 j
=0; j
<4; j
++ ){
647 vert
->groups
[j
] = fixup_table
[vert
->groups
[j
]];
653 * Unpack the indices (if there are meshes)
654 * ---------------------------------------------------------
657 if( mdl_arrcount( &mdl
->submeshs
) ){
658 mdl_submesh
*sm
= mdl_arritm( &mdl
->submeshs
, 0 );
659 u32 offset
= sm
->vertex_count
;
661 for( u32 i
=1; i
<mdl_arrcount( &mdl
->submeshs
); i
++ ){
662 mdl_submesh
*sm
= mdl_arritm( &mdl
->submeshs
, i
);
663 u32
*indices
= job
->indices
+ sm
->indice_start
;
665 for( u32 j
=0; j
<sm
->indice_count
; j
++ )
666 indices
[j
] += offset
;
668 offset
+= sm
->vertex_count
;
674 * -------------------------
677 vg_async_dispatch( call
, async_mdl_load_glmesh
);
680 vg_fatal_error( "no vertex/indice data\n" );
684 /* uploads the glmesh, and textures. everything is saved into the mdl_context */
685 static void mdl_async_full_load_std( mdl_context
*mdl
){
686 mdl_async_load_glmesh( mdl
, &mdl
->mesh
, NULL
);
688 for( u32 i
=0; i
<mdl_arrcount( &mdl
->textures
); i
++ ){
689 vg_linear_clear( vg_mem
.scratch
);
690 mdl_texture
*tex
= mdl_arritm( &mdl
->textures
, i
);
692 void *data
= vg_linear_alloc( vg_mem
.scratch
, tex
->file
.pack_size
);
693 mdl_fread_pack_file( mdl
, &tex
->file
, data
);
695 vg_tex2d_load_qoi_async( data
, tex
->file
.pack_size
,
696 VG_TEX2D_CLAMP
|VG_TEX2D_NEAREST
, &tex
->glname
);