OGSF library - setting and manipulating keyframes animation (lower level functions) More...
#include <stdlib.h>#include <math.h>#include <grass/gis.h>#include <grass/glocale.h>#include <grass/ogsf.h>
Go to the source code of this file.
Functions | |
| Keylist * | gk_copy_key (Keylist *k) |
| Copy keyframes. More... | |
| unsigned long | gk_get_mask_sofar (float time, Keylist *keys) |
| Get mask value. More... | |
| int | gk_viable_keys_for_mask (unsigned long mask, Keylist *keys, Keylist **keyret) |
| ADD. More... | |
| void | gk_follow_frames (Viewnode *view, int numsteps, Keylist *keys, int step, int onestep, int render, unsigned long mode) |
| Checks key masks. More... | |
| void | gk_free_key (Keylist *ok) |
| Free keyframe list. More... | |
| Viewnode * | gk_make_framesfromkeys (Keylist *keys, int keysteps, int newsteps, int loop, float t) |
| Generate viewnode from keyframes. More... | |
| double | get_key_neighbors (int nvk, double time, double range, int loop, Keylist *karray[], Keylist **km1, Keylist **kp1, Keylist **kp2, Keylist **km2, double *dt1, double *dt2) |
| Find interval containing time. More... | |
| double | lin_interp (float dt, float val1, float val2) |
| Linear interpolation. More... | |
| double | get_2key_neighbors (int nvk, float time, float range, int loop, Keylist *karray[], Keylist **km1, Keylist **kp1) |
| Finds interval containing time, putting left (or equal) key at km1, right at kp1. More... | |
| Viewnode * | gk_make_linear_framesfromkeys (Keylist *keys, int keysteps, int newsteps, int loop) |
| Generate viewnode from keyframe list (linear interpolation) More... | |
| void | correct_twist (Keylist *k) |
| Correct twist value. More... | |
| int | gk_draw_path (Viewnode *views, int steps, Keylist *keys) |
| Draw path. More... | |
Detailed Description
OGSF library - setting and manipulating keyframes animation (lower level functions)
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 gk.c.
Function Documentation
◆ correct_twist()
| void correct_twist | ( | Keylist * | k | ) |
Correct twist value.
- Parameters
-
k keyframe list
Definition at line 700 of file gk.c.
Referenced by gk_make_linear_framesfromkeys().
◆ get_2key_neighbors()
| double get_2key_neighbors | ( | int | nvk, |
| float | time, | ||
| float | range, | ||
| int | loop, | ||
| Keylist * | karray[], | ||
| Keylist ** | km1, | ||
| Keylist ** | kp1 | ||
| ) |
Finds interval containing time, putting left (or equal) key at km1, right at kp1.
- Parameters
-
nvk time range loop karray km1 km2
- Returns
- interval value
Definition at line 558 of file gk.c.
References NULL, and key_node::pos.
Referenced by gk_make_linear_framesfromkeys().
◆ get_key_neighbors()
| double get_key_neighbors | ( | int | nvk, |
| double | time, | ||
| double | range, | ||
| int | loop, | ||
| Keylist * | karray[], | ||
| Keylist ** | km1, | ||
| Keylist ** | kp1, | ||
| Keylist ** | kp2, | ||
| Keylist ** | km2, | ||
| double * | dt1, | ||
| double * | dt2 | ||
| ) |
Find interval containing time.
Changed June 94 to handle masks - now need to have called get_viable_keys for appropriate mask first to build the ARRAY of viable keyframes.
Putting left (or equal) key at km1, right at kp1, 2nd to right at kp2, and second to left at km2. dt1 is given the length of the current + left intervals dt2 is given the length of the current + right intervals
- Parameters
-
nvk time range loop karray km1 kp1 kp2 km2 dt1 dt2
- Returns
- the length of the current interval
- 0 on error
Definition at line 455 of file gk.c.
References NULL, and key_node::pos.
◆ gk_copy_key()
Copy keyframes.
- Parameters
-
k source keyframes
- Returns
- pointer to Keylist struct (target)
Definition at line 45 of file gk.c.
References key_node::fieldmask, key_node::fields, G_malloc, KF_NUMFIELDS, key_node::look_ahead, key_node::next, NULL, key_node::pos, and key_node::prior.
◆ gk_draw_path()
◆ gk_follow_frames()
◆ gk_free_key()
| void gk_free_key | ( | Keylist * | ok | ) |
Free keyframe list.
- Parameters
-
ok pointer to Keylist struct
Definition at line 271 of file gk.c.
References G_free(), and key_node::next.
Referenced by GK_clear_keys().
◆ gk_get_mask_sofar()
| unsigned long gk_get_mask_sofar | ( | float | time, |
| Keylist * | keys | ||
| ) |
Get mask value.
Get begin & end pos, AND all masks in keys <= pos
Time must be between 0.0 & 1.0
- Parameters
-
time timestamp keys list of keyframes
- Returns
- mask value
Definition at line 79 of file gk.c.
References key_node::fieldmask, key_node::next, and key_node::pos.
◆ gk_make_framesfromkeys()
◆ gk_make_linear_framesfromkeys()
Generate viewnode from keyframe list (linear interpolation)
Here we use linear interpolation. Loop variable isn't used, but left in for use in possible "linear interp with smoothing" version.
- Parameters
-
kesy keyframe list keysteps step value newsteps new step value loop loop indicator pointer to viewnode struct NULL on failure
Definition at line 604 of file gk.c.
References _, correct_twist(), view_node::fields, key_node::fields, G_free(), G_malloc, G_warning(), get_2key_neighbors(), gk_viable_keys_for_mask(), KF_NUMFIELDS, lin_interp(), key_node::next, NULL, and key_node::pos.
◆ gk_viable_keys_for_mask()
ADD.
- Parameters
-
mask mask value keys list of keyframes [out] keyret output list of keyframes
- Returns
- number of output keyframes
Definition at line 112 of file gk.c.
References key_node::fieldmask, and key_node::next.
Referenced by gk_make_linear_framesfromkeys().
◆ lin_interp()
| double lin_interp | ( | float | dt, |
| float | val1, | ||
| float | val2 | ||
| ) |
Linear interpolation.
- Parameters
-
dt coeficient val2 value 2 val1 value 1
- Returns
- val1 + dt * (val2 - val1)
Definition at line 539 of file gk.c.
Referenced by gk_make_linear_framesfromkeys().
