glCopyTexSubImage1D 函式

glCopyTexSubImage1D函式會從框架緩衝區複製一維紋理影像的子影像。

語法

void WINAPI glCopyTexSubImage1D(
   GLenum  target,
   GLint   level,
   GLint   xoffset,
   GLint   x,
   GLint   y,
   GLsizei width
);

參數

目標

將變更影像資料的目標。 必須具有值GL_TEXTURE_1D。

level

詳細資料層級編號。 層級 0 是基底映射。 層級 n 是 第 n個 mipmap 縮減影像。

xoffset

紋理陣列內的紋素位移。

x

要複製之圖元列左下角的視窗 X 平面座標。

y

要複製之圖元列左下角的視窗 Y 平面座標。

寬度

紋理影像的子影像寬度。 指定寬度為零的紋理子影像沒有任何作用。

傳回值

此函式不會傳回值。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

名稱	意義
GL_INVALID_ENUM	target 不是可接受的值。
GL_INVALID_VALUE	level 小於零或 層級 大於 log2 (max) ，其中 max 是傳回的 GL_MAX_TEXTURE_SIZE 值。
GL_INVALID_VALUE	xoffset小於框線或 (xoffset + 寬度) 大於 (w + 框線) ，其中w是GL_TEXTURE_WIDTH，而框線GL_TEXTURE_BORDER。 請注意， w 包含兩倍的 框線 寬度。
GL_INVALID_VALUE	width 小於 框線 或 y 小於 框線，其中 框線 是紋理陣列的框線寬度。
GL_INVALID_OPERATION	紋理陣列不是由先前 的 glTexImage1D 作業所定義。
GL_INVALID_OPERATION	函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

備註

glCopyTexSubImage1D函式會使用目前框架緩衝區中的圖元取代一維紋理影像的一部分，而不是從主記憶體取代，就像 glTexSubImage1D的情況一樣。

以x和y指定的視窗座標為開頭的圖元列，且長度寬度會以xoffset 到 xoffset 的索引 xoffset + (width - 1) 取代紋理陣列的部分。 紋理陣列中的目的地不能包含原始指定之紋理陣列以外的任何紋素。

glCopyTexSubImage1D函式會以與 glCopyPixels相同的方式處理資料列中的圖元，不同之處在于在圖元的最終轉換之前，所有圖元元件值都會固定在範圍 [0，1] 並轉換成紋理的內部格式，以儲存在紋理陣列中。 圖元排序是以與較低紋理座標組應的 較低 x 座標來決定。 如果目前框架緩衝區之指定資料列中的任何圖元位於與目前轉譯內容相關聯的視窗外，則其值是未定義的。

不會變更指定之紋理陣列 的 internalFormat、 width或 border 參數，或變更為指定之紋理子影像之外的紋素值。

您無法在顯示清單中包含 glCopyTexSubImage1D 的呼叫。

注意

glCopyTexSubImage1D函式僅適用于 OpenGL 1.1 版或更新版本。

文字在色彩索引模式中沒有任何作用。 glPixelStore和glPixelTransfer函式會以確切方式影響使用glDrawPixels繪製圖元的方式影響紋理影像。

下列函式會擷 取與 glCopyTexSubImage1D相關的資訊：

glGetTexImage

glIsEnabled with argument GL_TEXTURE_1D

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	Gl.h
程式庫	Opengl32.lib
DLL	Opengl32.dll

另請參閱

glBegin

glCopyTexSubImage2D

glDrawPixels

glEnd

glFog

glPixelStore

glPixelTransfer

glTexEnv

glTexGen

glTexImage1D

glTexImage2D

glTexSubImage1D

glTexSubImage2D

glTexParameter