OLD | NEW |
1 Name | 1 Name |
2 | 2 |
3 CHROMIUM_texture_mailbox | 3 CHROMIUM_texture_mailbox |
4 | 4 |
5 Name Strings | 5 Name Strings |
6 | 6 |
7 GL_CHROMIUM_texture_mailbox | 7 GL_CHROMIUM_texture_mailbox |
8 | 8 |
9 Version | 9 Version |
10 | 10 |
(...skipping 20 matching lines...) Expand all Loading... |
31 Generates a unique name identifying a mailbox. The name is generated using | 31 Generates a unique name identifying a mailbox. The name is generated using |
32 a cryptographic random number generator and is intended to be difficult to | 32 a cryptographic random number generator and is intended to be difficult to |
33 guess. The scope of the name is implementation specific, for example it | 33 guess. The scope of the name is implementation specific, for example it |
34 might not span multiple displays. | 34 might not span multiple displays. |
35 | 35 |
36 <mailbox> returns a GL_MAILBOX_SIZE_CHROMIUM byte sized name | 36 <mailbox> returns a GL_MAILBOX_SIZE_CHROMIUM byte sized name |
37 | 37 |
38 | 38 |
39 void glProduceTextureCHROMIUM (GLenum target, const GLbyte *mailbox) | 39 void glProduceTextureCHROMIUM (GLenum target, const GLbyte *mailbox) |
40 | 40 |
41 Moves the image data of the currently bound texture object into the mailbox. | 41 Moves the image data and parameters of the currently bound texture object |
42 The texture object is redefined as though all its levels had been resized to | 42 into the mailbox. The texture object is redefined as though all its levels |
43 zero by zero and the texture object is therefore incomplete. If the mailbox | 43 had been resized to zero by zero and the texture object is therefore |
44 previously contained image data, the old image data is deleted. The state | 44 incomplete. If the mailbox previously contained image data, the old image |
45 of the bound texture object is not saved in the mailbox, only the image | 45 data is deleted. The state of the bound texture object is not saved in the |
46 data, as well as the immutable state. The texture object is no longer | 46 mailbox, only the image data, as well as the immutable state. The texture |
47 immutable. | 47 object is no longer immutable. |
48 | 48 |
49 If glProduceTextureCHROMIUM generates an error, the associated image data | 49 If glProduceTextureCHROMIUM generates an error, the associated image data |
50 is preserved in the texture object. | 50 is preserved in the texture object. |
51 | 51 |
52 The mailbox is emptied and the texture image data deleted if the context | 52 The mailbox is emptied and the texture image data deleted if the context |
53 is destroyed before being consumed. See glConsumeTextureCHROMIUM. | 53 is destroyed before being consumed. See glConsumeTextureCHROMIUM. |
54 | 54 |
55 <target> uses the same parameters as TexImage2D. | 55 <target> uses the same parameters as TexImage2D. |
56 | 56 |
57 <mailbox> identifies a GL_MAILBOX_SIZE_CHROMIUM byte sized name returned by | 57 <mailbox> identifies a GL_MAILBOX_SIZE_CHROMIUM byte sized name returned by |
58 glGenMailboxCHROMIUM. | 58 glGenMailboxCHROMIUM. |
59 | 59 |
60 INVALID_OPERATION is generated if <target> is not a valid target. | 60 INVALID_OPERATION is generated if <target> is not a valid target. |
61 | 61 |
62 INVALID_OPERATION is generated if the texture is attached to a framebuffer. | 62 INVALID_OPERATION is generated if the texture is attached to a framebuffer. |
63 | 63 |
64 INVALID_OPERATION is generated if the texture is immutable. | 64 INVALID_OPERATION is generated if the texture is immutable. |
65 | 65 |
66 INVALID_OPERATION is generated if <mailbox> is invalid. | 66 INVALID_OPERATION is generated if <mailbox> is invalid. |
67 | 67 |
68 | 68 |
69 void glConsumeTextureCHROMIUM (GLenum target, const GLbyte *mailbox) | 69 void glConsumeTextureCHROMIUM (GLenum target, const GLbyte *mailbox) |
70 | 70 |
71 <target> uses the same parameters as TexImage2D. | 71 <target> uses the same parameters as TexImage2D. |
72 | 72 |
73 <mailbox> identifies a GL_MAILBOX_SIZE_CHROMIUM byte sized name returned by | 73 <mailbox> identifies a GL_MAILBOX_SIZE_CHROMIUM byte sized name returned by |
74 glGenMailboxCHROMIUM. | 74 glGenMailboxCHROMIUM. |
75 | 75 |
76 Redefines the image data of the currently bound texture object with the | 76 Redefines the image data and parameters of the currently bound texture |
77 image data in the mailbox and empties the mailbox. The state of the | 77 object with the image data and parameters in the mailbox and empties the |
78 currently bound texture object is not modified, only the image data. All | 78 mailbox. All levels are redefined, and the immutable state is set according |
79 levels are redefined, and the immutable state is set according to the | 79 to the contents of the mailbox. |
80 contents of the mailbox. | |
81 | 80 |
82 If glConsumeTextureCHROMIUM generates an error, the associated image data | 81 If glConsumeTextureCHROMIUM generates an error, the associated image data |
83 is preserved in the texture object. | 82 is preserved in the texture object. |
84 | 83 |
85 INVALID_OPERATION is generated if <target> is not a valid target. | 84 INVALID_OPERATION is generated if <target> is not a valid target. |
86 | 85 |
87 INVALID_OPERATION is generated if <mailbox> is empty. | 86 INVALID_OPERATION is generated if <mailbox> is empty. |
88 | 87 |
89 INVALID_OPERATION is generated if <mailbox> is not in the scope of the | 88 INVALID_OPERATION is generated if <mailbox> is not in the scope of the |
90 context. | 89 context. |
(...skipping 21 matching lines...) Expand all Loading... |
112 | 111 |
113 None. | 112 None. |
114 | 113 |
115 New State | 114 New State |
116 | 115 |
117 None. | 116 None. |
118 | 117 |
119 Revision History | 118 Revision History |
120 | 119 |
121 4/25/2011 Documented the extension | 120 4/25/2011 Documented the extension |
OLD | NEW |