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