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