Added in API level 36

Summary: Nested Classes | Ctors | Methods | Inherited Methods

DisplayLuts

---

Kotlin |Java

public final class DisplayLuts
extends Object

java.lang.Object
↳	android.hardware.DisplayLuts

---

DisplayLuts provides the developers to apply Lookup Tables (Luts) to a SurfaceControl. Luts provides ways to control tonemapping for specific content. The general flow for how DisplayLuts fits into a display pipeline is as follows:

DisplayLuts flow

Or in list form:

1. A SurfaceControl's content is converted to RGB colors, if the source is YUV.
2. The RGB colors are de-gammed into linear values, normalized to the range of [0, 1].
3. The linear values are passed through a 1D LUT (if set). The 1D LUT looks up and applies gain multipliers.
4. The linear values are passed through a 3D LUT (if set). The 3D LUT maps input colors to a final linear color.
5. The output values are transformed to the panel color gamut, and then gammed to arrive at the final color.

Importantly: the LUT is applied on colors in linear space, in the source content's color gamut.

See also:

• LutProperties

Summary

Nested classes
class	DisplayLuts.Entry

Public constructors
DisplayLuts() Create a DisplayLuts instance.

Public methods
void	set(DisplayLuts.Entry entry) Set a Lut to be applied.
void	set(DisplayLuts.Entry first, DisplayLuts.Entry second) Set Luts in order to be applied.
String	toString() Returns a string representation of the object.

Inherited methods

From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public constructors

DisplayLuts

Added in API level 36

public DisplayLuts ()

Create a DisplayLuts instance.

Public methods

set

Added in API level 36

public void set (DisplayLuts.Entry entry)

Set a Lut to be applied.

Use either this or set(Entry,Entry). The function will replace any previously set lut(s).

Parameters
entry	DisplayLuts.Entry: Either an 1D Lut or a 3D Lut. This value cannot be null.

set

Added in API level 36

public void set (DisplayLuts.Entry first, 
                DisplayLuts.Entry second)

Set Luts in order to be applied.

An 1D Lut and 3D Lut will be applied in order. Use either this or set(Entry). The function will replace any previously set lut(s)

Parameters
first	DisplayLuts.Entry: An 1D Lut. This value cannot be null.
second	DisplayLuts.Entry: A 3D Lut. This value cannot be null.

toString

Added in API level 36

public String toString ()

Returns a string representation of the object.

Returns
String	a string representation of the object.