diguyCharacterPathScriptBead.h

Go to the documentation of this file.

/*********************************************************************
 ** Copyright (c) 1992-2015 VT MAK
 ** All rights reserved. 
 *********************************************************************/

/*********************************************************************
 **
 *t  diguyCharacterPathScriptBead
 **
 *b    Link against: libdiguy
 */

#ifndef __diguyCharacterPathScriptBead_H
#define __diguyCharacterPathScriptBead_H

#ifdef SWIG
%module diguyCharacterPathScriptBead
#else
#define CPLUSPLUS_ONLY
#endif

#ifdef CPLUSPLUS_ONLY
class bdiBeadScript;
#endif


#include <declspec_diguy.h>

/****************************************************************************/
class BDI_DECLSPEC_diguy diguyCharacterPathScriptBead
{

public:
/*****************************************************************************/
        /*l
         *b  Description:
         **
         **    Returns the name of the object.  This pointer will
         **    never be NULL.
         **
         *b  Returns:
         **
         **    name of the object
         */
        const char* get_name();

        /*l
         *b  Description:
         **
         **    This function sets the name of this object.
         **
         *b  Returns:
         **
         **    0 on success, -1 on failure
         */
        int set_name(const char* name);

        /*l
         *b  Description:
         **
         **    This function returns the script this bead performs.
         **
         *b  Returns:
         **
         **    script to perform; empty string if no script set
         */
        const char* get_script();

        /*l
         *b  Description:
         **
         **    This function sets the script this bead performs.  When
         **    a character is traversing the path containing this
         **    bead, the specified script will be performed when this bead
         **    is reached.
         **
         **    If this script bead is part of a diguyCharacterPath,
         **    the diguyCharacterPath::update() function must be called for
         **    changes to take effect.
         **
         *b  Arguments:
         **
         *a    script - the script that should be evaluated when
         *a             this bead is reached; pass NULL to un-set
         *a             the script
         **
         *b  Returns:
         **
         **    0 on success, -1 on failure
         */
        int set_script(const char* script);

        /*l
         *b  Description:
         **
         **    This function sets the script type of this bead. This can only
         **    be "lua".
         **
         *b  Arguments:
         **
         *a    script_type - the language of the script
         **
         *b  Returns:
         **
         **    0 on success, -1 on failure
         */
        int set_script_type(const char* script);

        /*l
         *b  Returns:
         **
         **    The language of the script
         */

        const char* get_script_type();

        /*l
         *b  Description:
         **
         **    This function returns how far into the path this bead is.
         **
         *b  Returns:
         **
         **    distance into path of this bead, in meters
         */
        float get_distance_into_path();

        /*l
         *b  Description:
         **
         **    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.
         **
         *b  Arguments:
         **
         *a    distance_into_path - how far into the path this bead is,
         *a                         in meters
         **
         *b  Returns:
         **
         **    0 on success, -1 on failure
         */
        int set_distance_into_path(float distance_into_path);

        /*l
         *b  Description:
         **
         **    This function returns where on the path this bead is.
         **
         *b  Returns:
         **
         **    location of this bead, in meters
         */
        float get_length();

        /*l
         *b  Description:
         **
         **    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.
         **
         *b  Arguments:
         **
         *a    duration - duration of this bead, in seconds
         **
         *b  Returns:
         **
         **    0 on success, -1 on failure
         */
        int set_length(float length);

        /*l
         *b  Description:
         **
         **    This function returns when on the path this bead is.
         **
         *b  Returns:
         **
         **    time location of this bead, in seconds
         */
        float get_tin();

        /*l
         *b  Description:
         **
         **    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.
         **
         *b  Arguments:
         **
         *a    tin - when this bead begins to have an effect, in seconds
         **
         *b  Returns:
         **
         **    0 on success, -1 on failure
         */
        int set_tin(float tin);

        /*l
         *b  Description:
         **
         **    This function returns how long this bead will have an
         **    effect.
         **
         *b  Returns:
         **
         **    duration of this bead, in seconds
         */
        float get_duration();

        /*l
         *b  Description:
         **
         **    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.
         **
         *b  Arguments:
         **
         *a    duration - duration of this bead, in seconds
         **
         *b  Returns:
         **
         **    0 on success, -1 on failure
         */
        int set_duration(float duration);


/****************************************************************************/
/****************************************************************************/
/****************************************************************************/
/****************************************************************************/
/****************************************************************************/
/****************************************************************************/

        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);


/****************************************************************************/
/****************************************************************************/

#ifdef CPLUSPLUS_ONLY

        bdiBeadScript* get_scripted_object() {return m_scripted_object;}

        friend class bdiBeadScript;

private:

        /*l
         **    A private constructor.
         */
        diguyCharacterPathScriptBead(bdiBeadScript* scripted_object);

        /*l
         **    A private destructor.
         */
        ~diguyCharacterPathScriptBead();

        /*l
         **    A pointer to internal data.
         */
        bdiBeadScript* m_scripted_object;

#endif

};


#endif /* __diguyCharacterPathScriptBead_H */


/*********************************************************************
 ** Copyright (c) 1992-2015 VT MAK
 ** All rights reserved. 
 *********************************************************************/