Skip to content

Dolby Vision: Parse RPU in HEVC and AV1 #2392

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
cjee21 wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Dolby Vision: Parse RPU in HEVC and AV1 #2392

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4e500d7
AV1/HEVC: Parse Dolby Vision RPU and EL
cjee21 Sep 13, 2025
4ccf4b8
Fix warnings in HEVC & Analyze_Streams
cjee21 Feb 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions Source/MediaInfo/File__Analyze.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -932,6 +932,31 @@ public :
#if defined(MEDIAINFO_MPEGPS_YES) || defined(MEDIAINFO_MPEGTS_YES) || defined(MEDIAINFO_MPEG4_YES) || defined(MEDIAINFO_MK_YES)
void dvcC(bool has_dependency_pid=false, std::map<std::string, Ztring>* Infos=NULL);
#endif
#if defined(MEDIAINFO_HEVC_YES) || defined(MEDIAINFO_AV1_YES)
struct DV_RPU {
int8u vdr_rpu_profile{};
int32u bl_bit_depth{};
int32u el_bit_depth{};
int32u vdr_bit_depth{};
bool BL_video_full_range_flag{};
int8u isMEL{};
float CMv{};
int16u active_area_left_offset{};
int16u active_area_right_offset{};
int16u active_area_top_offset{};
int16u active_area_bottom_offset{};
int16u max_display_mastering_luminance{};
int16u min_display_mastering_luminance{};
int16u max_content_light_level{};
int16u max_frame_average_light_level{};
bool L11_present{};
int8u content_type{};
int8u white_point{};
bool reference_mode{};
};
// Must be in bitstream before calling this function.
void Get_DolbyVision_ReferenceProcessingUnit(DV_RPU& data);
#endif

//***************************************************************************
// Unknown
Expand Down
25 changes: 25 additions & 0 deletions Source/MediaInfo/File__Analyze_MinimizeSize.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -800,6 +800,31 @@ public :
#if defined(MEDIAINFO_MPEGPS_YES) || defined(MEDIAINFO_MPEGTS_YES) || defined(MEDIAINFO_MPEG4_YES) || defined(MEDIAINFO_MK_YES)
void dvcC(bool has_dependency_pid=false, std::map<std::string, Ztring>* Infos=NULL);
#endif
#if defined(MEDIAINFO_HEVC_YES) || defined(MEDIAINFO_AV1_YES)
struct DV_RPU {
int8u vdr_rpu_profile{};
int32u bl_bit_depth{};
int32u el_bit_depth{};
int32u vdr_bit_depth{};
bool BL_video_full_range_flag{};
int8u isMEL{};
float CMv{};
int16u active_area_left_offset{};
int16u active_area_right_offset{};
int16u active_area_top_offset{};
int16u active_area_bottom_offset{};
int16u max_display_mastering_luminance{};
int16u min_display_mastering_luminance{};
int16u max_content_light_level{};
int16u max_frame_average_light_level{};
bool L11_present{};
int8u content_type{};
int8u white_point{};
bool reference_mode{};
};
// Must be in bitstream before calling this function.
void Get_DolbyVision_ReferenceProcessingUnit(DV_RPU& data);
#endif

//***************************************************************************
// Unknown
Expand Down
646 changes: 635 additions & 11 deletions Source/MediaInfo/File__Analyze_Streams.cpp
View file
Open in desktop

Large diffs are not rendered by default.

209 changes: 209 additions & 0 deletions Source/MediaInfo/Video/File_Av1.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -768,11 +768,220 @@ void File_Av1::metadata_itu_t_t35_B5()

switch (itu_t_t35_terminal_provider_code)
{
case 0x003B: Param_Info1("Dolby Laboratories, Inc."); metadata_itu_t_t35_B5_003B(); break;
case 0x003C: Param_Info1("Samsung Electronics America"); metadata_itu_t_t35_B5_003C(); break;
case 0x5890: Param_Info1("AOMedia"); metadata_itu_t_t35_B5_5890(); break;
}
}

//---------------------------------------------------------------------------
void File_Av1::metadata_itu_t_t35_B5_003B()
{
int32u itu_t_t35_terminal_provider_oriented_code;
Get_B4(itu_t_t35_terminal_provider_oriented_code, "itu_t_t35_terminal_provider_oriented_code");

switch (itu_t_t35_terminal_provider_oriented_code)
{
case 0x00000800: metadata_itu_t_t35_B5_003B_00000800(); break;
}

}

//---------------------------------------------------------------------------
void File_Av1::metadata_itu_t_t35_B5_003B_00000800()
{
Element_Info1("Extensible Metadata Delivery Format (EMDF)");

auto Get_V4{ [this](int8u Bits, int32u& Info, const char* Name)
{
Info = 0;

#if MEDIAINFO_TRACE
int8u Count = 0;
#endif //MEDIAINFO_TRACE
for (;;)
{
Info += BS->Get4(Bits);
#if MEDIAINFO_TRACE
Count += Bits;
#endif //MEDIAINFO_TRACE
if (!BS->GetB())
break;
Info <<= Bits;
Info += (1 << Bits);
}
#if MEDIAINFO_TRACE
if (Trace_Activated)
{
Param(Name, Info, Count);
Param_Info(__T("(") + Ztring::ToZtring(Count) + __T(" bits)"));
}
#endif //MEDIAINFO_TRACE
}
};

auto Skip_V4{ [&](int8u Bits, const char* Name) {
int32u Info;
Get_V4(Bits, Info, Name);
}
};

BS_Begin();
size_t Start = Data_BS_Remain();
int32u version, key_id;
Element_Begin1("emdf_container");
Get_S4 (2, version, "emdf_version");
if (version == 3)
{
int32u add;
Get_V4(2, add, "emdf_version addition");
version += add;
}
if (version)
{
Skip_BS(Data_BS_Remain(), "(Unparsed emdf_container data)");
Element_End0();
return;
}

Get_S4 (3, key_id, "key_id");
if (key_id == 7)
{
int32u add;
Get_V4 (3, add, "key_id addition");
key_id += add;
}
Param_Info1C(key_id == 0x6, "Ignore protection bits");

int32u emdf_payload_id = 0;

for(;;)
{
Element_Begin1("emdf_payload");
Get_S4 (5, emdf_payload_id, "emdf_payload_id");
if (emdf_payload_id==0x1F)
{
int32u add;
Get_V4 (5, add, "emdf_payload_id addition");
emdf_payload_id += add;
}

if (emdf_payload_id == 256)
Element_Info1("Dolby Vision Reference Processing Unit (RPU)");
if (emdf_payload_id == 0x00)
{
Element_End0();
break;
}

Element_Begin1("emdf_payload_config");

bool smploffste = false;
Get_SB (smploffste, "smploffste");
if (smploffste)
{
Skip_S2(11, "smploffst");
Skip_SB( "reserved");
}

TEST_SB_SKIP( "duratione");
Skip_V4(11, "duration");
TEST_SB_END();
TEST_SB_SKIP( "groupide");
Skip_V4(2, "groupid");
TEST_SB_END();
TEST_SB_SKIP( "codecdatae");
Skip_S1(8, "reserved");
TEST_SB_END();

bool discard_unknown_payload = false;
Get_SB(discard_unknown_payload, "discard_unknown_payload");
if (!discard_unknown_payload)
{
bool payload_frame_aligned = false;
if (!smploffste)
{
Get_SB (payload_frame_aligned, "payload_frame_aligned");
if (payload_frame_aligned)
{
Skip_SB( "create_duplicate");
Skip_SB( "remove_duplicate");
}
}

if (smploffste || payload_frame_aligned)
{
Skip_S1(5, "priority");
Skip_S1(2, "proc_allowed");
}
}

Element_End0(); // emdf_payload_config

int32u emdf_payload_size = 0;
Get_V4 (8, emdf_payload_size, "emdf_payload_size");
size_t emdf_payload_End = Data_BS_Remain() - static_cast<size_t>(emdf_payload_size) * 8;

Element_Begin1("emdf_payload_bytes");
switch (emdf_payload_id)
{
case 256: Get_DolbyVision_ReferenceProcessingUnit(DV_RPU_data); break;
default : Skip_BS(static_cast<size_t>(emdf_payload_size) * 8, "(Unknown)"); break;
}
size_t RemainginBits=Data_BS_Remain();
if (RemainginBits>=emdf_payload_End)
{
if (RemainginBits>emdf_payload_End)
Skip_BS(RemainginBits-emdf_payload_End, "(Unparsed bits)");
}
else
{
//There is a problem, too many bits were consumed by the parser. //TODO: prevent the parser to consume more bits than count of bits in this element
if (Data_BS_Remain())
Skip_BS(Data_BS_Remain(), "(Problem during emdf_payload parsing)");
else
Skip_BS(Data_BS_Remain(), "(Problem during emdf_payload parsing, going to end directly)");
Element_End0();
Element_End0();
break;
}
Element_End0(); // emdf_payload_bytes

Element_End0(); // emdf_payload
}

Element_Begin1("emdf_protection");

int8u len_primary = 0, len_second = 0;
Get_S1(2, len_primary, "protection_length_primary");
Get_S1(2, len_second, "protection_length_secondary");

switch (len_primary)
{
//case 0: break; //protection_length_primary coherency was already tested in sync layer
case 1: len_primary = 8; break;
case 2: len_primary = 32; break;
case 3: len_primary = 128; break;
default:; //Cannot append, read only 2 bits
};
switch (len_second)
{
case 0: len_second = 0; break;
case 1: len_second = 8; break;
case 2: len_second = 32; break;
case 3: len_second = 128; break;
default:; //Cannot append, read only 2 bits
};
Skip_BS(len_primary, "protection_bits_primary");
if (len_second)
Skip_BS(len_second, "protection_bits_secondary");

Element_End0(); // emdf_protection

Element_End0(); // emdf_container
BS_End();
}

//---------------------------------------------------------------------------
void File_Av1::metadata_itu_t_t35_B5_003C()
{
Expand Down
3 changes: 3 additions & 0 deletions Source/MediaInfo/Video/File_Av1.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,8 @@ private :
void metadata_hdr_mdcv();
void metadata_itu_t_t35();
void metadata_itu_t_t35_B5();
void metadata_itu_t_t35_B5_003B();
void metadata_itu_t_t35_B5_003B_00000800();
void metadata_itu_t_t35_B5_003C();
void metadata_itu_t_t35_B5_003C_0001();
void metadata_itu_t_t35_B5_003C_0001_04();
Expand Down Expand Up @@ -91,6 +93,7 @@ private :
typedef std::map<video, Ztring[HdrFormat_Max]> hdr;
hdr HDR;
std::set<int8u> scalability_structure_seen;
DV_RPU DV_RPU_data;

//Helpers
std::string GOP_Detect(std::string PictureTypes);
Expand Down
Loading