OGSF library - setting and manipulating keyframes animation. More...

#include <stdlib.h>
#include <grass/gis.h>
#include <grass/glocale.h>
#include <grass/gstypes.h>
#include <grass/keyframe.h>
#include <grass/kftypes.h>

Include dependency graph for GK2.c:

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

This program is free software under the GNU General Public License (>=v2). Read the file COPYING that comes with GRASS for details.

Author: Bill Brown USACERL, GMSL/University of Illinois; Doxygenized by Martin Landa <landa.martin gmail.com> (May 2008)

Definition in file GK2.c.

Function Documentation

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	postion
fmaks
force_replace
precis	precision value

Returns: 1 if key is added; -1 key not added

Definition at line 432 of file GK2.c.

References G_debug(), GK_update_frames(), GS_get_fov(), GS_get_from(), GS_get_twist(), GS_get_viewdir(), malloc(), NULL, tools::pos, X, and Y.

void GK_clear_keys ( void )

Deletes all keyframes, resets field masks.

Doesn't change number of frames requested.

Definition at line 313 of file GK2.c.

References free(), gk_free_key(), and NULL.

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.

Definition at line 370 of file GK2.c.

References free(), and GK_update_frames().

void GK_do_framestep	(	int	step,
		int	render
	)

Moves the animation to frame number "step".

Step should be a value between 1 and the number of frames. If render is non-zero, calls draw_all.

Parameters

step	step value
render

Definition at line 489 of file GK2.c.

References gk_follow_frames().

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 339 of file GK2.c.

References GK_update_frames().

void GK_print_keys ( const char * name )

Print keyframe info.

Parameters

name filename

Definition at line 212 of file GK2.c.

References fclose(), G_fatal_error(), and NULL.

int GK_set_interpmode ( int mode )

Set interpolation mode.

Parameters

mode	interpolation mode (KF_LINEAR or KF_SPLINE)

Returns: 1 on success; -1 on error (invalid interpolation mode)

Definition at line 143 of file GK2.c.

References tools::mode.

void GK_set_numsteps ( int newsteps )

Set the number of frames to be interpolated from keyframes.

Parameters

newsteps number of frames

Definition at line 300 of file GK2.c.

References GK_update_frames().

void GK_set_tension ( float tens )

Set value for tension when interpmode is KF_SPLINE.

Parameters

tens	value tens should be between 0.0; 1.0.

Definition at line 158 of file GK2.c.

References gk_draw_path(), GK_update_frames(), GS_alldraw_wire(), GS_background_color(), GS_clear(), GS_done_draw(), GS_ready_draw(), and GS_set_draw().

void GK_show_list ( int flag )

Show list.

Parameters

flag

Definition at line 614 of file GK2.c.

References GS_draw_all_list().

void GK_show_path ( int flag )

Draw the current path.

Parameters

flag

Definition at line 505 of file GK2.c.

References gk_draw_path(), GS_done_draw(), GS_ready_draw(), and GS_set_draw().

void GK_show_site ( int flag )

Show point sets.

Parameters

flag

Definition at line 558 of file GK2.c.

References GP_alldraw_site(), GS_done_draw(), GS_ready_draw(), and GS_set_draw().

void GK_show_vect ( int flag )

Show vector sets.

Parameters

flag

Definition at line 532 of file GK2.c.

References GS_done_draw(), GS_ready_draw(), GS_set_draw(), and GV_alldraw_vect().

void GK_show_vol ( int flag )

Show volumes.

Parameters

flag

Definition at line 586 of file GK2.c.

References GS_done_draw(), GS_ready_draw(), GS_set_draw(), and GVL_alldraw_vol().

void GK_showtension_start ( void )

Definition at line 178 of file GK2.c.

void GK_showtension_stop ( void )

Show tension stop ?

Use GK_showtension_start/GK_update_tension/GK_showtension_stop to initialize and stop multi-view display of path when changing tension.

Definition at line 190 of file GK2.c.

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 246 of file GK2.c.

References free(), G_warning(), gk_make_framesfromkeys(), gk_make_linear_framesfromkeys(), and NULL.

Referenced by GK_add_key(), GK_delete_key(), GK_move_key(), GK_set_numsteps(), GK_set_tension(), and GK_update_tension().

void GK_update_tension ( void )

Update tension.

Definition at line 198 of file GK2.c.

References GK_update_frames().

Functions

Detailed Description

Function Documentation