DragonFly On-Line Manual Pages

Search: Section:  


vpGetLight(3)         DragonFly Library Functions Manual         vpGetLight(3)

NAME

vpGetLight - get lighting properties

SYNOPSIS

#include <volpack.h> vpResult vpGetLight(vpc, light_num, property, n0_ptr, n1_ptr, n2_ptr) vpContext *vpc; int light_num; int property; double *n0_ptr, *n1_ptr, *n2_ptr;

ARGUMENTS

vpc VolPack context from vpCreateContext. light_num A constant specifying a particular light source (VP_LIGHT0, VP_LIGHT1, ..., VP_LIGHT5). property A constant specifying one lighting property (VP_COLOR or VP_DIRECTION). n0_ptr, n1_ptr, n2_ptr Locations for storing the result: components of an RGB color (for VP_COLOR) or a direction vector (for VP_DIRECTION).

DESCRIPTION

vpGetLight is used to get the properties of a light source. The arguments are exactly analogous to vpSetLight except that the final three arguments are pointers to locations for storing the lighting properties.

ERRORS

The normal return value is VP_OK. The following error return values are possible: VPERROR_LIMIT_EXCEEDED The light number is invalid or exceeds an implementation limit. VPERROR_BAD_OPTION The property argument is invalid.

SEE ALSO

VolPack(3), vpCreateContext(3), vpSetLight(3) VolPack vpGetLight(3)

Search: Section: