Fonction gluNurbsProperty

Article
06/13/2023

La fonction gluNurbsProperty définit une propriété NURBS (Non-Uniform Rational B-Spline).

Syntaxe

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

Paramètres

nobj

Objet NURBS (créé avec gluNewNurbsRenderer).

property

Propriété à définir. Les valeurs suivantes sont valides :

Value	Signification
GLU_SAMPLING_TOLERANCE	Spécifie la longueur maximale, en pixels, à utiliser lorsque la méthode d’échantillonnage est définie sur GLU_PATH_LENGTH. La valeur par défaut est 50,0 pixels.
GLU_DISPLAY_MODE	Le paramètre value définit la façon dont une surface NURBS doit être rendue. Vous pouvez définir la valeur GLU_FILL, GLU_OUTLINE_POLYGON ou GLU_OUTLINE_PATCH. GLU_FILL. La surface est rendue sous la forme d’un ensemble de polygones. Il s’agit de la valeur par défaut. GLU_OUTLINE_POLYGON. La bibliothèque NURBS dessine uniquement les contours des polygones créés par la superposition. GLU_OUTLINE_PATCH. Seuls les contours des correctifs et des courbes de coupe définis par l’utilisateur sont dessinés.
GLU_CULLING	Le paramètre value est une valeur booléenne. Lorsque la valeur est définie sur GL_TRUE, les courbes NURBS dont les points de contrôle se trouvent en dehors de la fenêtre d’affichage actuelle sont ignorées avant le pavage. La valeur par défaut est GL_FALSE (car une courbe NURBS ne peut pas se trouver entièrement dans la coque convexe de ses points de contrôle).
GLU_AUTO_LOAD_MATRIX	Le paramètre value est une valeur booléenne. Lorsqu’il est défini sur GL_TRUE, le code NURBS télécharge la matrice de projection, la matrice modelview et la fenêtre d’affichage à partir du serveur OpenGL pour calculer l’échantillonnage et l’élimination des matrices pour chaque courbe NURBS rendue. Des matrices d’échantillonnage et d’élimination sont nécessaires pour déterminer la superposition d’une surface NURBS en segments de ligne ou polygones et pour éliminer une surface NURBS si elle se trouve en dehors de la fenêtre d’affichage. Si ce mode est défini sur GL_FALSE, vous devez fournir une matrice de projection, une matrice modelview et une fenêtre d’affichage pour que le convertisseur NURBS utilise pour construire des matrices d’échantillonnage et d’élimination. Vous pouvez le faire avec la fonction gluLoadSamplingMatrices . La valeur par défaut de ce mode est GL_TRUE. Le fait de passer de GL_TRUE à GL_FALSE n’affecte pas les matrices d’échantillonnage et d’élimination tant que vous n’appelez pas gluLoadSamplingMatrices. Les paramètres de propriété suivants sont pris en charge dans GLU version 1.1 ou ultérieure et ne sont pas valides pour GLU version 1.0 : GLU_PARAMETRIC_TOLERANCE, GLU_SAMPLING_METHOD, GLU_U_STEP et GLU_V_STEP. Les paramètres de valeur suivants sont pris en charge dans GLU version 1.1 ou ultérieure et ne sont pas valides pour GLU version 1.0 : GLU_PATH_LENGTH, GLU_PARAMETRIC_ERROR et GLU_DOMAIN_DISTANCE.
GLU_PARAMETRIC_TOLERANCE	Spécifie la distance maximale, en pixels, à utiliser lorsque la méthode d’échantillonnage est définie sur GLU_PARAMETRIC_ERROR. La valeur par défaut est 0,5.
GLU_SAMPLING_METHOD	Spécifie comment tessallater une surface NURBS. GLU_SAMPLING_METHOD peut avoir l’une des trois valeurs suivantes. GLU_PATH_LENGTH. Valeur par défaut. Spécifie que les surfaces rendues avec la longueur maximale, en pixels, des bords des polygones de pavage ne sont pas supérieures à la valeur spécifiée par GLU_SAMPLING_TOLERANCE. GLU_PARAMETRIC_ERROR. Spécifie que dans le rendu de la surface, la valeur de GLU_PARAMETRIC_TOLERANCE spécifie la distance maximale, en pixels, entre les polygones de pavage et les surfaces qu’ils approximatifnt. GLU_DOMAIN_DISTANCE. Spécifie, en coordonnées paramétriques, le nombre de points d’échantillon par unité de longueur à prendre dans les dimensions u et v .
GLU_U_STEP	Spécifie le nombre de points d’échantillon par longueur d’unité pris le long de la dimension u dans les coordonnées paramétriques. La valeur de GLU_U_STEP est utilisée lorsque GLU_SAMPLING_METHOD est défini sur GLU_DOMAIN_DISTANCE. La valeur par défaut est 100.
GLU_V_STEP	Spécifie le nombre de points d’exemple par longueur d’unité pris le long de la dimension v dans les coordonnées paramétriques. La valeur de GLU_V_STEP est utilisée lorsque GLU_SAMPLING_METHOD est défini sur GLU_DOMAIN_DISTANCE. La valeur par défaut est 100.

value

Valeur à laquelle définir la propriété indiquée. Le paramètre value peut être une valeur numérique ou l’une des trois valeurs suivantes : GLU_PATH_LENGTH, GLU_PARAMETRIC_ERROR ou GLU_DOMAIN_DISTANCE.

Valeur	Signification
GLU_PATH_LENGTH	Valeur par défaut. Spécifie que les surfaces rendues avec la longueur maximale, en pixels, des bords des polygones de pavage ne sont pas supérieures à la valeur spécifiée par GLU_SAMPLING_TOLERANCE.
GLU_PARAMETRIC_ERROR	Spécifie que dans le rendu de la surface, la valeur de GLU_PARAMETRIC_TOLERANCE spécifie la distance maximale, en pixels, entre les polygones de pavage et les surfaces qu’ils approximatifnt.
GLU_DOMAIN_DISTANCE	Spécifie, en coordonnées paramétriques, le nombre de points d’échantillon par unité de longueur à prendre dans les dimensions u et v .

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

Utilisez gluNurbsProperty pour contrôler les propriétés stockées dans un objet NURBS. Ces propriétés affectent la façon dont une courbe NURBS est affichée.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Glu.h
Bibliothèque	Glu32.lib
DLL	Glu32.dll

Voir aussi

gluGetNurbsProperty
gluGetString
gluLoadSamplingMatrices
gluNewNurbsRenderer