IMediaTextureSample::GetHDRNitsNormalizationFactor

Linear-side scale that consumers may apply to normalize decoded transfer-function output to UE scene-linear (diffuse white = 1.0).

API > API/Runtime > API/Runtime/Media > API/Runtime/Media/IMediaTextureSample

Description

Linear-side scale that consumers may apply to normalize decoded transfer-function output to UE scene-linear (diffuse white = 1.0). Consumers typically multiply the color-space conversion matrix by this factor; how and when it is applied is up to the consumer.

Subclasses should override this when the source metadata indicates a specific reference white. The canonical implementation calls UE::Color::GetReferenceWhiteLinearScale(GetEncodingType(), EReferenceWhite::XXX) so the scale resolves per encoding (e.g. 1/203 for PQ + BT2408, 1/DecodeHLG(0.75) for HLG + BT2408). The base default returns 1.0 so projects without tagging see spec-literal decoded values.

   
Name GetHDRNitsNormalizationFactor
Type function
Header File /Engine/Source/Runtime/Media/Public/IMediaTextureSample.h
Include Path #include "IMediaTextureSample.h" 
virtual float GetHDRNitsNormalizationFactor() const

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page