glAlphaFunc 함수

  • 아티클

glAlphaFunc 함수를 사용하면 애플리케이션에서 알파 테스트 함수를 설정할 수 있습니다.

구문

void WINAPI glAlphaFunc(
   GLenum   func,
   GLclampf ref
);

매개 변수

func

알파 비교 함수입니다. 다음은 허용되는 기호 상수와 그 의미입니다.

값 의미
GL_NEVER
 결코 통과하지 않습니다.
GL_LESS
 들어오는 알파 값이 참조 값보다 작은 경우 전달합니다.
GL_EQUAL
 들어오는 알파 값이 참조 값과 같으면 을 전달합니다.
GL_LEQUAL
 들어오는 알파 값이 참조 값보다 작거나 같은 경우 전달합니다.
GL_GREATER
 들어오는 알파 값이 참조 값보다 크면 을 전달합니다.
GL_NOTEQUAL
 들어오는 알파 값이 참조 값과 같지 않으면 을 전달합니다.
GL_GEQUAL
 들어오는 알파 값이 참조 값보다 크거나 같은 경우 전달합니다.
GL_ALWAYS
 항상 전달합니다. 이것이 기본값입니다.

ref

들어오는 알파 값을 비교할 참조 값입니다. 이 값은 0에서 1까지의 범위로 고정됩니다. 여기서 0은 가능한 가장 낮은 알파 값과 가능한 가장 높은 값 1을 나타냅니다. 기본 참조는 0입니다.

반환 값

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

오류 코드

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

Name 의미
GL_INVALID_ENUM
 func 는 허용되는 값이 아니었습니다.
GL_INVALID_OPERATION
 함수는 glBegin 호출과 glEnd에 대한 해당 호출 사이에 호출되었습니다.

설명

알파 테스트는 들어오는 조각의 알파 값과 상수 참조 값 간의 비교 결과에 따라 조각을 삭제합니다. glAlphaFunc 함수는 참조 및 비교 함수를 지정합니다. 비교는 알파 테스트를 사용하도록 설정한 경우에만 수행됩니다. (GL_ALPHA_TEST 대한 자세한 내용은 glEnable을 참조하세요.

func 및 ref 매개 변수는 픽셀이 그려지는 조건을 지정합니다. 들어오는 알파 값은 func로 지정된 함수를 사용하여 ref와 비교됩니다. 비교가 통과되면 들어오는 조각이 후속 스텐실 및 깊이 버퍼 테스트에 조건부로 그려집니다. 비교에 실패하면 해당 픽셀 위치에서 프레임 버퍼를 변경하지 않습니다.

glAlphaFunc 함수는 점, 선, 다각형 및 비트맵의 스캔 변환과 픽셀 그리기 및 복사 작업에서 발생하는 모든 픽셀 쓰기에서 작동합니다. glAlphaFunc 함수는 화면 지우기 작업에 영향을 주지 않습니다.

알파 테스트는 RGBA 모드에서만 수행됩니다.

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

인수가 GL_ALPHA_TEST_FUNC glGet

인수가 GL_ALPHA_TEST_REF glGet

인수가 GL_ALPHA_TEST glIsEnabled

요구 사항

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

추가 정보

glBegin

glBlendFunc

glClear

glDepthFunc

glEnable

glEnd

glGet

glIsEnabled

glStencilFunc