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
|
// -----------------------------------------------------------------
// IMediaSideData interface and data structure definitions
// -----------------------------------------------------------------
#pragma once
// -----------------------------------------------------------------
// Interface to exchange binary side data
// -----------------------------------------------------------------
// This interface should be implemented in IMediaSample objects and accessed through IUnknown
// It allows binary side data to be attached to the media samples and delivered with them
// Restrictions: Only one side data per type can be attached
interface __declspec(uuid("F940AE7F-48EB-4377-806C-8FC48CAB2292")) IMediaSideData : public IUnknown
{
// Set the side data identified by guidType to the data provided
// The provided data will be copied and stored internally
STDMETHOD(SetSideData)(GUID guidType, const BYTE *pData, size_t size) PURE;
// Get the side data identified by guidType
// The caller receives pointers to the internal data, and the pointers shall stay
// valid for the lifetime of the object
STDMETHOD(GetSideData)(GUID guidType, const BYTE **pData, size_t *pSize) PURE;
};
// -----------------------------------------------------------------
// High-Dynamic-Range (HDR) Side Data
// -----------------------------------------------------------------
// {53820DBC-A7B8-49C4-B17B-E511591A790C}
DEFINE_GUID(IID_MediaSideDataHDR,
0x53820dbc, 0xa7b8, 0x49c4, 0xb1, 0x7b, 0xe5, 0x11, 0x59, 0x1a, 0x79, 0xc);
#pragma pack(push, 1)
struct MediaSideDataHDR
{
// coordinates of the primaries, in G-B-R order
double display_primaries_x[3];
double display_primaries_y[3];
// white point
double white_point_x;
double white_point_y;
// luminance
double max_display_mastering_luminance;
double min_display_mastering_luminance;
};
#pragma pack(pop)
// {ED6AE576-7CBE-41A6-9DC3-07C35DC13EF9}
DEFINE_GUID(IID_MediaSideDataHDRContentLightLevel,
0xed6ae576, 0x7cbe, 0x41a6, 0x9d, 0xc3, 0x7, 0xc3, 0x5d, 0xc1, 0x3e, 0xf9);
#pragma pack(push, 1)
struct MediaSideDataHDRContentLightLevel
{
// maximum content light level (cd/m2)
unsigned int MaxCLL;
// maximum frame average light level (cd/m2)
unsigned int MaxFALL;
};
#pragma pack(pop)
// -----------------------------------------------------------------
// 3D Plane Offset Side Data
// -----------------------------------------------------------------
// {F169B76C-75A3-49E6-A23A-14983EBF4370}
DEFINE_GUID(IID_MediaSideData3DOffset,
0xf169b76c, 0x75a3, 0x49e6, 0xa2, 0x3a, 0x14, 0x98, 0x3e, 0xbf, 0x43, 0x70);
#pragma pack(push, 1)
struct MediaSideData3DOffset
{
// Number of valid offsets (up to 32)
int offset_count;
// Offset Value, can be positive or negative
// positive values offset closer to the viewer (move right on the left view, left on the right view)
// negative values offset further away from the viewer (move left on the left view, right on the right view)
int offset[32];
};
#pragma pack(pop)
|
