class Flatland2

Defined at line 279 of file fidling/gen/sdk/fidl/fuchsia.ui.composition/fuchsia.ui.composition/cpp/fidl/fuchsia.ui.composition/cpp/markers.h

This protocol is composed into the "classic" [`Flatland`] protocol, and

cleans up some "warts" in the original design.

All methods defined in this protocol are ONLY available when Flatland2 is enabled

(e.g. via [`TrustedFlatlandConfig.use_flatland2_api`]). Calling these methods

when Flatland2 is not enabled will result in a channel closure.

Broadly speaking, the "warts" involve properties that are set on images when they shouldn't be.

For example, it should be possible to display two copies of the same image side by side, with

one image flipped `LEFT_RIGHT` to reflect the other. This is impossible in the classic Flatland

API, because the flip is a property of the image. In Flatland2, the flip is a property of

the layer, and the client's goal is easily achieved with two layers with the same image and

different flips.

Certain "classic" Flatland methods are disabled/illegal when Flatland2 is enabled.

Eventually these methods will be removed; Flatland2 will be the standard way to display

images in Flatland. Until then, this "opt in" approach provides clients with a convenient way

to migrate to this modernized API. The disabled methods are:

- [`fuchsia.ui.composition/Flatland.CreateFilledRect`]

- [`fuchsia.ui.composition/Flatland.CreateImage`]

- [`fuchsia.ui.composition/Flatland.CreateViewport`]

- [`fuchsia.ui.composition/Flatland.ReleaseFilledRect`]

- [`fuchsia.ui.composition/Flatland.ReleaseImage`]

- [`fuchsia.ui.composition/Flatland.ReleaseViewport`]

- [`fuchsia.ui.composition/Flatland.SetContent`]

- [`fuchsia.ui.composition/Flatland.SetImageBlendingFunction`]

- [`fuchsia.ui.composition/Flatland.SetImageBlendMode`]

- [`fuchsia.ui.composition/Flatland.SetImageDestinationSize`]

- [`fuchsia.ui.composition/Flatland.SetImageFlip`]

- [`fuchsia.ui.composition/Flatland.SetImageOpacity`]

- [`fuchsia.ui.composition/Flatland.SetSolidFill`]

- [`fuchsia.ui.composition/Flatland.SetImageSampleRegion`]

- [`fuchsia.ui.composition/Flatland.SetViewportProperties`]

- [`fuchsia.ui.composition/TrustedFlatland.ReleaseImageImmediately`]

Public Members

static Openness kOpenness