This API deals with 3D model animation (mesh morphing)
A 3D animation is a set of 3D models that are slightly different from one another
Those 3D models are called 3D frames. For example a 3D animation of a man walking
would contain several frames for completing a whole walking cycle.
Usually the 3D character has several movements that it can perform.
(For example, walk, jump, hit, fall down etc ...) each movement is combined
of several frames and is called a 3D sequence.
To summarize it: Each 3D animation is built from many 3D frames. The 3D frames are divided
into separate 3D sequences. If it all sounds complicated then the following example will
clear things up.
my_obj=STATE_object_create_from_file("woman.md2"); The md2 files contain a 3D animation. The 3D animation is automatically loaded to the engine
my_3danim=STATE_object_get_3D_animation(my_obj);
walk_sequence=STATE_3D_animation_get_sequence_using_name(my_3danim,"walk");
standing_sequence=STATE_3D_animation_get_sequence_using_name(my_3danim,"stand");
undressing_sequence=STATE_3D_animation_get_sequence_using_name(my_3danim,"undress");
if(key_1_is_pressed) STATE_object_set_3D_sequence(my_obj,walk_sequence);
if(key_2_is_pressed) STATE_object_set_3D_sequence(my_obj,undressing_sequence);
and so on ...
Please also note the 3D_sequence API which is used in conjunction with this API
1. STATE_3D_animation_get_first
2. STATE_3D_animation_get_next 3. STATE_3D_animation_delete_all 4. STATE_3D_animation_delete 5. STATE_3D_animation_get_using_name 6. STATE_3D_animation_get_name 7. STATE_3D_animation_is_3D_animation 8. STATE_3D_animation_create_for_editing 9. STATE_3D_animation_finished_editing 10. STATE_3D_animation_get_frame_name 11. STATE_3D_animation_set_frame_name 12. STATE_3D_animation_get_number_of_triangles 13. STATE_3D_animation_get_number_of_frames 14. STATE_3D_animation_get_triangle_point 15. STATE_3D_animation_get_triangle_xyz 16. STATE_3D_animation_set_triangle_xyz 17. STATE_3D_animation_set_triangle_bmp_uv 18. STATE_3D_animation_save 19. STATE_3D_animation_set_speed
|