funzione glCopyTexImage2D
La funzione glCopyTexImage2D copia i pixel dal framebuffer in un'immagine di trama bidimensionale.
Sintassi
void WINAPI glCopyTexImage2D(
GLenum target,
GLint level,
GLenum internalFormat,
GLint x,
GLint y,
GLsizei width,
GLsizei height,
GLint border
);
Parametri
-
target
-
Destinazione in cui verranno modificati i dati dell'immagine. Deve avere il valore GL_TEXTURE_2D.
-
level
-
Numero di dettaglio del livello. Il livello 0 è l'immagine di base. Il livello n è l'n immaginedi riduzione mipmap.
-
internalFormat
-
Formato interno e risoluzione dei dati della trama. I valori 1, 2, 3 e 4 non sono accettati per internalFormat. Il parametro può presupporre uno dei valori simbolici seguenti.
Costante Bit R Bit G Bit B Bit Bit L Bit I GL_ALPHA GL_ALPHA4 4 GL_ALPHA8 8 GL_ALPHA12 12 GL_ALPHA16 16 GL_LUMINANCE GL_LUMINANCE4 4 GL_LUMINANCE8 8 GL_LUMINANCE12 12 GL_LUMINANCE16 16 GL_LUMINANCE_ALPHA GL_LUMINANCE4_ALPHA4 4 4 GL_LUMINANCE6_ALPHA2 2 6 GL_LUMINANCE8_ALPHA8 8 8 GL_LUMINANCE12_ALPHA4 4 12 GL_LUMINANCE12_ALPHA12 12 12 GL_LUMINANCE16_ALPHA16 16 16 GL_INTENSITY GL_INTENSITY4 4 GL_INTENSITY8 8 GL_INTENSITY12 12 GL_INTENSITY16 16 GL_RGB GL_R3_G3_B2 3 3 2 GL_RGB4 4 4 4 GL_RGB5 5 5 5 GL_RGB8 8 8 8 GL_RGB10 10 10 10 GL_RGB12 12 12 12 GL_RGB16 16 16 16 GL_RGBA GL_RGBA2 2 2 2 2 GL_RGBA4 4 4 4 4 GL_RGB5_A1 5 5 5 1 GL_RGBA8 8 8 8 8 GL_RGB10_A2 10 10 10 2 GL_RGBA12 12 12 12 12 GL_RGBA16 16 16 16 16 -
x
-
Coordinata del piano x finestra dell'angolo inferiore sinistro dell'area rettangolare dei pixel da copiare.
-
y
-
Coordinata del piano y della finestra dell'angolo inferiore sinistro dell'area rettangolare dei pixel da copiare.
-
width
-
Larghezza dell'immagine della trama. Deve essere 2n + 2 * bordo per un numero intero n.
-
height
-
Altezza dell'immagine della trama. Deve essere 2n + 2 * bordo per un numero intero n.
-
confine
-
Larghezza del bordo. Deve essere zero o 1.
Valore restituito
Questa funzione non restituisce un valore.
Codici di errore
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
target non è stato accettato. |
|
il livello è minore di zero o maggiore di log2 max, dove max è il valore restituito di GL_MAX_TEXTURE_SIZE. |
|
bordo non era zero o 1. |
|
la larghezza era minore di zero, maggiore di 2 + GL_MAX_TEXTURE_SIZE o la larghezza non può essere rappresentata come 2n + 2 * bordo per un numero intero n. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Commenti
La funzione glCopyTexImage2D definisce un'immagine di trama bidimensionale usando pixel dal framebuffer corrente, anziché dalla memoria principale, come avviee per glTexImage2D.
Usando il livello mipmap specificato con il livello, le matrici di trama sono definite come rettangolo di pixel con l'angolo inferiore sinistro situato alle coordinate x e y, la larghezza uguale a larghezza + (2 * bordo) e un'altezza uguale all'altezza + (2 * bordo). Il formato interno della matrice di trama viene specificato con il parametro internalFormat .
La funzione glCopyTexImage2D elabora i pixel in una riga nello stesso modo di glCopyPixels , ad eccezione del fatto che prima della conversione finale dei pixel, tutti i valori dei componenti pixel vengono bloccati nell'intervallo [0,1] e convertiti nel formato interno della trama per l'archiviazione nella matrice di trama. L'ordinamento dei pixel viene determinato con coordinate x ey inferiori corrispondenti alle coordinate di trama s e t inferiori. Se uno dei pixel all'interno di una riga specificata del framebuffer corrente si trovano all'esterno della finestra associata al contesto di rendering corrente, i valori non sono definiti.
Non è possibile includere chiamate a glCopyTexImage2D negli elenchi di visualizzazione.
Nota
La funzione glCopyTexImage2D è disponibile solo in OpenGL versione 1.1 o successiva.
Il texturing non ha alcun effetto in modalità color-index. Le funzioni glPixelStore e glPixelTransfer influiscono sulle immagini di trama esattamente nel modo in cui influiscono sugli glDrawPixels.
La funzione seguente recupera informazioni correlate a glCopyTexImage2D:
glIsEnabled con argomento GL_TEXTURE_2D
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|