funzione glPushClientAttrib
Le funzioni glPushClientAttrib e glPopClientAttrib salvano e ripristinano i gruppi di variabili di stato client nello stack di attributi client.
Sintassi
void WINAPI glPushClientAttrib(
GLbitfield mask
);
Parametri
-
Maschera
-
Maschera che indica gli attributi da salvare. Di seguito sono riportate le costanti di maschera simbolica e i relativi stati client OpenGL associati.
Valore Significato - GL_CLIENT_PIXEL_STORE_BIT
Attributi della modalità di archiviazione pixel. - GL_CLIENT_VERTEX_ARRAY_BIT
Attributi della matrice vertice. - GL_CLIENT_ALL_ATTRIB_BITs
tutti gli attributi dello stato client impilabili.
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
Il codice di errore seguente può essere recuperato dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
La funzione è stata chiamata mentre lo stack di attributi client era pieno. |
Commenti
La funzione glPushClientAttrib usa il parametro mask per determinare quali gruppi di variabili di stato client vengono salvati nello stack di attributi client. È possibile usare l'operatore OR bit per bit per unire le costanti simboliche accettate per impostare bit e costruire una maschera.
La funzione glPopClientAttrib ripristina i valori delle variabili di stato client salvate per ultimo con glPushclientAttrib. Le variabili dello stato client non salvate in precedenza vengono lasciate invariate. Il push di attributi in uno stack di attributi client completo o l'estrazione di attributi da uno stack vuoto imposta un flag di errore e non viene apportata alcuna altra modifica allo stato OpenGL. Per impostazione predefinita, lo stack di attributi client è vuoto.
Alcuni valori di stato client OpenGL non possono essere salvati nello stack di attributi client. Ad esempio, non è possibile salvare gli stati di selezione o feedback nello stack dell'attributo client. La profondità dello stack di attributi client è almeno 16.
Le funzioni glPushclientAttrib e glPopClientAttrib non vengono compilate in elenchi di visualizzazione, ma vengono eseguite immediatamente.
Le funzioni glPushClientAttrib e glPopClientAttrib possono solo eseguire il push e le modalità di archiviazione dei pixel pop e gli stati client dell'array dei vertici. È necessario usare glPushAttrib e glPopAttrib per eseguire il push e gli stati pop mantenuti nel server.
Nota
Le funzioni glPushClientAttrib e glPopClientAttrib sono disponibili solo in OpenGL versione 1.1 o successiva.
Le funzioni seguenti recuperano informazioni correlate a glPushClientAttrib e glPopClientAttrib:
glGet con argomento GL_CLIENT_ATTRIB_STACK_DEPTH
glGet con argomento GL_MAX_CLIENT_ATTRIB_STACK_DEPTH
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|