glCopyTexImage2D 함수

아티클
06/13/2023

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	의미
GL_INVALID_ENUM	target 이 허용되는 값이 아닙니다.
GL_INVALID_VALUE	level 이 log2 max보다 작거나 0보다 큽니다. 여기서 max 는 반환된 GL_MAX_TEXTURE_SIZE 값입니다.
GL_INVALID_VALUE	테두리 가 0 또는 1이 아닙니다.
GL_INVALID_VALUE	width가 0보다 작거나, 2 + GL_MAX_TEXTURE_SIZE보다 크거나, 일부 정수 n의 경우 너비를 2n + 2 * 테두리로 나타낼 수 없습니다.
GL_INVALID_OPERATION	함수는 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와 관련된 정보를 검색합니다.

인수 GL_TEXTURE_2D glIsEnabled

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	Gl.h
라이브러리	Opengl32.lib
DLL	Opengl32.dll

추가 정보

glBegin
glCopyTexImage1D
glDrawPixels
glEnd
glFog
glPixelStore
glPixelTransfer
glTexEnv
glTexGen
glTexImage1D
glTexImage2D
glTexParameter

다음을 통해 공유