DirectX Graphics 레퍼런스 Direct3D C/C++ 레퍼런스 열거형 D3DFORMAT [목차열람] [주소복사] [슬롯비우기]
|
DirectX Graphics 레퍼런스 Direct3D C/C++ 레퍼런스 열거형 D3DFORMAT [목차열람] [주소복사] [슬롯비우기]
|
| Microsoft DirectX 9.0 |
다양한 종류의 표면 포맷을 정의한다.
구문
| typedef enum _D3DFORMAT { ...(values) } D3DFORMAT; |
포맷에는 몇개의 종류가 있다.
모든 포맷은, 왼쪽에서 오른쪽으로 최상정도 비트 (MSB)로부터 최하정도 비트 (LSB)의 순서에 나타나고 있다. 예를 들어, D3DFORMAT_ARGB 는, MSB 채널 A (알파)로부터 LSB 채널 B (파랑)의 순서이다. 표면 데이터를 암벽 횡단 할 때 데이터는 LSB 로부터 MSB 의 순서로 메모리에 저장 된다. 이것은, 메모리내의 채널의 순서가, LSB (파랑)로부터 MSB (알파)의 순서인 것을 의미한다.
미정도리의 채널 (G16R16 나 A8 등)을 포함한 포맷의 디폴트값은 1 이다. 유일한 예외는 A8 포맷으로, 3 개의 컬러 채널에 대해서 000 에 초기화된다.
이러한 정수는, 픽셀 셰이더에 대한 텍스처 주소 명령의 작동코드를 참조한다.
부호 없음 포맷의 데이터는, 정이 아니면 안된다. 부호 없음 포맷에서는, 적 (R), 록 (G), 청 (B), 알파 (A), 휘도(Luminance) (L), 팔레트 (P) 데이터를 조합해 사용한다. 팔레트 데이터는, 색팔레트의 인덱스 생성에 사용하므로, 컬러 인덱스 데이터라고도 부른다.
| 부호 없음 포맷의 플래그 | 값 | 포맷 |
|---|---|---|
| D3DFMT_R8G8B8 | 20 | 24 비트의 RGB 픽셀 포맷으로, 채널 근처 8 비트를 사용한다. |
| D3DFMT_A8R8G8B8 | 21 | 32 비트의 알파 첨부 ARGB 픽셀 포맷으로, 채널 근처 8 비트를 사용한다. |
| D3DFMT_X8R8G8B8 | 22 | 32 비트의 RGB 픽셀 포맷으로, 각 색에 8 비트가 확보되고 있다. |
| D3DFMT_R5G6B5 | 23 | 16 비트의 RGB 픽셀 포맷으로, 빨강에 5 비트, 초록에 6 비트, 파랑에 5 비트를 사용한다. |
| D3DFMT_X1R5G5B5 | 24 | 16 비트의 픽셀 포맷으로, 그 중 5 비트는 각 색을 위해서(때문에) 확보되고 있다. |
| D3DFMT_A1R5G5B5 | 25 | 16 비트의 픽셀 포맷으로, 각 색에 5 비트, 알파에 1 비트가 확보되고 있다. |
| D3DFMT_A4R4G4B4 | 26 | 16 비트의 ARGB 픽셀 포맷으로, 채널 마다 4 비트를 사용한다. |
| D3DFMT_R3G3B2 | 27 | 8 비트의 RGB 텍스처 포맷으로, 빨강에 3 비트, 초록에 3 비트, 파랑에 2 비트를 사용한다. |
| D3DFMT_A8 | 28 | 8 비트의 알파만. |
| D3DFMT_A8R3G3B2 | 29 | 16 비트의 ARGB 텍스처 포맷으로, 알파에 8 비트, 빨강과 초록에 각각 3 비트, 파랑에 2 비트를 사용한다. |
| D3DFMT_X4R4G4B4 | 30 | 16 비트의 RGB 픽셀 포맷으로, 색 마다 4 비트를 사용한다. |
| D3DFMT_A2B10G10R10 | 31 | 32 비트의 픽셀 포맷으로, 각 색에 10 비트, 알파에 2 비트를 사용한다. |
| D3DFMT_A8B8G8R8 | 32 | 32 비트의 알파 첨부 ARGB 픽셀 포맷으로, 채널 근처 8 비트를 사용한다. |
| D3DFMT_X8B8G8R8 | 33 | 32 비트의 RGB 픽셀 포맷으로, 각 색에 8 비트가 확보되고 있다. |
| D3DFMT_G16R16 | 34 | 32 비트의 픽셀 포맷으로, 초록과 빨강에 각각 16 비트를 사용한다. |
| D3DFMT_A2R10G10B10 | 35 | 32 비트의 픽셀 포맷으로, 적·록·청에 각각 10 비트, 알파에 2 비트를 사용한다. |
| D3DFMT_A16B16G16R16 | 36 | 64 비트의 픽셀 포맷으로, 성분 마다 16 비트를 사용한다. |
| D3DFMT_A8P8 | 40 | 8 비트의 알파가 붙은 8 비트의 컬러 인덱스 데이터. |
| D3DFMT_P8 | 41 | 8 비트의 컬러 인덱스 데이터. |
| D3DFMT_L8 | 50 | 8 비트의 휘도(Luminance)만. |
| D3DFMT_L16 | 81 | 16 비트의 휘도(Luminance)만. |
| D3DFMT_A8L8 | 51 | 16 비트로, 알파와 휘도(Luminance)에 각각 8 비트를 사용한다. |
| D3DFMT_A4L4 | 52 | 8 비트로, 알파와 휘도(Luminance)에 각각 4 비트를 사용한다. |
부호 첨부 포맷의 데이터는, 정이어도 부여도 괜찮다. 부호 첨부 포맷에서는, (U), (V), (W), (Q) 데이터를 조합해 사용한다.
| 부호 첨부 포맷의 플래그 | 값 | 포맷 |
|---|---|---|
| D3DFMT_V8U8 | 60 | 16 비트의 범프 맵 포맷으로, u 데이터와 v 데이터에 각각 8 비트를 사용한다. |
| D3DFMT_Q8W8V8U8 | 63 | 32 비트의 범프 맵 포맷으로, 채널 마다 8 비트를 사용한다. |
| D3DFMT_V16U16 | 64 | 32 비트의 범프 맵 포맷으로, 채널 마다 16 비트를 사용한다. |
| D3DFMT_Q16W16V16U16 | 110 | 64 비트의 범프 맵 포맷으로, 성분 마다 16 비트를 사용한다. |
| D3DFMT_CxV8U8 | 117 | 16 비트의 보통 압축 포맷. 텍스처 샘플러는 다음과 같이 C 채널을 계산한다. C = sqrt(1 - U2 - V2) |
믹스 포맷에는, 부호 없음 데이터와 부호 첨부 데이터를 조합해 저장 할 수 있다.
| 믹스 포맷의 플래그 | 값 | 포맷 |
|---|---|---|
| D3DFMT_L6V5U5 | 61 | 휘도(Luminance) 첨부의 16 비트 범프 맵 포맷으로, 휘도(Luminance)에 6 비트, v 와 u 에 각각 5 비트를 사용한다. |
| D3DFMT_X8L8V8U8 | 62 | 휘도(Luminance) 첨부의 32 비트 범프 맵 포맷으로, 채널 마다 8 비트를 사용한다. |
| D3DFMT_A2W10V10U10 | 67 | 32 비트의 범프 맵 포맷으로, 알파에 2 비트, w, v, u 에 각각 10 비트를 사용한다. |
4 문자 코드 (FOURCC) 포맷의 데이터는, 압축 데이터이다.
4 문자 코드를 생성하는 매크로를 다음에 나타낸다.
#define MAKEFOURCC(ch0, ch1, ch2, ch3) \
((DWORD)(BYTE)(ch0) | ((DWORD)(BYTE)(ch1) << 8) | \
((DWORD)(BYTE)(ch2) << 16) | ((DWORD)(BYTE)(ch3) << 24 ))
정의 끝난 FOURCC 포맷을 다음에 나타낸다.
| FOURCC 플래그 | 값 | 포맷 |
|---|---|---|
| D3DFMT_MULTI2_ARGB8 | MAKEFOURCC('M', 'E', 'T', '1') | MultiElement 텍스처 (압축 없음) |
| D3DFMT_G8R8_G8B8 | MAKEFOURCC('G', 'R', 'G', 'B') | YUY2 (Y0U0, Y1V0, Y2U2 등)에 유사한 16 비트에 팩 된 RGB 포맷. 색값을 올바르게 나타내기 위해서(때문에), 픽셀의 페어를 필요로 한다. 페어의 1 번째의 픽셀은, 초록의 8 비트 (상위 8 비트)와 빨강의 8 비트 (하위 8 비트)를 포함한다. 2 번째의 픽셀은, 초록의 8 비트 (상위 8 비트)와 파랑의 8 비트 (하위 8 비트)를 포함한다. 2 개의 픽셀은, 함께 빨강과 파랑의 성분을 공유하고 있지만, 동시에 각각이 고유의 초록 성분 (G0R0, G1B0, G2R2 등)을 갖는다. 텍스처 샘플러는, 픽셀 셰이더내를 참조할 경우에 색을 정규화하지 않는다. 색은 0.0f ~ 255.0f 의 범위대로 된다. 이것은 모든 프로그래밍 가능한 픽셀 셰이더 모델에 들어맞는다. 고정 기능 픽셀 셰이더에 경우는, 하드웨어로 0. f ~ 1. f 의 범위에 정규화할 필요가 있어, 본질적으로 YUY2 텍스처로서 처리할 필요가 있다. 이 포맷을 공개하는 하드웨어는,D3DCAPS9 의 PixelShader1xMaxValue 멤버가, 그 범위를 처리할 수 있는 값으로 설정되지 않으면 안 된다. |
| D3DFMT_R8G8_B8G8 | MAKEFOURCC('R', 'G', 'B', 'G') | UYVY (U0Y0, V0Y1, U2Y2 등)에 유사한 16 비트에 팩 된 RGB 포맷. 색값을 올바르게 나타내기 위해서(때문에), 픽셀의 페어를 필요로 한다. 페어의 1 번째의 픽셀은, 초록의 8 비트 (하위 8 비트)와 빨강의 8 비트 (상위 8 비트)를 포함한다. 2 번째의 픽셀은, 초록의 8 비트 (하위 8 비트)와 파랑의 8 비트 (상위 8 비트)를 포함한다. 2 개의 픽셀은, 함께 빨강과 파랑의 성분을 공유하고 있지만, 동시에 각각이 고유의 초록 성분 (R0G0, B0G1, R2G2 등)을 갖는다. 텍스처 샘플러는, 픽셀 셰이더내를 참조할 경우에 색을 정규화하지 않는다. 색은 0.0f ~ 255.0f 의 범위대로 된다. 이것은 모든 프로그래밍 가능한 픽셀 셰이더 모델에 들어맞는다. 고정 기능 픽셀 셰이더에 경우는, 하드웨어로 0. f ~ 1. f 의 범위에 정규화할 필요가 있어, 본질적으로 YUY2 텍스처로서 처리할 필요가 있다. 이 포맷을 공개하는 하드웨어는,D3DCAPS9 의 PixelShader1xMaxValue 멤버가, 그 범위를 처리할 수 있는 값으로 설정되지 않으면 안 된다. |
| D3DFMT_DXT1 | MAKEFOURCC('D', 'X', 'T', '1') | DXT1 압축 텍스처 포맷 |
| D3DFMT_DXT2 | MAKEFOURCC('D', 'X', 'T', '2') | DXT2 압축 텍스처 포맷 |
| D3DFMT_DXT3 | MAKEFOURCC('D', 'X', 'T', '3') | DXT3 압축 텍스처 포맷 |
| D3DFMT_DXT4 | MAKEFOURCC('D', 'X', 'T', '4') | DXT4 압축 텍스처 포맷 |
| D3DFMT_DXT5 | MAKEFOURCC('D', 'X', 'T', '5') | DXT5 압축 텍스처 포맷 |
| D3DFMT_UYVY | MAKEFOURCC('U', 'Y', 'V', 'Y') | UYVY 포맷 (PC98 준거) |
| D3DFMT_YUY2 | MAKEFOURCC('Y', 'U', 'Y', '2') | YUY2 포맷 (PC98 준거) |
깊이 버퍼, 스텐실 버퍼, 정점 버퍼, 인덱스 버퍼는, 각각 고유의 포맷을 갖는다.
| 버퍼 플래그 | 값 | 포맷 |
|---|---|---|
| D3DFMT_D16_LOCKABLE | 70 | 16 비트의 Z 버퍼 비트 깊이. |
| D3DFMT_D32 | 71 | 32 비트의 Z 버퍼 비트 깊이. |
| D3DFMT_D15S1 | 73 | 16 비트의 Z 버퍼 비트 깊이로, 15 비트가 깊이 채널에, 1 비트가 스텐실 채널에 확보되고 있다. |
| D3DFMT_D24S8 | 75 | 32 비트의 Z 버퍼 비트 깊이로, 깊이 채널에 24 비트, 스텐실 채널에 8 비트를 사용한다. |
| D3DFMT_D24X8 | 77 | 32 비트의 Z 버퍼 비트 깊이로, 깊이 채널에 24 비트를 사용한다. |
| D3DFMT_D24X4S4 | 79 | 32 비트의 Z 버퍼 비트 깊이로, 깊이 채널에 24 비트, 스텐실 채널에 4 비트를 사용한다. |
| D3DFMT_D32F_LOCKABLE | 82 | 깊이값을 표준 IEEE 부동 소수점수(실수)값으로 나타내는 잠금 가능한 포맷. |
| D3DFMT_D24FS8 | 83 | 24 비트의 깊이 (24 비트 부동 소수점 포맷 - 20e4)와 8 비트의 스텐실을 포함한, 잠글 수 없는 포맷. |
| D3DFMT_D16 | 80 | 16 비트의 Z 버퍼 비트 깊이. |
| D3DFMT_VERTEXDATA | 100 | 정점 버퍼 표면을 기술한다. |
| D3DFMT_INDEX16 | 101 | 16 비트의 인덱스 버퍼의 비트 깊이. |
| D3DFMT_INDEX32 | 102 | 32 비트의 인덱스 버퍼의 비트 깊이. |
D3DFMT_D16_LOCKABLE 를 제외하는 모든 스텐실 포맷은, 각 픽셀에 특정의 비트 오더를 지정하지 않기 때문에, 드라이버는 깊이 채널로서 지정된 비트수보다 넓은 채널을 사용할 수 있다 (다만, 스텐실 채널은 사용할 수 없다).
이러한 플래그는, 부동 소수점의 표면 포맷에 사용한다. 채널 근처 16 비트를 사용하는 이러한 포맷은, s10e5 포맷이라고도 부른다.
| 부동 소수점의 플래그 | 값 | 포맷 |
|---|---|---|
| D3DFMT_R16F | 111 | 16 비트의 부동 소수점 포맷으로, 빨강의 채널에 16 비트를 사용한다. |
| D3DFMT_G16R16F | 112 | 32 비트의 부동 소수점 포맷으로, 빨강의 채널에 16 비트, 초록의 채널에 16 비트를 사용한다. |
| D3DFMT_A16B16G16R16F | 113 | 64 비트의 부동 소수점 포맷으로, 알파·청·록·적의 채널 마다 16 비트를 사용한다. |
이러한 플래그는, 부동 소수점의 표면 포맷에 사용한다. 채널 근처 32 비트를 사용하는 이러한 포맷은, s23e8 포맷이라고도 부른다.
| 부동 소수점의 플래그 | 값 | 포맷 |
|---|---|---|
| D3DFMT_R32F | 114 | 32 비트의 부동 소수점 포맷으로, 빨강의 채널에 32 비트를 사용한다. |
| D3DFMT_G32R32F | 115 | 64 비트의 부동 소수점 포맷으로, 빨강의 채널에 32 비트, 초록의 채널에 32 비트를 사용한다. |
| D3DFMT_A32B32G32R32F | 116 | 128 비트의 부동 소수점 포맷으로, 알파·청·록·적의 채널 마다 32 비트를 사용한다. |
그 외의 플래그는, 이것뿐이어, 미정도리의 포맷에 사용한다.
| 그 외의 플래그 | 값 | 포맷 |
|---|---|---|
| D3DFMT_UNKNOWN | 0 | 표면 포맷은 불명하다. |
이러한 포맷은, 백 버퍼 또는 디스플레이 에 대해서만 유효하다.
| 포맷 | 백 버퍼. | 디스플레이 |
|---|---|---|
| A2R10G10B10 | x | x (풀 스크린 모드만) |
| A8R8G8B8 | x | |
| X8R8G8B8 | x | x |
| A1R5G5B5 | x | |
| X1R5G5B5 | x | x |
| R5G6B5 | x | x |
비트 오더는, 최상정도 바이트가 선두이다. 따라서, D3DFMT_A8L8 는, 이 2 바이트 포맷의 상위 바이트가 알파인 것을 나타내고 있다. D3DFMT_D16 는, 16 비트의 정수값으로, 애플리케이션으로 잠금 가능한 표면을 나타낸다.
픽셀 포맷이 선택되고 있는 것은, 확립되어 있는 FOURCC 방식을 도입할 뿐만 아니라, 하드웨어 벤더가 정의하는 확장 포맷의 표현을 가능하게 하기 위한(해)이다. Microsoft® Direct3D® 런타임이 인식하는 포맷군은,D3DFORMAT 로 정의되고 있다.
독립한 하드웨어 vender (IHV)가 제공하는 포맷 및 많은 FOURCC 코드는, 일람에는 나타나지 않기 때문에 주의할 필요가 있다. 이 열거형의 포맷은, 런타임에 의해 인정되고 있는 점이 다른 포맷과 다르다. 즉, 레퍼런스 래스터라이저는, 이러한 형태의 모두로 동작한다. IHV 제공의 포맷은, 카드 마다 각각의 IHV 가 지원 한다.