glCopyTexImage1D 함수

아티클
06/13/2023

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	의미
GL_INVALID_ENUM	target 이 수락된 값이 아닙니다.
GL_INVALID_VALUE	level 이 0보다 작거나 log2 max보다 큽니다. 여기서 max 는 GL_MAX_TEXTURE_SIZE 반환된 값입니다.
GL_INVALID_VALUE	테두리 가 0 또는 1이 아닙니다.
GL_INVALID_VALUE	width가 0보다 작거나 2 + GL_MAX_TEXTURE_SIZE 크거나 일부 정수 n의 경우 너비를 2n +(테두리)로 나타낼 수 없습니다.
GL_INVALID_OPERATION	함수는 glBegin 호출과 glEnd에 대한 해당 호출 사이에 호출되었습니다.

설명

glCopyTexImage1D 함수는 glTexImage1D의 경우처럼 기본 메모리가 아닌 현재 프레임 버퍼의 픽셀을 사용하여 1차원 텍스처 이미지를 정의합니다.

수준과 함께 지정된 mipmap 수준을 사용하여 텍스처 배열은 x 및 y로 지정된 좌표에서 창의 왼쪽 아래 모서리에 맞춰진 픽셀 행으로 정의되며 길이는 너비 + 2 * 테두리와 같습니다. 텍스처 배열의 내부 형식은 internalFormat 매개 변수로 지정됩니다.

glCopyTexImage1D 함수는 픽셀을 최종 변환하기 전에 모든 픽셀 구성 요소 값이 [0,1] 범위로 고정되고 텍스처 배열의 스토리지에 대한 텍스처의 내부 형식으로 변환된다는 점을 제외하고 glCopyPixels와 동일한 방식으로 행의 픽셀을 처리합니다. 픽셀 순서는 낮은 텍스처 좌표에 해당하는 낮은 x 좌표로 결정됩니다. 현재 프레임 버퍼의 지정된 행 내에 있는 픽셀이 현재 렌더링 컨텍스트와 연결된 창 외부에 있는 경우 해당 값은 정의되지 않습니다.

glCopyTexImage1D에 대한 호출은 표시 목록에 포함할 수 없습니다.

참고

glCopyTexImage1D 함수는 OpenGL 버전 1.1 이상에서만 사용할 수 있습니다.

색 인덱스 모드에서는 텍스처링이 적용되지 않습니다. glPixelStore 및 glPixelTransfer 함수는 glDrawPixels에 영향을 미치는 방식으로 텍스처 이미지에 정확히 영향을 줍니다.

다음 함수는 glCopyTexImage1D와 관련된 정보를 검색합니다.

인수 GL_TEXTURE_1D glIsEnabled

요구 사항

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

추가 정보

glCopyPixels
glCopyTexImage2D
glDrawPixels
glFog
glPixelStore
glPixelTransfer
glTexEnv
glTexGen
glTexImage1D
glTexImage2D
glTexParameter

다음을 통해 공유