Función gluNurbsProperty

La función gluNurbsProperty establece una propiedad B-Spline no uniforme (NURBS).

Sintaxis

void WINAPI gluNurbsProperty(
   GLUnurbs *nobj,
   GLenum   property,
   GLfloat  value
);

Parámetros

nobj

El objeto NURBS (creado con gluNewNurbsRenderer).

property

Propiedad que se va a establecer. Valores válidos son:

Valor	Significado
GLU_SAMPLING_TOLERANCE	Especifica la longitud máxima, en píxeles, que se va a usar cuando el método de muestreo se establece en GLU_PATH_LENGTH. El valor predeterminado es 50,0 píxeles.
GLU_DISPLAY_MODE	El parámetro value define cómo se va a representar una superficie NURBS. Puede establecer el valor en GLU_FILL, GLU_OUTLINE_POLYGON o GLU_OUTLINE_PATCH. GLU_FILL. La superficie se representa como un conjunto de polígonos. Este es el valor predeterminado. GLU_OUTLINE_POLYGON. La biblioteca NURBS dibuja solo los contornos de los polígonos creados por teselación. GLU_OUTLINE_PATCH. Solo se dibujan los contornos de las revisiones y las curvas de recorte definidas por el usuario.
GLU_CULLING	El parámetro value es un valor booleano. Cuando el valor se establece en GL_TRUE, las curvas NURBS cuyos puntos de control se encuentran fuera de la ventanilla actual se descartan antes de la teselación. El valor predeterminado es GL_FALSE (porque una curva NURBS no puede caer completamente dentro del casco convexa de sus puntos de control).
GLU_AUTO_LOAD_MATRIX	El parámetro value es un valor booleano. Cuando se establece en GL_TRUE, el código NURBS descarga la matriz de proyección, la matriz de vista del modelo y la ventanilla del servidor OpenGL para calcular el muestreo y la selección de matrices para cada curva NURBS que se representa. Se requieren matrices de muestreo y selección para determinar la teselación de una superficie NURBS en segmentos de línea o polígonos y para seleccionar una superficie NURBS si se encuentra fuera de la ventanilla. Si este modo se establece en GL_FALSE, debe proporcionar una matriz de proyección, una matriz de vista de modelos y una ventanilla para que el representador NURBS use para construir matrices de muestreo y selección. Puede hacerlo con la función gluLoadSamplingMatrices . El valor predeterminado de este modo es GL_TRUE. El cambio de este modo de GL_TRUE a GL_FALSE no afecta al muestreo y la selección de matrices hasta que se llama a gluLoadSamplingMatrices. Los parámetros de propiedad siguientes se admiten en la versión 1.1 o posterior de GLU y no son válidos para la versión 1.0 de GLU: GLU_PARAMETRIC_TOLERANCE, GLU_SAMPLING_METHOD, GLU_U_STEP y GLU_V_STEP. Los parámetros de valor siguientes se admiten en la versión 1.1 o posterior de GLU y no son válidos para la versión 1.0 de GLU: GLU_PATH_LENGTH, GLU_PARAMETRIC_ERROR y GLU_DOMAIN_DISTANCE.
GLU_PARAMETRIC_TOLERANCE	Especifica la distancia máxima, en píxeles, que se usará cuando el método de muestreo se establece en GLU_PARAMETRIC_ERROR. El valor predeterminado es 0,5.
GLU_SAMPLING_METHOD	Especifica cómo crear una superficie NURBS. GLU_SAMPLING_METHOD puede tener uno de los tres valores siguientes. GLU_PATH_LENGTH. Valor predeterminado. Especifica que las superficies representadas con la longitud máxima, en píxeles, de los bordes de los polígonos de teselación no son mayores que el valor especificado por GLU_SAMPLING_TOLERANCE. GLU_PARAMETRIC_ERROR. Especifica que en la representación de la superficie, el valor de GLU_PARAMETRIC_TOLERANCE especifica la distancia máxima, en píxeles, entre los polígonos de teselación y las superficies que se aproximan. GLU_DOMAIN_DISTANCE. Especifica, en coordenadas paramétricas, cuántos puntos de muestra por longitud de unidad se van a tomar en las dimensiones u y v .
GLU_U_STEP	Especifica el número de puntos de muestra por longitud de unidad tomada a lo largo de la dimensión u en coordenadas paramétricas. El valor de GLU_U_STEP se usa cuando GLU_SAMPLING_METHOD se establece en GLU_DOMAIN_DISTANCE. El valor predeterminado es 100.
GLU_V_STEP	Especifica el número de puntos de muestra por longitud de unidad tomada a lo largo de la dimensión v en coordenadas paramétricas. El valor de GLU_V_STEP se usa cuando GLU_SAMPLING_METHOD se establece en GLU_DOMAIN_DISTANCE. El valor predeterminado es 100.

value

Valor en el que se va a establecer la propiedad indicada. El parámetro value puede ser un valor numérico o uno de los tres valores siguientes: GLU_PATH_LENGTH, GLU_PARAMETRIC_ERROR o GLU_DOMAIN_DISTANCE.

Value	Significado
GLU_PATH_LENGTH	Valor predeterminado. Especifica que las superficies representadas con la longitud máxima, en píxeles, de los bordes de los polígonos de teselación no son mayores que el valor especificado por GLU_SAMPLING_TOLERANCE.
GLU_PARAMETRIC_ERROR	Especifica que en la representación de la superficie, el valor de GLU_PARAMETRIC_TOLERANCE especifica la distancia máxima, en píxeles, entre los polígonos de teselación y las superficies que se aproximan.
GLU_DOMAIN_DISTANCE	Especifica, en coordenadas paramétricas, cuántos puntos de muestra por longitud de unidad se van a tomar en las dimensiones u y v .

Valor devuelto

Esta función no devuelve ningún valor.

Observaciones

Use gluNurbsProperty para controlar las propiedades almacenadas en un objeto NURBS. Estas propiedades afectan a la forma en que se representa una curva NURBS.

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	Glu.h
Biblioteca	Glu32.lib
Archivo DLL	Glu32.dll

Consulte también

gluGetNurbsProperty

gluGetString

gluLoadSamplingMatrices

gluNewNurbsRenderer