glPixelMapuiv 함수

아티클
06/13/2023

glPixelMapuiv 함수는 픽셀 전송 맵을 설정합니다.

구문

void WINAPI glPixelMapuiv(
         GLenum  map,
         GLsizei mapsize,
   const GLuint  *values
);

매개 변수

map

기호화된 맵 이름입니다. 10개의 맵은 다음과 같습니다.

값	의미
GL_PIXEL_MAP_I_TO_I	색 인덱스를 색 인덱스에 매핑합니다.
GL_PIXEL_MAP_S_TO_S	스텐실 인덱스를 스텐실 인덱스에 매핑합니다.
GL_PIXEL_MAP_I_TO_R	색 인덱스를 빨간색 구성 요소에 매핑합니다.
GL_PIXEL_MAP_I_TO_G	색 인덱스를 녹색 구성 요소에 매핑합니다.
GL_PIXEL_MAP_I_TO_B	색 인덱스를 파란색 구성 요소에 매핑합니다.
GL_PIXEL_MAP_I_TO_A	색 인덱스를 알파 구성 요소에 매핑합니다.
GL_PIXEL_MAP_R_TO_R	빨간색 구성 요소를 빨간색 구성 요소에 매핑합니다.
GL_PIXEL_MAP_G_TO_G	녹색 구성 요소를 녹색 구성 요소에 매핑합니다.
GL_PIXEL_MAP_B_TO_B	파란색 구성 요소를 파란색 구성 요소에 매핑합니다.
GL_PIXEL_MAP_A_TO_A	알파 구성 요소를 알파 구성 요소에 매핑합니다.

mapsize

정의되는 맵의 크기입니다.

값

맵화 값의 배열입니다.

반환 값

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

오류 코드

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

Name	의미
GL_INVALID_ENUM	map 이 허용되는 값이 아니었습니다.
GL_INVALID_VALUE	mapsize 가 음수이거나 GL_PIXEL_MAP_TABLE 이상이었습니다.
GL_INVALID_VALUE	map 은 GL_PIXEL_MAP_I_TO_I, GL_PIXEL_MAP_S_TO_S, GL_PIXEL_MAP_I_TO_R, GL_PIXEL_MAP_I_TO_G, GL_PIXEL_MAP_I_TO_B 또는 GL_PIXEL_MAP_I_TO_A, mapsize 는 2의 힘이 아니었습니다.
GL_INVALID_OPERATION	함수는 glBegin 호출과 glEnd에 대한 해당 호출 간에 호출되었습니다.

설명

glPixelMap 함수는 번역 테이블 또는 맵을 설정합니다. glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glTexSubImage1D 및 glTexSubImage2D에서 사용됩니다. 이러한 맵의 사용은 glPixelTransfer 항목에서 완전히 설명하고, 일부는 픽셀 및 텍스처 이미지 명령에 대한 topics 설명되어 있습니다. 맵의 사양만 이 항목에 설명되어 있습니다.

map 매개 변수는 설정할 10개의 맵 중 하나를 나타내는 기호화된 지도 이름입니다. mapsize 매개 변수는 맵의 항목 수를 지정하고 값은 지도값 매핑 배열에 대한 포인터입니다.

맵의 항목은 단정밀도 부동 소수점 숫자, 부호 없는 짧은 정수 또는 부호 없는 긴 정수로 지정할 수 있습니다. 색 구성 요소 값(GL_PIXEL_MAP_I_TO_I 및 GL_PIXEL_MAP_S_TO_S 제외한 모든 값)을 저장하는 맵은 지정되지 않은 가수 및 지수 크기로 해당 값을 부동 소수점 형식으로 유지합니다. glPixelMapfv로 지정된 부동 소수점 값은 이러한 맵의 내부 부동 소수점 형식으로 직접 변환된 다음 범위 [0,1]로 고정됩니다. glPixelMapusv 및 glPixelMapuiv로 지정된 부호 없는 정수 값은 가장 큰 표현 가능한 정수가 1.0에 매핑되고 0이 0.0에 매핑되도록 선형으로 변환됩니다.

인덱스, GL_PIXEL_MAP_I_TO_I 및 GL_PIXEL_MAP_S_TO_S 저장하는 맵은 이진 지점의 오른쪽에 지정되지 않은 비트 수를 사용하여 해당 값을 고정 소수점 형식으로 유지합니다. glPixelMapfv에서 지정한 부동 소수점 값은 이러한 맵의 내부 고정 소수점 형식으로 직접 변환됩니다. glPixelMapusv 및 glPixelMapuiv에서 지정한 부호 없는 정수 값은 정수 값을 지정하며, 이진 지점의 오른쪽에는 0이 모두 있습니다.

다음 표에서는 각 맵의 초기 크기 및 값을 보여 줍니다. 색 또는 스텐실 인덱스로 인덱싱된 맵은 일부 n 또는 결과가 정의되지 않은 경우 mapsize = 2 ^ n이어야 합니다. 각 맵에 허용되는 최대 크기는 구현에 따라 달라지고 인수 GL_MAX_PIXEL_MAP_TABLE glGet 을 호출하여 확인할 수 있습니다. 단일 최대값은 모든 맵에 적용되며 32개 이상입니다.

맵	조회 인덱스	조회 값	처음 크기
GL_PIXEL_MAP_I_TO_I	색 인덱스	색 인덱스	1
GL_PIXEL_MAP_S_TO_S	스텐실 인덱스	스텐실 인덱스	1
GL_PIXEL_MAP_I_TO_R	색 인덱스	R	1
GL_PIXEL_MAP_I_TO_G	색 인덱스	G	1
GL_PIXEL_MAP_I_TO_B	색 인덱스	b	1
GL_PIXEL_MAP_I_TO_A	색 인덱스	A	1
GL_PIXEL_MAP_R_TO_R	R	R	1
GL_PIXEL_MAP_G_TO_G	G	G	1
GL_PIXEL_MAP_B_TO_B	b	b	1
GL_PIXEL_MAP_A_TO_A	A	A	1

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

인수가 GL_PIXEL_MAP_I_TO_I_SIZE glGet

인수가 GL_PIXEL_MAP_S_TO_S_SIZE glGet

인수 GL_PIXEL_MAP_I_TO_R_SIZE 있는 glGet

인수가 GL_PIXEL_MAP_I_TO_G_SIZE glGet

인수가 GL_PIXEL_MAP_I_TO_B_SIZE glGet

인수 GL_PIXEL_MAP_I_TO_A_SIZE 있는 glGet

인수가 GL_PIXEL_MAP_R_TO_R_SIZE glGet

인수 GL_PIXEL_MAP_G_TO_G_SIZE 있는 glGet

인수가 GL_PIXEL_MAP_B_TO_B_SIZE glGet

인수가 GL_PIXEL_MAP_A_TO_A_SIZE glGet

인수가 GL_MAX_PIXEL_MAP_TABLE glGet

요구 사항

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

추가 정보

glBegin
glCopyPixels
glDrawPixels
glEnd
glPixelStore
glPixelTransfer
glReadPixels
glTexImage1D
glTexImage2D

다음을 통해 공유