Share via


Window.SetPreferMinimalPostProcessing(Boolean) Method

Definition

If isPreferred is true, this method requests that the connected display does minimal post processing when this window is visible on the screen.

[Android.Runtime.Register("setPreferMinimalPostProcessing", "(Z)V", "GetSetPreferMinimalPostProcessing_ZHandler", ApiSince=30)]
public virtual void SetPreferMinimalPostProcessing (bool isPreferred);
[<Android.Runtime.Register("setPreferMinimalPostProcessing", "(Z)V", "GetSetPreferMinimalPostProcessing_ZHandler", ApiSince=30)>]
abstract member SetPreferMinimalPostProcessing : bool -> unit
override this.SetPreferMinimalPostProcessing : bool -> unit

Parameters

isPreferred
Boolean

Indicates whether minimal post processing is preferred for this window (isPreferred=true) or not (isPreferred=false).

Attributes

Remarks

If isPreferred is true, this method requests that the connected display does minimal post processing when this window is visible on the screen. Otherwise, it requests that the display switches back to standard image processing.

By default, the display does not do minimal post processing and if this is desired, this method should not be used. It should be used with isPreferred=true when low latency has a higher priority than image enhancement processing (e.g. for games or video conferencing). The display will automatically go back into standard image processing mode when no window requesting minimal posst processing is visible on screen anymore. setPreferMinimalPostProcessing(false) can be used if setPreferMinimalPostProcessing(true) was previously called for this window and minimal post processing is no longer required.

If the Display sink is connected via HDMI, the device will begin to send infoframes with Auto Low Latency Mode enabled and Game Content Type. This will switch the connected display to a minimal image processing mode (if available), which reduces latency, improving the user experience for gaming or video conferencing applications. For more information, see HDMI 2.1 specification.

If the Display sink has an internal connection or uses some other protocol than HDMI, effects may be similar but implementation-defined.

The ability to switch to a mode with minimal post proessing may be disabled by a user setting in the system settings menu. In that case, this method does nothing.

Java documentation for android.view.Window.setPreferMinimalPostProcessing(boolean).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to