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
GL_INVALID_ENUM	target non è un valore accettato.
GL_INVALID_VALUE	level è minore di zero o maggiore di log2 max, dove max è il valore restituito di GL_MAX_TEXTURE_SIZE.
GL_INVALID_VALUE	bordo non era zero o 1.
GL_INVALID_VALUE	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.
GL_INVALID_OPERATION	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	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glCopyPixels

glCopyTexImage2D

glDrawPixels

glFog

glPixelStore

glPixelTransfer

glTexEnv

glTexGen

glTexImage1D

glTexImage2D

glTexParameter