DI-Guy SDK Documentation  13.5
diguyCharacterPathAimBead Class Reference

A bead that sits on a character's spline path and triggers a new aim event. More...

#include <diguyCharacterPathAimBead.h>

Public Member Functions

General Functions

Unless otherwise specified, all functions callable from:

  • C++
  • Script
const char * get_name ()
 Returns the name of the object. More...
 
int set_name (const char *name)
 This function sets the name of this object. More...
 
float get_distance_into_path ()
 This function returns how far into the path this bead is. More...
 
int set_distance_into_path (float distance_into_path)
 This function sets how far into the path this bead is. More...
 
float get_length ()
 This function returns where on the path this bead is. More...
 
int set_length (float length)
 This function sets how long this bead will have an effect. More...
 
float get_tin ()
 This function returns when on the path this bead is. More...
 
int set_tin (float tin)
 This function sets when this bead will begin to have an effect. More...
 
float get_duration ()
 This function returns how long this bead will have an effect. More...
 
int set_duration (float duration)
 This function sets how long this bead will have an effect. More...
 
Experimental Functions

The following functions are experimental and may change or disappear with no warning.

const char * get_begin_at_object_name ()
 
int set_begin_at_object_name (const char *begin_at_object_name)
 
float get_begin_at_object_offset ()
 
int set_begin_at_object_offset (float begin_at_object_offset)
 
const char * get_end_at_object_name ()
 
int set_end_at_object_name (const char *end_at_object_name)
 
float get_end_at_object_offset ()
 
int set_end_at_object_offset (float end_at_object_offset)
 

Private Functions

The functions and variables past this point are for internal use only.

No external access to them is expected or necessary.

class bdiBeadAim
 
bdiBeadAimm_scripted_object
 A pointer to internal data. More...
 
bdiBeadAimget_scripted_object ()
 
 diguyCharacterPathAimBead (bdiBeadAim *scripted_object)
 A private constructor. More...
 
 ~diguyCharacterPathAimBead ()
 A private destructor. More...
 

Detailed Description

A bead that sits on a character's spline path and triggers a new aim event.

Constructor & Destructor Documentation

diguyCharacterPathAimBead::diguyCharacterPathAimBead ( bdiBeadAim scripted_object)
private

A private constructor.

diguyCharacterPathAimBead::~diguyCharacterPathAimBead ( )
private

A private destructor.

Member Function Documentation

const char* diguyCharacterPathAimBead::get_name ( )

Returns the name of the object.

This pointer will never be NULL.

Returns:

name of the object

int diguyCharacterPathAimBead::set_name ( const char *  name)

This function sets the name of this object.

Returns:

0 on success, -1 on failure

float diguyCharacterPathAimBead::get_distance_into_path ( )

This function returns how far into the path this bead is.

Returns:

distance into path of this bead, in meters

int diguyCharacterPathAimBead::set_distance_into_path ( float  distance_into_path)

This function sets how far into the path this bead is.

Since distances and times on paths are interrelated, calling this function will have the side-effect of setting when on the path the bead is located, as if to a call to set_tin().

If this script bead is part of a diguyCharacterPath, the diguyCharacterPath::update() function must be called for changes to take effect.

Parameters
distance_into_pathhow far into the path this bead is, in meters

Returns:

0 on success, -1 on failure

float diguyCharacterPathAimBead::get_length ( )

This function returns where on the path this bead is.

Returns:

location of this bead, in meters

int diguyCharacterPathAimBead::set_length ( float  length)

This function sets how long this bead will have an effect.

The bead will have an effect from its initial distance into the path (as set by set_distance_into_path()) to (distance + length) seconds.

Since distances and times on paths are interrelated, calling this function will have the side-effect of setting when on the path the bead's effect ends, as if to a call to set_duration().

If this script bead is part of a diguyCharacterPath, the diguyCharacterPath::update() function must be called for changes to take effect.

Parameters
durationduration of this bead, in seconds

Returns:

0 on success, -1 on failure

float diguyCharacterPathAimBead::get_tin ( )

This function returns when on the path this bead is.

Returns:

time location of this bead, in seconds

int diguyCharacterPathAimBead::set_tin ( float  tin)

This function sets when this bead will begin to have an effect.

Since distances and times on paths are interrelated, calling this function will have the side-effect of setting where on the path the bead is located, as if to a call to set_distance_into_path().

If this script bead is part of a diguyCharacterPath, the diguyCharacterPath::update() function must be called for changes to take effect.

Parameters
tinwhen this bead begins to have an effect, in seconds

Returns:

0 on success, -1 on failure

float diguyCharacterPathAimBead::get_duration ( )

This function returns how long this bead will have an effect.

Returns:

duration of this bead, in seconds

int diguyCharacterPathAimBead::set_duration ( float  duration)

This function sets how long this bead will have an effect.

The bead will have an effect from tin seconds (as set by set_tin()) to (tin + duration) seconds.

Since distances and times on paths are interrelated, calling this function will have the side-effect of setting where on the path the bead's effect ends, as if to a call to set_length().

If this script bead is part of a diguyCharacterPath, the diguyCharacterPath::update() function must be called for changes to take effect.

Parameters
durationduration of this bead, in seconds

Returns:

0 on success, -1 on failure

const char* diguyCharacterPathAimBead::get_begin_at_object_name ( )
int diguyCharacterPathAimBead::set_begin_at_object_name ( const char *  begin_at_object_name)
float diguyCharacterPathAimBead::get_begin_at_object_offset ( )
int diguyCharacterPathAimBead::set_begin_at_object_offset ( float  begin_at_object_offset)
const char* diguyCharacterPathAimBead::get_end_at_object_name ( )
int diguyCharacterPathAimBead::set_end_at_object_name ( const char *  end_at_object_name)
float diguyCharacterPathAimBead::get_end_at_object_offset ( )
int diguyCharacterPathAimBead::set_end_at_object_offset ( float  end_at_object_offset)
bdiBeadAim* diguyCharacterPathAimBead::get_scripted_object ( )
inline

Friends And Related Function Documentation

friend class bdiBeadAim
friend

Member Data Documentation

bdiBeadAim* diguyCharacterPathAimBead::m_scripted_object
private

A pointer to internal data.


The documentation for this class was generated from the following file: