1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
|
/*
* Copyright (c) 2008-2017, NVIDIA CORPORATION. All rights reserved.
*
* NVIDIA CORPORATION and its licensors retain all intellectual property
* and proprietary rights in and to this software, related documentation
* and any modifications thereto. Any use, reproduction, disclosure or
* distribution of this software and related documentation without an express
* license agreement from NVIDIA CORPORATION is strictly prohibited.
*/
#ifndef RENDER_DATA_FORMAT_H
#define RENDER_DATA_FORMAT_H
#include "ApexUsingNamespace.h"
#include "foundation/PxAssert.h"
#include "foundation/PxMat44.h"
namespace nvidia
{
namespace apex
{
PX_PUSH_PACK_DEFAULT
/**
\brief Enumeration of possible formats of various buffer semantics
N.B.: DO NOT CHANGE THE VALUES OF OLD FORMATS.
*/
struct RenderDataFormat
{
/** \brief the enum type */
enum Enum
{
UNSPECIFIED = 0, //!< No format (semantic not used)
//!< Integer formats
UBYTE1 = 1, //!< One unsigned 8-bit integer (uint8_t[1])
UBYTE2 = 2, //!< Two unsigned 8-bit integers (uint8_t[2])
UBYTE3 = 3, //!< Three unsigned 8-bit integers (uint8_t[3])
UBYTE4 = 4, //!< Four unsigned 8-bit integers (uint8_t[4])
USHORT1 = 5, //!< One unsigned 16-bit integer (uint16_t[1])
USHORT2 = 6, //!< Two unsigned 16-bit integers (uint16_t[2])
USHORT3 = 7, //!< Three unsigned 16-bit integers (uint16_t[3])
USHORT4 = 8, //!< Four unsigned 16-bit integers (uint16_t[4])
SHORT1 = 9, //!< One signed 16-bit integer (int16_t[1])
SHORT2 = 10, //!< Two signed 16-bit integers (int16_t[2])
SHORT3 = 11, //!< Three signed 16-bit integers (int16_t[3])
SHORT4 = 12, //!< Four signed 16-bit integers (int16_t[4])
UINT1 = 13, //!< One unsigned integer (uint32_t[1])
UINT2 = 14, //!< Two unsigned integers (uint32_t[2])
UINT3 = 15, //!< Three unsigned integers (uint32_t[3])
UINT4 = 16, //!< Four unsigned integers (uint32_t[4])
//!< Color formats
R8G8B8A8 = 17, //!< Four unsigned bytes (uint8_t[4]) representing red, green, blue, alpha
B8G8R8A8 = 18, //!< Four unsigned bytes (uint8_t[4]) representing blue, green, red, alpha
R32G32B32A32_FLOAT = 19, //!< Four floats (float[4]) representing red, green, blue, alpha
B32G32R32A32_FLOAT = 20, //!< Four floats (float[4]) representing blue, green, red, alpha
//!< Normalized formats
BYTE_UNORM1 = 21, //!< One unsigned normalized value in the range [0,1], packed into 8 bits (uint8_t[1])
BYTE_UNORM2 = 22, //!< Two unsigned normalized value in the range [0,1], each packed into 8 bits (uint8_t[2])
BYTE_UNORM3 = 23, //!< Three unsigned normalized value in the range [0,1], each packed into bits (uint8_t[3])
BYTE_UNORM4 = 24, //!< Four unsigned normalized value in the range [0,1], each packed into 8 bits (uint8_t[4])
SHORT_UNORM1 = 25, //!< One unsigned normalized value in the range [0,1], packed into 16 bits (uint16_t[1])
SHORT_UNORM2 = 26, //!< Two unsigned normalized value in the range [0,1], each packed into 16 bits (uint16_t[2])
SHORT_UNORM3 = 27, //!< Three unsigned normalized value in the range [0,1], each packed into 16 bits (uint16_t[3])
SHORT_UNORM4 = 28, //!< Four unsigned normalized value in the range [0,1], each packed into 16 bits (uint16_t[4])
BYTE_SNORM1 = 29, //!< One signed normalized value in the range [-1,1], packed into 8 bits (uint8_t[1])
BYTE_SNORM2 = 30, //!< Two signed normalized value in the range [-1,1], each packed into 8 bits (uint8_t[2])
BYTE_SNORM3 = 31, //!< Three signed normalized value in the range [-1,1], each packed into bits (uint8_t[3])
BYTE_SNORM4 = 32, //!< Four signed normalized value in the range [-1,1], each packed into 8 bits (uint8_t[4])
SHORT_SNORM1 = 33, //!< One signed normalized value in the range [-1,1], packed into 16 bits (uint16_t[1])
SHORT_SNORM2 = 34, //!< Two signed normalized value in the range [-1,1], each packed into 16 bits (uint16_t[2])
SHORT_SNORM3 = 35, //!< Three signed normalized value in the range [-1,1], each packed into 16 bits (uint16_t[3])
SHORT_SNORM4 = 36, //!< Four signed normalized value in the range [-1,1], each packed into 16 bits (uint16_t[4])
//!< Float formats
HALF1 = 37, //!< One 16-bit floating point value
HALF2 = 38, //!< Two 16-bit floating point values
HALF3 = 39, //!< Three 16-bit floating point values
HALF4 = 40, //!< Four 16-bit floating point values
FLOAT1 = 41, //!< One 32-bit floating point value
FLOAT2 = 42, //!< Two 32-bit floating point values
FLOAT3 = 43, //!< Three 32-bit floating point values
FLOAT4 = 44, //!< Four 32-bit floating point values
FLOAT4x4 = 45, //!< A 4x4 matrix (see PxMat44)
FLOAT3x4 = 46, //!< A 3x4 matrix (see float[12])
FLOAT3x3 = 47, //!< A 3x3 matrix (see PxMat33)
FLOAT4_QUAT = 48, //!< A quaternion (see PxQuat)
BYTE_SNORM4_QUATXYZW = 49, //!< A normalized quaternion with signed byte elements, X,Y,Z,W format (uint8_t[4])
SHORT_SNORM4_QUATXYZW = 50, //!< A normalized quaternion with signed short elements, X,Y,Z,W format (uint16_t[4])
NUM_FORMATS
};
/// Get byte size of format type
static PX_INLINE uint32_t getFormatDataSize(Enum format)
{
switch (format)
{
default:
PX_ALWAYS_ASSERT();
case UNSPECIFIED:
return 0;
case UBYTE1:
case BYTE_UNORM1:
case BYTE_SNORM1:
return sizeof(uint8_t);
case UBYTE2:
case BYTE_UNORM2:
case BYTE_SNORM2:
return sizeof(uint8_t) * 2;
case UBYTE3:
case BYTE_UNORM3:
case BYTE_SNORM3:
return sizeof(uint8_t) * 3;
case UBYTE4:
case BYTE_UNORM4:
case BYTE_SNORM4:
case BYTE_SNORM4_QUATXYZW:
return sizeof(uint8_t) * 4;
case USHORT1:
case SHORT1:
case HALF1:
case SHORT_UNORM1:
case SHORT_SNORM1:
return sizeof(uint16_t);
case USHORT2:
case SHORT2:
case HALF2:
case SHORT_UNORM2:
case SHORT_SNORM2:
return sizeof(uint16_t) * 2;
case USHORT3:
case SHORT3:
case HALF3:
case SHORT_UNORM3:
case SHORT_SNORM3:
return sizeof(uint16_t) * 3;
case USHORT4:
case SHORT4:
case HALF4:
case SHORT_UNORM4:
case SHORT_SNORM4:
case SHORT_SNORM4_QUATXYZW:
return sizeof(uint16_t) * 4;
case UINT1:
return sizeof(uint32_t);
case UINT2:
return sizeof(uint32_t) * 2;
case UINT3:
return sizeof(uint32_t) * 3;
case UINT4:
return sizeof(uint32_t) * 4;
case R8G8B8A8:
case B8G8R8A8:
return sizeof(uint8_t) * 4;
case R32G32B32A32_FLOAT:
case B32G32R32A32_FLOAT:
return sizeof(float) * 4;
case FLOAT1:
return sizeof(float);
case FLOAT2:
return sizeof(float) * 2;
case FLOAT3:
return sizeof(float) * 3;
case FLOAT4:
return sizeof(float) * 4;
case FLOAT4x4:
return sizeof(PxMat44);
case FLOAT3x4:
return sizeof(float) * 12;
case FLOAT3x3:
return sizeof(PxMat33);
case FLOAT4_QUAT:
return sizeof(PxQuat);
}
}
};
PX_POP_PACK
}
} // end namespace nvidia::apex
#endif // RENDER_DATA_FORMAT_H
|