función glMaterialf
La función glMaterialf especifica parámetros de material para el modelo de iluminación.
Sintaxis
void WINAPI glMaterialf(
GLenum face,
GLenum pname,
GLfloat param
);
Parámetros
-
Cara
-
Cara o caras que se están actualizando. Debe ser uno de los siguientes: GL_FRONT, GL_BACK o GL_FRONT y GL_BACK.
-
pname
-
Parámetro de material de valor único de la cara o caras que se actualizan. Debe ser GL_SHININESS.
Value Significado - GL_SHININESS
El parámetro param es un valor de punto flotante único que especifica el exponente especular RGBA del material. Los valores enteros se asignan directamente. Solo se aceptan los valores del intervalo [0, 128]. El exponente especular predeterminado para los materiales frontales y posteriores es 0. -
param
-
Valor en el que se establecerá el parámetro GL_SHININESS.
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 |
|---|---|
|
Face opname no era un valor aceptado. |
|
Se especificó un exponente especular fuera del intervalo de [0, 128]. |
Comentarios
La función glMaterialf asigna valores a parámetros materiales. Hay dos conjuntos coincidentes de parámetros de material. Uno, el conjunto frontal , se usa para sombrear puntos, líneas, mapas de bits y todos los polígonos (cuando la iluminación de dos lados está deshabilitada) o simplemente polígonos orientados hacia el frente (cuando se habilita la iluminación de dos lados). El otro conjunto, orientado hacia atrás, se usa para sombrear polígonos orientados hacia atrás solo cuando se habilita la iluminación de dos lados. Consulte glLightModel para obtener más información sobre los cálculos de iluminación de un lado y dos lados.
La función glMaterialf toma tres argumentos. La primera cara especifica si se modificarán los materiales GL_FRONT, los materiales GL_BACK o ambos materiales GL_FRONT_AND_BACK. El segundo, pname, especifica cuál de varios parámetros de uno o ambos conjuntos se modificará. El tercer parámetro especifica qué valor se asignará al parámetro especificado.
Los parámetros de material se usan en la ecuación de iluminación que se aplica opcionalmente a cada vértice. La ecuación se describe en glLightModel.
Los parámetros de material se pueden actualizar en cualquier momento. En concreto, se puede llamar a glMaterialf entre una llamada a glBegin y la llamada correspondiente a glEnd. Sin embargo, si solo se va a cambiar un único parámetro de material por vértice, se prefiere glColorMaterial sobre glMaterialf.
La siguiente función recupera información relacionada con glMaterialf:
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 |
|