glPixelMapusv 함수

아티클
06/13/2023

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

구문

void WINAPI glPixelMapusv(
         GLenum   map,
         GLsizei  mapsize,
   const GLushort *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

다음을 통해 공유