blob: 01b3edc6e2f4eeb9292db0323a82403a56ba5a43 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
Name
CHROMIUM_texture_mailbox
Name Strings
GL_CHROMIUM_texture_mailbox
Version
Last Modifed Date: April 25, 2012
Dependencies
OpenGL ES 2.0 is required.
Overview
This extension defines a way of sharing texture image data between texture
objects in different contexts where the contexts would not normally share
texture resources. Three new functions are exported. glGenMailboxCHROMIUM
generates a name that can be used to identify texture image data outside
the scope of a context group. glProduceMailboxCHROMIUM moves texture image
data out of a texture object and into a mailbox. glConsumeMailboxCHROMIUM
moves texture image data out of a mailbox and into a texture object.
New Procedures and Functions
void glGenMailboxCHROMIUM (GLbyte *mailbox)
Generates a unique name identifying a mailbox. The name is generated using
a cryptographic random number generator and is intended to be difficult to
guess. The scope of the name is implementation specific, for example it
might not span multiple displays.
<mailbox> returns a GL_MAILBOX_SIZE_CHROMIUM byte sized name
void glProduceTextureCHROMIUM (GLenum target, const GLbyte *mailbox)
Moves the image data of the currently bound texture object into the mailbox.
The texture object is redefined as though all its levels had been resized to
zero by zero and the texture object is therefore incomplete. If the mailbox
previously contained image data, the old image data is deleted. The state
of the bound texture object is not saved in the mailbox, only the image
data.
If glProduceTextureCHROMIUM generates an error, the associated image data
is preserved in the texture object.
The mailbox is emptied and the texture image data deleted if the context
is destroyed before being consumed. See glConsumeTextureCHROMIUM.
<target> uses the same parameters as TexImage2D.
<mailbox> identifies a GL_MAILBOX_SIZE_CHROMIUM byte sized name returned by
glGenMailboxCHROMIUM.
INVALID_OPERATION is generated if <target> is not a valid target.
INVALID_OPERATION is generated if the texture is attached to a framebuffer.
INVALID_OPERATION is generated if the texture is immutable.
INVALID_OPERATION is generated if <mailbox> is invalid.
void glConsumeTextureCHROMIUM (GLenum target, const GLbyte *mailbox)
<target> uses the same parameters as TexImage2D.
<mailbox> identifies a GL_MAILBOX_SIZE_CHROMIUM byte sized name returned by
glGenMailboxCHROMIUM.
Redefines the image data of the currently bound texture object with the
image data in the mailbox and empties the mailbox. The state of the
currently bound texture object is not modified, only the image data. All
levels are redefined.
If glConsumeTextureCHROMIUM generates an error, the associated image data
is preserved in the texture object.
INVALID_OPERATION is generated if <target> is not a valid target.
INVALID_OPERATION is generated if <mailbox> is empty.
INVALID_OPERATION is generated if <mailbox> is not in the scope of the
context.
INVALID_OPERATION is generated if <mailbox> is invalid.
INVALID_OPERATION is generated if the texture is attached to a framebuffer.
INVALID_OPERATION is generated if the texture is immutable.
INVALID_OPERATION is generated if the image data is invalid in the current
context.
New Tokens
The size of a mailbox name in bytes.
GL_MAILBOX_SIZE_CHROMIUM 64
Errors
None.
New Tokens
None.
New State
None.
Revision History
4/25/2011 Documented the extension
|
