glAreTexturesResident-Funktion
Die glAreTexturesResident-Funktion bestimmt, ob angegebene Texturobjekte im Texturspeicher vorhanden sind.
Syntax
GLboolean WINAPI glAreTexturesResident(
GLsizei n,
const GLuint *textures,
GLboolean *residences
);
Parameter
-
n
-
Die Anzahl der texturen, die abgefragt werden sollen.
-
Texturen
-
Die Adresse eines Arrays, das die Namen der abzufragenden Texturen enthält.
-
Residenzen
-
Die Adresse eines Arrays, in dem die Texturresidenz status zurückgegeben wird. Die Residenz status einer Textur, die durch ein Texturelement benannt wird, wird im entsprechenden Element von Residenzen zurückgegeben.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
n war ein negativer Wert, ein Element in Texturen war null, oder ein Element in Texturen enthielt keinen Texturbezeichner. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Auf Computern mit einer begrenzten Menge an Texturspeicher richtet OpenGL einen Arbeitssatz von Texturen ein, die sich im Texturspeicher befinden. Diese Texturen können viel effizienter an ein Texturziel gebunden werden als Texturen, die nicht resident sind.
Die glAreTexturesResident-Funktion fragt die Texturresidenz status der n Texturen ab, die durch die Elemente von Texturen benannt werden. Wenn alle benannten Texturen resident sind, gibt glAreTexturesResident GL_TRUE zurück, und der Inhalt der Wohnsitze ist ungestört. Wenn eine der benannten Texturen nicht ansässig ist, gibt glAreTexturesResident GL_FALSE zurück, und detaillierte status wird in den n-Elementen von Wohnsitzen zurückgegeben.
Wenn ein Element von Wohnsitzen GL_TRUE ist, ist die Textur, die durch das entsprechende Element der Texturen benannt wird, im Texturspeicher ansässig.
Um die Residenz status einer einzelnen gebundenen Textur abzufragen, rufen Sie glGetTexParameter auf, wobei der Zielparameter auf die Zieltextur festgelegt ist, an die das Ziel gebunden ist, und legen Sie den pname-Parameter auf GL_TEXTURE_RESIDENT fest. Sie müssen diese Methode verwenden, um die residente status einer Standardtextur abzufragen.
Sie können glAreTexturesResident nicht in Anzeigelisten einschließen.
Die glAreTexturesResident-Funktion gibt die Residency-status der Texturen zum Zeitpunkt des Aufrufs zurück. Es garantiert nicht, dass die Texturen zu einem anderen Zeitpunkt ansässig bleiben.
Wenn Sich Texturen im virtuellen Arbeitsspeicher befinden (es gibt keinen Texturspeicher), gelten sie als immer resident.
Hinweis
Die glAreTexturesResident-Funktion ist nur in OpenGL Version 1.1 oder höher verfügbar.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|