glGetTexImage 함수

glGetTexImage 함수는 텍스처 이미지를 반환합니다.

구문

void WINAPI glGetTexImage(
   GLenum target,
   GLint  level,
   GLenum format,
   GLenum type,
   GLvoid *pixels
);

매개 변수

대상

가져올 텍스처를 지정합니다. GL_TEXTURE_1D 및 GL_TEXTURE_2D 허용됩니다.

level

원하는 이미지의 세부 정보 수준 번호입니다. 수준 0은 기본 이미지 수준입니다. 수준 n 은 n번째 Mipmap 감소 이미지입니다.

format

반환된 데이터의 픽셀 형식입니다. 지원되는 형식은 GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_LUMINANCE, GL_BGR_EXT, GL_BGRA_EXT 및 GL_LUMINANCE_ALPHA.

type

반환된 데이터의 픽셀 형식입니다. 지원되는 형식은 GL_UNSIGNED_BYTE, GL_BYTE, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT 및 GL_FLOAT.

픽셀

텍스처 이미지를 반환합니다. 형식으로 지정된 형식의 배열에 대한 포인터여야 합니다.

반환 값

이 함수는 값을 반환하지 않습니다.

오류 코드

glGetError 함수에서 다음 오류 코드를 검색할 수 있습니다.

Name	의미
GL_INVALID_ENUM	target, format 또는 type 이 허용되는 값이 아닙니다.
GL_INVALID_VALUE	level 은 0보다 작거나 로그2(최대)보다 큽니다. 여기서 max 는 GL_MAX_TEXTURE_SIZE 반환된 값입니다.
GL_INVALID_OPERATION	함수는 glBegin 호출과 glEnd 에 대한 해당 호출 간에 호출되었습니다.

설명

glGetTexImage 함수는 텍스처 이미지를 픽셀로 반환합니다. 대상 매개 변수는 원하는 텍스처 이미지가 glTexImage1D(GL_TEXTURE_1D) 또는 glTexImage2D(GL_TEXTURE_2D)로 지정된 텍스처 이미지인지 여부를 지정합니다. level 매개 변수는 원하는 이미지의 세부 정보 수준 번호를 지정합니다. 형식 및 형식 매개 변수는 원하는 이미지 배열의 형식과 형식을 지정합니다. 각각 형식 및 형식 매개 변수에 허용되는 값에 대한 설명은 glTexImage1D 및glDrawPixels를 참조하세요.

선택한 내부 4개 구성 요소 텍스처 이미지를 이미지 크기의 RGBA 색 버퍼로 간주하여 glGetTexImage 작업을 가장 잘 이해합니다. glGetTexImage의 의미 체계는 x와 y가 0으로 설정되고 너비가 텍스처 이미지의 너비(지정된 경우 테두리 포함)로 설정되고 높이가 1차원 이미지의 높이 또는 텍스처 이미지의 높이(테두리 포함)로 설정된 동일한 형식 및 형식으로 호출된 glReadPixels의 의미 체계와 동일합니다. 2차원 이미지에 대해 지정한 경우)

내부 텍스처 이미지는 RGBA 이미지이므로 픽셀 형식 GL_COLOR_INDEX, GL_STENCIL_INDEX 및 GL_DEPTH_COMPONENT 허용되지 않으며 픽셀 형식 GL_BITMAP 허용되지 않습니다.

선택한 텍스처 이미지에 4개의 구성 요소가 없는 경우 다음 매핑이 적용됩니다. 단일 구성 요소 텍스처는 빨간색이 단일 구성 요소 값으로 설정되고 녹색, 파란색 및 알파가 0으로 설정된 RGBA 버퍼로 처리됩니다.

두 구성 요소 텍스처는 RGBA 버퍼로 처리되며, 빨간색은 구성 요소 0 값으로, 알파는 구성 요소 1 값으로, 녹색과 파란색은 0으로 설정됩니다. 마지막으로, 3개 구성 요소 텍스처는 빨간색이 구성 요소 0으로 설정되고 녹색이 구성 요소 1로 설정되고 파란색이 구성 요소 2로 설정되고 알파가 0으로 설정된 RGBA 버퍼로 처리됩니다.

필요한 픽셀 크기를 확인하려면 glGetTexLevelParameter 를 사용하여 내부 텍스처 이미지의 크기를 확인한 다음 형식 및 형식에 따라 각 픽셀에 필요한 스토리지에 따라 필요한 픽셀 수를 조정합니다. 특히 GL_PACK_ALIGNMENT 픽셀 스토리지 매개 변수를 고려해야 합니다.

오류가 생성되면 픽셀 내용이 변경되지 않습니다.

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

인수 GL_PACK_ALIGNMENT 및 기타를 사용하여 glGet

인수가 GL_TEXTURE_WIDTH glGetTexLevelParameter

인수가 GL_TEXTURE_HEIGHT glGetTexLevelParameter

인수가 GL_TEXTURE_BORDER glGetTexLevelParameter

인수가 GL_TEXTURE_COMPONENTS glGetTexLevelParameter

요구 사항

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

추가 정보

glBegin

glDrawPixels

glEnd

glGetTexLevelParameter

glReadPixels

glTexImage1D

glTexImage2D