cgGetConnectedToParameter

Langue: en

Version: 46932 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

cgGetConnectedToParameter - gets a connected destination parameter

SYNOPSIS


  #include <Cg/cg.h>







  CGparameter cgGetConnectedToParameter( CGparameter param,

                                         int index );

PARAMETERS


param
The source parameter.
index
Since there may be multiple destination (to) parameters connected to param, index is need to specify which one is returned. index must be within the range of 0 to N - 1 where N is the number of connected destination parameters.

RETURN VALUES

Returns one of the destination parameters connected to param.

Returns NULL if an error occurs.

DESCRIPTION

Returns one of the destination parameters connected to param. cgGetNumConnectedToParameters should be used to determine the number of destination parameters connected to param.

EXAMPLES


    int nParams = cgGetNumConnectedToParameters( sourceParam );







    for ( int i=0; i < nParams; ++i )

    {

      CGparameter toParam = cgGetConnectedToParameter( sourceParam, i );

      /* Do stuff with toParam ... */

    }

ERRORS

CG_INVALID_PARAM_HANDLE_ERROR is generated if param is not a valid parameter.

CG_OUT_OF_ARRAY_BOUNDS_ERROR is generated if index is less than 0 or greater than or equal to the number of parameters connected to param.

HISTORY

cgGetConnectedToParameter was introduced in Cg 1.2.

SEE ALSO

the cgConnectParameter manpage, the cgGetNumConnectedParameters manpage