OGSF library - setting and manipulating keyframes animation. More...
Go to the source code of this file.
Functions | |
| int | GK_set_interpmode (int mode) |
| Set interpolation mode. More... | |
| void | GK_set_tension (float tens) |
| Set value for tension when interpmode is KF_SPLINE. More... | |
| void | GK_showtension_start (void) |
| void | GK_showtension_stop (void) |
| Show tension stop ? More... | |
| void | GK_update_tension (void) |
| Update tension. More... | |
| void | GK_print_keys (const char *name) |
| Print keyframe info. More... | |
| void | GK_update_frames (void) |
| Recalculate path using the current number of frames requested. More... | |
| void | GK_set_numsteps (int newsteps) |
| Set the number of frames to be interpolated from keyframes. More... | |
| void | GK_clear_keys (void) |
| Deletes all keyframes, resets field masks. More... | |
| int | GK_move_key (float oldpos, float precis, float newpos) |
| Move keyframe. More... | |
| int | GK_delete_key (float pos, float precis, int justone) |
| int | GK_add_key (float pos, unsigned long fmask, int force_replace, float precis) |
| Add keyframe. More... | |
| void | GK_do_framestep (int step, int render) |
| Moves the animation to frame number "step". More... | |
| void | GK_show_path (int flag) |
| Draw the current path. More... | |
| void | GK_show_vect (int flag) |
| Show vector sets. More... | |
| void | GK_show_site (int flag) |
| Show point sets. More... | |
| void | GK_show_vol (int flag) |
| Show volumes. More... | |
| void | GK_show_list (int flag) |
| Show list. More... | |
Detailed Description
OGSF library - setting and manipulating keyframes animation.
GRASS OpenGL gsurf OGSF Library
(C) 1999-2008 by the GRASS Development Team
This program is free software under the GNU General Public License (>=v2). Read the file COPYING that comes with GRASS for details.
Definition in file gk2.c.
Function Documentation
◆ GK_add_key()
| int GK_add_key | ( | float | pos, |
| unsigned long | fmask, | ||
| int | force_replace, | ||
| float | precis | ||
| ) |
Add keyframe.
The pos value is the relative position in the animation for this particular keyframe - used to compare relative distance to neighboring keyframes, it can be any floating point value.
The fmask value can be any of the following or'd together:
- KF_FROMX_MASK
- KF_FROMY_MASK
- KF_FROMZ_MASK
- KF_FROM_MASK (KF_FROMX_MASK | KF_FROMY_MASK | KF_FROMZ_MASK)
- KF_DIRX_MASK
- KF_DIRY_MASK
- KF_DIRZ_MASK
- KF_DIR_MASK (KF_DIRX_MASK | KF_DIRY_MASK | KF_DIRZ_MASK)
- KF_FOV_MASK
- KF_TWIST_MASK
- KF_ALL_MASK (KF_FROM_MASK | KF_DIR_MASK | KF_FOV_MASK | KF_TWIST_MASK)
Other fields will be added later.
The value precis and the boolean force_replace are used to determine if a keyframe should be considered to be at the same position as a pre-existing keyframe. e.g., if anykey.pos - newkey.pos <= precis, GK_add_key() will fail unless force_replace is TRUE.
- Parameters
-
pos position fmaks force_replace precis precision value
- Returns
- 1 if key is added
- -1 key not added
◆ GK_clear_keys()
| void GK_clear_keys | ( | void | ) |
Deletes all keyframes, resets field masks.
Doesn't change number of frames requested.
Definition at line 310 of file gk2.c.
References gk_free_key(), and NULL.
◆ GK_delete_key()
| int GK_delete_key | ( | float | pos, |
| float | precis, | ||
| int | justone | ||
| ) |
Delete keyframe
The values pos and precis are used to determine which keyframes to delete. Any keyframes with their position within precis of pos will be deleted if justone is zero. If justone is non-zero, only the first (lowest pos) keyframe in the range will be deleted.
- Parameters
-
pos position precis precision justone delete only one keyframe
- Returns
- number of keys deleted.
◆ GK_do_framestep()
| void GK_do_framestep | ( | int | step, |
| int | render | ||
| ) |
◆ GK_move_key()
| int GK_move_key | ( | float | oldpos, |
| float | precis, | ||
| float | newpos | ||
| ) |
Move keyframe.
Precis works as in other functions - to identify keyframe to move. Only the first keyframe in the precis range will be moved.
- Parameters
-
oldpos old position precis precision value newpos new position
- Returns
- number of keys moved (1 or 0)
Definition at line 336 of file gk2.c.
References key_node::next, and key_node::pos.
◆ GK_print_keys()
| void GK_print_keys | ( | const char * | name | ) |
Print keyframe info.
- Parameters
-
name filename
Definition at line 209 of file gk2.c.
References _, key_node::fields, G_fatal_error(), KF_DIRX, KF_DIRY, KF_DIRZ, KF_FOV, KF_FROMX, KF_FROMY, KF_FROMZ, KF_TWIST, key_node::next, NULL, and key_node::pos.
◆ GK_set_interpmode()
| int GK_set_interpmode | ( | int | mode | ) |
◆ GK_set_numsteps()
| void GK_set_numsteps | ( | int | newsteps | ) |
◆ GK_set_tension()
| void GK_set_tension | ( | float | tens | ) |
◆ GK_show_list()
◆ GK_show_path()
| void GK_show_path | ( | int | flag | ) |
◆ GK_show_site()
| void GK_show_site | ( | int | flag | ) |
◆ GK_show_vect()
| void GK_show_vect | ( | int | flag | ) |
◆ GK_show_vol()
◆ GK_showtension_start()
◆ GK_showtension_stop()
| void GK_showtension_stop | ( | void | ) |
◆ GK_update_frames()
| void GK_update_frames | ( | void | ) |
Recalculate path using the current number of frames requested.
Call after changing number of frames or when Keyframes change.
Definition at line 243 of file gk2.c.
Referenced by GK_update_tension().
◆ GK_update_tension()
| void GK_update_tension | ( | void | ) |
