Struct ConverterSynchronousProxy

pub struct ConverterSynchronousProxy { /* private fields */ }

Implementations

impl ConverterSynchronousProxy

pub fn new(channel: Channel) -> Self

pub fn into_channel(self) -> Channel

pub fn wait_for_event( &self, deadline: MonotonicInstant, ) -> Result<ConverterEvent, Error>

Waits until an event arrives and returns it. It is safe for other threads to make concurrent requests while waiting for an event.

pub fn set_values( &self, properties: &ConversionProperties, ___deadline: MonotonicInstant, ) -> Result<i32, Error>

Modifies the color of final display output of rendered content. The sole parameter is a table of |ConversionProperties|, which contains the parameters required to apply the color conversion formula to the display. Please see |ConversionProperties| defined above for more information.

All parameters in the properties table must be normal 32-bit floating point values. If any of the values do not meet this specification, the new color conversion values will not be applied and a value of ZX_ERR_INVALID_ARGS will be returned. Otherwise, the return value will be ZX_OK: https://en.wikipedia.org/wiki/Normal_number_%28computing%29. Once a value of ZX_OK has been returned to the client, the color conversion values are ready to be used in future render calls, including screenshots.

Values in |ConversionProperties| may also be left blank. The default values for each member, if left blank, are as follows: coefficients = [1, 0, 0, 0, 1, 0, 0, 0, 1] (i.e. the identity matrix) preoffsets = [0,0,0] postoffsets = [0,0,0] Thus, ColorConversion can be reset by passing in an empty table to this function.

Hardware that support color conversion generally accept a limited range of coefficient values. Coefficients in the range of [-2, 2] inclusive will be accepted by most hardware. The hardware driver will clamp values that are outside its acceptable range.

preoffsets, postoffsets: Clients are encouraged to produce color conversion values that do not depend on pre and post offsets since some hardware do not have support for that. For cases where pre and post offset values need to be used, the range should be limited to (-1, 1).

pub fn set_minimum_rgb( &self, minimum_rgb: u8, ___deadline: MonotonicInstant, ) -> Result<bool, Error>

Submits a minimum value that all channels of all pixels rendered to the display are clamped to. This can be used to mitigate the apparent effects of backlight bleeding on certain devices in low-light environments.

The valid range for a minimum value is [0, 255] (inclusive). For a new minimum value M, each color channel’s range will be limited to [M, 255].

Callers should wait for the acknowledgement to return before submitting another call to this function. The minimum_rgb clamping can be removed simply by submitting a value of 0.

Not all hardware supports this feature. So this function returns |true| if successfully applied and |false| if unsupported.

Trait Implementations

impl Debug for ConverterSynchronousProxy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl SynchronousProxy for ConverterSynchronousProxy

type Proxy = ConverterProxy

The async proxy for the same protocol.

type Protocol = ConverterMarker

The protocol which this Proxy controls.

fn from_channel(inner: Channel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Channel

Convert the proxy back into a channel.

fn as_channel(&self) -> &Channel

Get a reference to the proxy’s underlying channel.

fn is_closed(&self) -> Result<bool, Status>

Returns true if the proxy has received the PEER_CLOSED signal.