1# ANGLE back-ends 2 3This folder contains shared back-end-specific implementation files. The classes 4and types in `renderer` are not specified by GLES. They instead are common to 5all the various ANGLE implementations. 6 7See [`renderer_utils.h`](renderer_utils.h) for various cross back-end utilties. 8 9## ANGLE Formats 10 11The ANGLE format class, [`angle::Format`][ANGLEFormatDef], works as a union 12between GLES and all the various back-end formats. It can represent any type 13of format in ANGLE. e.g. Formats in Vulkan that don't exist in GLES, or DXGI 14formats that don't exist in GLES, or Windows/Android surface configs that 15don't exist anywhere else. 16 17The `glInternalFormat` member of `angle::Format` represents the "closest" GL 18format for an ANGLE format. For formats that don't exist in GLES this will 19not be exactly what the format represents. 20 21The back-ends also define their own format tables. See the 22[Vulkan Format table docs][VulkanFormatDocs] and the 23[D3D11 format table docs][D23D11FormatDocs]. 24 25## DXGI Format Info 26 27DXGI formats are used in both the GL and D3D11 back-end. Therefore the 28generated info table lives in this common shared location. 29 30The DXGI info table is generated by [`gen_dxgi_format_table.py`](gen_dxgi_format_table.py) 31and sources data from [`dxgi_format_data.json`](dxgi_format_data.json). The 32main purpose of the table is to convert from a DXGI format to an ANGLE 33format, where the ANGLE format should have all the necessary information. 34 35[ANGLEFormatDef]: https://chromium.googlesource.com/angle/angle/+/f85ec039a7dcfde3b4a8d9ddfa8baa84ae5ce927/src/libANGLE/renderer/Format.h#24 36[VulkanFormatDocs]: vulkan/doc/FormatTablesAndEmulation.md 37[D3D11FormatDocs]: d3d/d3d11/FormatTables.md 38