xref: /aosp_15_r20/external/angle/extensions/ANGLE_renderability_validation.txt (revision 8975f5c5ed3d1c378011245431ada316dfb6f244)
1Name
2
3    ANGLE_renderability_validation
4
5Name Strings
6
7    GL_ANGLE_renderability_validation
8
9Contributors
10
11    Vikas Soni, Google
12
13Contact
14
15    Vikas Soni, Google (vikassoni 'at' chromium.com)
16
17Status
18
19    Draft
20
21Version
22
23    Last Modified Date: April 20, 2023
24    Revision: 1
25
26Number
27
28    OpenGL ES Extension XX
29
30Dependencies
31
32    None
33
34Overview
35
36    This extension allows skipping texture format renderability validation if
37    the implementation is capable of rendering to the underlying texture
38    format. This can be useful in situations where textures are created
39    externally and the current context's version and extensions do not allow
40    rendering to the texture but the implementation is capable.
41
42New Procedures and Functions
43
44    None
45
46New Tokens
47
48    Accepted as a value for <pname> for the TexParameter{if} and
49    TexParameter{if}v commands and for the <value> parameter of
50    GetTexParameter{if}v:
51
52        GL_RENDERABILITY_VALIDATION_ANGLE     0x9EA0
53
54Additions to the OpenGL Specification
55
56    None.
57
58New Behavior
59    Additions to Chapter 3 of the OpenGL ES 2.0 Specification (Rasterization)
60
61    Add a new row to Table 3.10 (Texture parameters and their values):
62
63    Name                           | Type | Legal Values
64    ------------------------------------------------------------
65    RENDERABILITY_VALIDATION_ANGLE | bool | TRUE, FALSE
66
67    Add a new section 3.7.x (Texture Usage) before section 3.7.12 and
68    renumber the subsequent sections:
69
70    "3.7.x Texture Usage
71
72    Texture renderability validation can be controled via the
73    RENDERABILITY_VALIDATION_ANGLE value for the <pname> argument to
74    TexParameter{if}[v].
75
76    Possible values for <params> when <pname> is TEXTURE_USAGE_ANGLE are:
77
78    TRUE - the default. Renderability validation is unchanged.
79
80    FALSE - Renderability of the texture becomes implementation dependent.
81        The implementation will allow rendering to the format if it is
82        capable."
83
84Issues
85
86Revision History
87
88    Version 1, 2023-04-20(Vikas Soni)
89      - Initial draft
90
91