語言

SurfaceView.SetDesiredHdrHeadroom(Single) 方法

定義

設定在 HDR 內容呈現時所需的 HDR 餘量。

[Android.Runtime.Register("setDesiredHdrHeadroom", "(F)V", "GetSetDesiredHdrHeadroom_FHandler", ApiSince=35)]
public virtual void SetDesiredHdrHeadroom(float desiredHeadroom);
[<Android.Runtime.Register("setDesiredHdrHeadroom", "(F)V", "GetSetDesiredHdrHeadroom_FHandler", ApiSince=35)>]
abstract member SetDesiredHdrHeadroom : single -> unit
override this.SetDesiredHdrHeadroom : single -> unit

參數

desiredHeadroom
Single

想要的 HDR 餘裕量。 必須是 >= 1.0(無 HDR)且 <= 10,000.0。 通過 0.0 會重置為預設的自動選擇值。

屬性

備註

設定在 HDR 內容呈現時所需的 HDR 餘量。 這以最大 HDR 白點與 SDR 白點的比值表示,而非絕對 nits。

預設情況下,系統會選擇適合底層裝置能力與面板位深的 HDR 餘裕量。 然而,對某些類型的內容來說,這可能會比必要或期望的還要多。 舉例來說,訊息應用程式或圖庫縮圖視圖,希望有一定程度的 HDR 突出效果,但不會過度影響大多數 SDR 內容的亮度感知。 這也可用於在 HDR 範圍內或外出動畫,讓過渡更流暢。

注意:實際的 HDR 餘裕量會受到環境條件、顯示能力或位元深度限制等多種因素影響。 請參閱 Display#getHdrSdrRatio() 更多資訊以及如何查詢當前價值。

注意:此 API 獨立於 與Window#setColorMode Widow color modeWindow#setDesiredHdrHeadroom Window desiredHdrHeadroom

Java 文件 android.view.SurfaceView.setDesiredHdrHeadroom(float)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於