glBindTexture 함수

아티클
06/13/2023

glBindTexture 함수를 사용하면 텍스처 대상에 바인딩된 명명된 텍스처를 만들 수 있습니다.

구문

void WINAPI glBindTexture(
   GLenum target,
   GLuint texture
);

매개 변수

대상: 텍스처가 바인딩되는 대상입니다. 값이 GL_TEXTURE_1D 또는 GL_TEXTURE_2D 있어야 합니다.
텍스처: 텍스처의 이름입니다. 텍스처 이름은 현재 사용할 수 없습니다.

반환 값

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

오류 코드

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

Name	의미
GL_INVALID_ENUM	매개 변수 대상이 허용되는 값이 아니었습니다.
GL_INVALID_OPERATION	매개 변수 텍스처 가 대상과 같은 차원을 갖지 않았거나 glBegin 호출과 glEnd에 대한 해당 호출 사이에 함수가 호출되었습니다.

설명

glBindTexture 함수를 사용하면 명명된 텍스처를 만들 수 있습니다. 대상이 GL_TEXTURE_1D 또는 GL_TEXTURE_2D 설정되고 텍스처가 만든 새 텍스처의 이름으로 설정된 glBindTexture를 호출하면 텍스처 이름이 적절한 텍스처 대상에 바인딩됩니다. 텍스처가 대상에 바인딩되면 해당 대상에 대한 이전 바인딩이 더 이상 적용되지 않습니다.

텍스처 이름은 각 텍스처 대상의 기본 텍스처를 나타내기 위해 예약된 값이 0인 부호 없는 정수입니다. 텍스처 이름 및 해당 텍스처 콘텐츠는 현재 OpenGL 렌더링 컨텍스트의 공유 표시 목록 공간에 로컬입니다. 두 렌더링 컨텍스트는 표시 목록도 공유하는 경우에만 텍스처 이름을 공유합니다. glGenTextures를 사용하여 새 텍스처 이름 집합을 생성할 수 있습니다.

텍스처가 처음 바인딩되면 텍스처 대상의 차원을 가정합니다. GL_TEXTURE_1D 바인딩된 텍스처는 1차원이 되고 GL_TEXTURE_2D 바인딩된 텍스처는 2차원이 됩니다. 텍스처 대상에서 수행하는 작업은 대상에 바인딩된 텍스처에도 영향을 줍니다. 텍스처 대상을 쿼리할 때 반환 값은 바인딩된 텍스처의 상태입니다. 텍스처 대상은 현재 바인딩된 텍스처의 별칭이 됩니다.

glBindTexture를 사용하여 텍스처를 바인딩하는 경우 다른 텍스처가 동일한 대상에 바인딩되거나 glDeleteTextures 함수를 사용하여 바인딩된 텍스처를 삭제할 때까지 바인딩이 활성 상태로 유지됩니다. 명명된 텍스처를 만든 후에는 필요에 따라 동일한 차원을 가진 텍스처 대상에 바인딩할 수 있습니다.

일반적으로 glBindTexture 를 사용하여 glTexImage1D 또는 glTexImage2D를 사용하여 텍스처 이미지를 다시 로드하는 것보다 기존 명명된 텍스처를 텍스처 대상 중 하나에 바인딩하는 것이 훨씬 빠릅니다. 텍스처링 성능을 추가로 제어하려면 glPrioritizeTextures를 사용합니다.

glBindTexture에 대한 호출을 표시 목록에 포함할 수 있습니다.

참고

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

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

인수가 GL_TEXTURE_1D_BINDING glGet

인수가 GL_TEXTURE_2D_BINDING glGet

요구 사항

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

추가 정보

glAreTexturesResident
glDeleteTextures
glGenTextures
glGet
glGetTexParameter
glIsTexture
glPrioritizeTextures
glTexImage1D
glTexImage2D
glTexParameter

다음을 통해 공유