Función glGetMaterialfv

Las funciones glGetMaterialfv y glGetMaterialiv devuelven parámetros de material.

Sintaxis

void WINAPI glGetMaterialfv(
   GLenum  face,
   GLenum  pname,
   GLfloat *params
);

Parámetros

Cara

Especifica cuál de los dos materiales se está consultando. GL_FRONT o GL_BACK se aceptan, que representan los materiales delanteros y traseros, respectivamente.

pname

Parámetro de material que se va a devolver. Se aceptan los valores siguientes.

Value	Significado
GL_AMBIENT	El parámetro params devuelve cuatro valores enteros o de punto flotante que representan la reflectancia ambiental del material. Los valores enteros, cuando se solicitan, se asignan linealmente a partir de la representación interna de punto flotante, de modo que 1,0 se asigna al valor entero más positivo que se puede representar y -1,0 se asigna al valor entero representable más negativo. Si el valor interno está fuera del intervalo [-1,1], el valor devuelto entero correspondiente no está definido.
GL_DIFFUSE	El parámetro params devuelve cuatro valores enteros o de punto flotante que representan la reflectancia difusa del material. Los valores enteros, cuando se solicitan, se asignan linealmente a partir de la representación interna de punto flotante, de modo que 1,0 se asigna al valor entero más positivo que se puede representar y -1,0 se asigna al valor entero representable más negativo. Si el valor interno está fuera del intervalo [-1,1], el valor devuelto entero correspondiente no está definido.
GL_SPECULAR	El parámetro params devuelve cuatro valores enteros o de punto flotante que representan la reflectancia especular del material. Los valores enteros, cuando se solicitan, se asignan linealmente a partir de la representación interna de punto flotante, de modo que 1,0 se asigna al valor entero más positivo que se puede representar y -1,0 se asigna al valor entero representable más negativo. Si el valor interno está fuera del intervalo [-1,1], el valor devuelto entero correspondiente no está definido.
GL_EMISSION	El parámetro params devuelve cuatro valores enteros o de punto flotante que representan la intensidad de luz emitida del material. Los valores enteros, cuando se solicitan, se asignan linealmente a partir de la representación interna de punto flotante, de modo que 1,0 se asigna al valor entero más positivo que se puede representar y -1,0 se asigna al valor entero representable más negativo. Si el valor interno está fuera del intervalo [-1,1], el valor devuelto entero correspondiente no está definido.
GL_SHININESS	El parámetro params devuelve un valor entero o de punto flotante que representa el exponente especular del material. Los valores enteros, cuando se solicitan, se calculan redondeando el valor de punto flotante interno al valor entero más cercano.
GL_COLOR_INDEXES	El parámetro params devuelve tres valores enteros o de punto flotante que representan los índices ambientales, difusos y especulares del material. Use estos índices solo para la iluminación de índices de color. (Los demás parámetros solo se usan para la iluminación RGBA). Los valores enteros, cuando se solicitan, se calculan redondeando los valores de punto flotante interno a los valores enteros más cercanos.

params

Devuelve los datos solicitados.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar los siguientes códigos de error.

Nombre	Significado
GL_INVALID_ENUM	target o query no era un valor aceptado.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

La función glGetMaterial devuelve en parámetros el valor o los valores del parámetro pname de la cara material.

Si se genera un error, no se realiza ningún cambio en el contenido de los parámetros.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glEnd

glMaterial