NAME

       vpGetMaterial - get material properties

SYNOPSIS

       #include <volpack.h>

       vpResult
       vpGetMaterial(vpc, material, property, surface_side, r_ptr, g_ptr, b_ptr)
           vpContext *vpc;
           int material;
           int property;
           int surface_side;
           double *r_ptr, *g_ptr, *b_ptr;

ARGUMENTS

       vpc    VolPack context from vpCreateContext.

       material
              A   constant   specifying   a   particular   material  number  (VP_MATERIAL0,  VP_MATERIAL1,  ...,
              VP_MATERIAL5).

       property
              A constant specifying one material property (VP_AMBIENT, VP_DIFFUSE, VP_SPECULAR or VP_SHINYNESS).

       surface_side
              A constant specifying one side of the material surface (VP_EXTERIOR or VP_INTERIOR).

       r_ptr, g_ptr, b_ptr
              Locations  to  store  the  RGB  components  of  the  color  associated  with  the  property.   For
              VP_SHINYNESS, g_ptr and b_ptr are not used.

DESCRIPTION

       vpGetMaterial  is  used to get the properties of a material type.  The arguments are exactly analogous to
       vpSetMaterial except that the surface_side argument  may  not  be  VP_BOTH_SIDES,  and  the  final  three
       arguments are pointers to locations for storing the material properties.

ERRORS

       The normal return value is VP_OK.  The following error return values are possible:

       VPERROR_BAD_VALUE
              The material number is invalid.

       VPERROR_BAD_OPTION
              Either the surface_side or property arguments are invalid.

SEE ALSO

       VolPack(3), vpCreateContext(3), vpSetMaterial(3)