class RectangleCompositor

Helper to support braced-init-lists with Framebuffer.

RectangleCompositor constructor. Initializes the shader program and allocates

GPU buffers to store mesh data.

Draws a single batch of renderables into the provided output image.

Parameters:

- cmd_buf: The command buffer used to record commands.

- rectangles: geometry to be drawn.

- textures: must be 1-1 with rectangles, to which they are textured onto.

- color_data: must be 1-1 with rectangles and textures.

|color| is multiply_color to the texture used in the shader.

|opacity| determines use of opaque or transparent rendering.

- output_image: the render target the renderables will be rendered into.

- depth_buffer: The depth texture to be used for z-buffering.

Creates a standard 1-subpass Framebuffer suitable for use with DrawBatch().

Creates a 2-subpass Framebuffer for color conversion. If |transient_image| is provided, it is

reused as the intermediate color attachment for the first subpass; if null, a new transient

image matching |output_image_view| is allocated.

Returns the transient image from a color-conversion framebuffer (attachment 0).

The framebuffer *MUST* have been created via `CreateColorConversionFramebuffer()`.

Returns true if |transient_image| has matching properties (dimensions, format, color space,

protected memory) to serve as the intermediate target for rendering into |target_image|.

Draws a batch of renderables into |framebuffer|. Whether color conversion is applied is

determined by |framebuffer|, i.e. by whether CreateColorConversionFramebuffer() was used.

This data is used to apply a color-conversion post processing effect over the entire

rendered output, when making a call to |DrawBatch|. The color conversion formula

used is matrix * (color + preoffsets) + postoffsets.

Minimal image constraints to be set on textures and render targets passed into

DrawBatch. These are meant to also be compatible with AFBC

(Arm Framebuffer Compression).

Pre-generate and cache Vulkan render passes and pipelines at startup to avoid subsequent

jank at runtime: when DrawBatch() looks for the renderpasses and pipelines in their respective

caches, they will already be there.

WarmPipelineCache() may be called several times with different parameters to accommodate

e.g. different framebuffer formats and layouts.

Args:

- |output_format| Describes the target framebuffer.

- |output_swapchain_layout| Describes the target framebuffer.

- |depth_format| Describes the target framebuffer.

- |depth_swapchain_layout| Describes the target framebuffer.

- |immutable_samplers| Support various types of YUV video.

- |use_protected_memory| If true, allows rendering protected (and unprotected) content into

a protected framebuffer. If false, only unprotected content can be

rendered by the generated pipelines.