class RectangleCompositor

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.

- apply_color_conversion: Does a color conversion pass over the rendered output

using the data set with |SetColorConversionParams|.

Depth is implicit. Renderables are drawn in the order they appear in the input

vector, with the first entry being the furthest back, and the last the closest.

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.