funzione glCopyTexImage1D
La funzione glCopyTexImage1D copia i pixel dal framebuffer in un'immagine di trama unidimensionale.
Sintassi
void WINAPI glCopyTexImage1D(
GLenum target,
GLint level,
GLenum internalFormat,
GLint x,
GLint y,
GLsizei width,
GLint border
);
Parametri
-
target
-
Destinazione per cui verranno modificati i dati dell'immagine. Deve avere il valore GL_TEXTURE_1D.
-
level
-
Numero di dettaglio di livello. Il livello 0 è l'immagine di base. Il livello n è l'immagine di riduzione di nmipmap.
-
internalFormat
-
Formato interno e risoluzione dei dati della trama. Questo parametro deve essere uno dei valori simbolici seguenti.
Costante Bit R Bit G Bit B Bit Bit L Bit 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 della finestra dell'angolo inferiore sinistro della riga di pixel da copiare.
-
y
-
Coordinata del piano y della finestra dell'angolo inferiore sinistro della riga di pixel da copiare.
-
width
-
Larghezza dell'immagine della trama. Deve essere zero o 2n + 2(bordo) per un numero intero n. L'altezza dell'immagine della trama è 1.
-
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 è un valore accettato. |
|
level è 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 è minore di zero, maggiore di 2 + GL_MAX_TEXTURE_SIZE o la larghezza non può essere rappresentata come 2n +(bordo) per un numero intero n. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Commenti
La funzione glCopyTexImage1D definisce un'immagine di trama unidimensionale usando pixel dal framebuffer corrente, anziché dalla memoria principale, come nel caso di glTexImage1D.
Usando il livello mipmap specificato con il livello, le matrici di trame vengono definite come una riga in pixel allineata all'angolo inferiore sinistro della finestra in corrispondenza delle coordinate specificate da x e y, con una lunghezza uguale a larghezza + 2 * bordo. Il formato interno della matrice di trame viene specificato con il parametro internalFormat .
La funzione glCopyTexImage1D elabora i pixel in una riga allo stesso modo di glCopyPixels, tranne 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 inferiori corrispondenti alle coordinate della trama 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 relativi valori non sono definiti.
Non è possibile includere chiamate a glCopyTexImage1D negli elenchi di visualizzazione.
Nota
La funzione glCopyTexImage1D è disponibile solo in OpenGL versione 1.1 o successiva.
Il texturing non ha alcun effetto in modalità di indice dei colori. Le funzioni glPixelStore e glPixelTransfer influiscono esattamente sulle immagini delle trame nel modo in cui influiscono su glDrawPixels.
La funzione seguente recupera le informazioni correlate a glCopyTexImage1D:
glIsEnabled con argomento GL_TEXTURE_1D
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|