glTexEnvfv 함수

glTexEnvfv 함수는 텍스처 환경 매개 변수를 설정합니다.

구문

void WINAPI glTexEnvfv(
         GLenum  target,
         GLenum  pname,
   const GLfloat *params
);

매개 변수

대상

텍스처 환경입니다. GL_TEXTURE_ENV 합니다.

pname

단일 값 텍스처 환경 매개 변수의 기호 이름입니다. 허용되는 값은 GL_TEXTURE_ENV_MODE GL_TEXTURE_ENV_COLOR.

params

매개 변수 배열에 대한 포인터입니다. 단일 기호 상수 또는 RGBA 색입니다.

반환 값

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

오류 코드

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

Name 의미
GL_INVALID_ENUM
target 또는 pname 은 허용된 정의된 값 중 하나가 아니거나 매개 변수 에 정의된 상수 값( pname 값 기준)이 있어야 하고 그렇지 않은 경우입니다.
GL_INVALID_OPERATION
함수는 glBegin 호출과 glEnd에 대한 해당 호출 사이에 호출되었습니다.

설명

텍스처 환경은 조각이 텍스처화될 때 텍스처 값을 해석하는 방법을 지정합니다. 대상 매개 변수는 GL_TEXTURE_ENV 합니다. pname 매개 변수는 GL_TEXTURE_ENV_MODE 또는 GL_TEXTURE_ENV_COLOR 수 있습니다.

pname이 GL_TEXTURE_ENV_MODE 경우 매개 변수는 텍스처 함수의 기호 이름을 가리키거나 가리킵니다. 세 가지 텍스처 함수인 GL_MODULATE, GL_DECAL 및 GL_BLEND 정의됩니다.

텍스처 함수는 조각에 적용되는 텍스처 이미지 값( glTexParameter 참조)을 사용하여 조각에서 텍스처화되도록 하고 해당 조각에 대한 RGBA 색을 생성합니다. 다음 표에서는 선택할 수 있는 세 가지 텍스처 함수 각각에 대해 RGBA 색이 생성되는 방법을 보여 줍니다. C 는 RGB(색 값)의 3배이고 A 는 연결된 알파 값입니다. 텍스처 이미지에서 추출된 RGBA 값은 [0, 1] 범위에 있습니다. 아래 첨자 f 는 들어오는 조각, 텍스처 이미지에 대한 첨자 t , 텍스처 환경 색에 대한 아래 첨자 c , 첨자 v 는 텍스처 함수에서 생성된 값을 나타냅니다.

텍스처 이미지에는 텍스처 요소당 최대 4개의 구성 요소가 있을 수 있습니다( glTexImage1DglTexImage2D 참조). 단일 구성 요소 이미지에서 Lt는 단일 구성 요소를 나타냅니다. 두 구성 요소 이미지는 L?A? 를 사용합니다. 3개 구성 요소 이미지에는 색 값 C? 만 있습니다. 4개 구성 요소 이미지에는 색 값 C? 와 알파 값 A? 가 모두 있습니다.

구성 요소 수 GL_MODULATE GL_DECAL GL_BLEND
1${REMOVE}$
Cv = L?Cf undefined${REMOVE}$
Cv = (1 - L?)Cf + L?Cc
Av = Af Av = Af
2${REMOVE}$
Cv = L?Cf undefined${REMOVE}$
Cv = (1 - L?)Cf + L?Cc
Av = Af Av = Af
3${REMOVE}$
Cv = C?Cf Cv = C? undefined${REMOVE}$
Av = Af Av = Af
4${REMOVE}$
Cv = C?Cf Cv = (1 - A?)Cf + A?C? undefined${REMOVE}$
Av = A?Af Av = Af

pname이 GL_TEXTURE_ENV_COLOR 경우 매개 변수 는 4개의 값으로 구성된 RGBA 색을 포함하는 배열에 대한 포인터입니다. 정수 색 구성 요소는 가장 양수 정수가 1.0에 매핑되고 가장 음수 정수가 -1.0에 매핑되도록 선형으로 해석됩니다. 값이 지정되면 [0, 1] 범위로 고정됩니다. Cc 는 이러한 네 가지 값을 사용합니다.

GL_TEXTURE_ENV_MODE 기본값은 GL_MODULATE, GL_TEXTURE_ENV_COLOR 기본값은 (0, 0, 0, 0)입니다.

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

glTexGetEnvfv

요구 사항

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

추가 정보

glBegin

glEnd

glTexImage1D

glTexImage2D

glTexParameter