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 |
|---|---|
|
target o query no era un valor aceptado. |
|
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 |
|
| Biblioteca |
|
| Archivo DLL |
|