glTexEnvfv 함수

아티클
06/13/2023

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개의 구성 요소가 있을 수 있습니다( glTexImage1D 및 glTexImage2D 참조). 단일 구성 요소 이미지에서 Lt는 단일 구성 요소를 나타냅니다. 두 구성 요소 이미지는 L? 및 A? 를 사용합니다. 3개 구성 요소 이미지에는 색 값 C? 만 있습니다. 4개 구성 요소 이미지에는 색 값 C? 와 알파 값 A? 가 모두 있습니다.

구성 요소 수	GL_MODULATE	GL_DECAL	GL_BLEND
1${REMOVE}$	C_v = L?C_f	undefined${REMOVE}$	C_v = (1 - L?)C_f + L?C_c
1${REMOVE}$	A_v = A_f	undefined${REMOVE}$	A_v = A_f
2${REMOVE}$	C_v = L?C_f	undefined${REMOVE}$	C_v = (1 - L?)C_f + L?C_c
2${REMOVE}$	A_v = A_f	undefined${REMOVE}$	A_v = A_f
3${REMOVE}$	C_v = C?C_f	C_v = C?	undefined${REMOVE}$
3${REMOVE}$	A_v = A_f	A_v = A_f	undefined${REMOVE}$
4${REMOVE}$	C_v = C?C_f	C_v = (1 - A?)C_f + A?C?	undefined${REMOVE}$
4${REMOVE}$	A_v = A?A_f	A_v = A_f	undefined${REMOVE}$

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

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

다음을 통해 공유