glCopyTexImage2D 함수
glCopyTexImage2D 함수는 프레임 버퍼의 픽셀을 2차원 텍스처 이미지로 복사합니다.
구문
void WINAPI glCopyTexImage2D(
GLenum target,
GLint level,
GLenum internalFormat,
GLint x,
GLint y,
GLsizei width,
GLsizei height,
GLint border
);
매개 변수
-
대상
-
이미지 데이터를 변경할 대상입니다. GL_TEXTURE_2D 값이 있어야 합니다.
-
level
-
세부 정보 수준 번호입니다. 수준 0은 기본 이미지입니다. 수준 n 은 n번째 Mipmap 감소 이미지입니다.
-
internalFormat
-
텍스처 데이터의 내부 형식 및 해상도입니다. internalFormat에는 값 1, 2, 3 및 4가 허용되지 않습니다. 매개 변수는 다음 기호 값 중 하나를 가정할 수 있습니다.
상수 R 비트 G 비트 B 비트 비트 수 L 비트 I Bits 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
-
복사할 픽셀의 사각형 영역 왼쪽 아래 모서리에 대한 창 x 평면 좌표입니다.
-
y
-
복사할 픽셀의 사각형 영역 왼쪽 아래 모서리에 대한 창 y 평면 좌표입니다.
-
width
-
텍스처 이미지의 너비입니다. 일부 정수 n의 경우 2n + 2 * 테두리여야 합니다.
-
height(높이)
-
텍스처 이미지의 높이입니다. 일부 정수 n의 경우 2n + 2 * 테두리여야 합니다.
-
테두리
-
테두리의 너비입니다. 0 또는 1이어야 합니다.
반환 값
이 함수는 값을 반환하지 않습니다.
오류 코드
glGetError 함수에서 다음 오류 코드를 검색할 수 있습니다.
| Name | 의미 |
|---|---|
|
target 이 허용되는 값이 아닙니다. |
|
level 이 log2 max보다 작거나 0보다 큽니다. 여기서 max 는 반환된 GL_MAX_TEXTURE_SIZE 값입니다. |
|
테두리 가 0 또는 1이 아닙니다. |
|
width가 0보다 작거나, 2 + GL_MAX_TEXTURE_SIZE보다 크거나, 일부 정수 n의 경우 너비를 2n + 2 * 테두리로 나타낼 수 없습니다. |
|
함수는 glBegin 호출과 glEnd에 대한 해당 호출 간에 호출되었습니다. |
설명
glCopyTexImage2D 함수는 glTexImage2D의 경우와 같이 기본 메모리가 아닌 현재 프레임 버퍼의 픽셀을 사용하여 2차원 텍스처 이미지를 정의합니다.
수준과 함께 지정된 mipmap 수준을 사용하여 텍스처 배열은 좌표 x와 y, 너비가 너비 + (2 * 테두리) 및 높이 + (2 * 테두리)와 같은 높이에 있는 왼쪽 아래 모서리가 있는 픽셀의 사각형으로 정의됩니다. 텍스처 배열의 내부 형식은 internalFormat 매개 변수로 지정됩니다.
glCopyTexImage2D 함수는 픽셀을 최종 변환하기 전에 모든 픽셀 구성 요소 값이 [0,1] 범위로 고정되고 텍스처 배열의 스토리지에 대한 텍스처의 내부 형식으로 변환된다는 점을 제외하고 glCopyPixels와 동일한 방식으로 행의 픽셀을 처리합니다. 픽셀 순서는 낮은 s 및 t 텍스처 좌표에 해당하는 낮은 x 및 y 좌표로 결정됩니다. 현재 프레임 버퍼의 지정된 행 내에 있는 픽셀이 현재 렌더링 컨텍스트와 연결된 창 외부에 있는 경우 해당 값은 정의되지 않습니다.
표시 목록에 는 glCopyTexImage2D 호출을 포함할 수 없습니다.
참고
glCopyTexImage2D 함수는 OpenGL 버전 1.1 이상에서만 사용할 수 있습니다.
텍스처는 색 인덱스 모드에 영향을 주지 않습니다. glPixelStore 및 glPixelTransfer 함수는 glDrawPixels에 영향을 미치는 방식으로 텍스처 이미지에 정확히 영향을 줍니다.
다음 함수는 glCopyTexImage2D와 관련된 정보를 검색합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|