equal
deleted
inserted
replaced
74 with the number 3 in the following diagram) </p> </li> |
74 with the number 3 in the following diagram) </p> </li> |
75 <li id="GUID-4209FD9D-C668-5902-863C-DB49343ED634"><p>Close the previous composition |
75 <li id="GUID-4209FD9D-C668-5902-863C-DB49343ED634"><p>Close the previous composition |
76 surface. </p> </li> |
76 surface. </p> </li> |
77 </ol> <fig id="GUID-B793BDDF-7607-5BCD-94C2-44F8349D7BC5"> |
77 </ol> <fig id="GUID-B793BDDF-7607-5BCD-94C2-44F8349D7BC5"> |
78 <title>The buffers in the typical approach to handling a window resize event</title> |
78 <title>The buffers in the typical approach to handling a window resize event</title> |
79 <image href="GUID-ADC9B349-3CE4-5017-B437-A7F8890C7F0F_d0e246447_href.png" placement="inline"/> |
79 <image href="GUID-ADC9B349-3CE4-5017-B437-A7F8890C7F0F_d0e274418_href.png" placement="inline"/> |
80 </fig> </section> |
80 </fig> </section> |
81 <section id="GUID-CF08037B-2A6A-4B79-9766-E8C730C086F3"> <title>Handling |
81 <section id="GUID-CF08037B-2A6A-4B79-9766-E8C730C086F3"> <title>Handling |
82 preserve buffers </title> <p>When the preserve buffer option is in use, |
82 preserve buffers </title> <p>When the preserve buffer option is in use, |
83 a typical implementation promotes the current back buffer to the front buffer |
83 a typical implementation promotes the current back buffer to the front buffer |
84 for display as usual, and copies the back buffer content to the new back buffer. |
84 for display as usual, and copies the back buffer content to the new back buffer. |
88 following diagram shows the scenario of a client application drawing A and |
88 following diagram shows the scenario of a client application drawing A and |
89 later B on a surface with the preserve buffers enabled. Notice that <codeph>eglSwapBuffers()</codeph> promotes |
89 later B on a surface with the preserve buffers enabled. Notice that <codeph>eglSwapBuffers()</codeph> promotes |
90 the back buffer to the front buffer and then immediately copies the contents |
90 the back buffer to the front buffer and then immediately copies the contents |
91 of the newly promoted buffer to the new back buffer.</p><fig id="GUID-B9C43452-0627-41FA-A68A-4C9726194A60"> |
91 of the newly promoted buffer to the new back buffer.</p><fig id="GUID-B9C43452-0627-41FA-A68A-4C9726194A60"> |
92 <title>Handling preserve buffers</title> |
92 <title>Handling preserve buffers</title> |
93 <image href="GUID-9C54DAFB-843B-41A7-8E54-9B2A39F46527_d0e246471_href.png" placement="inline"/> |
93 <image href="GUID-9C54DAFB-843B-41A7-8E54-9B2A39F46527_d0e274442_href.png" placement="inline"/> |
94 </fig> </section> |
94 </fig> </section> |
95 <section><title>Handling a window resize event with the preserve buffer option</title><p>If |
95 <section><title>Handling a window resize event with the preserve buffer option</title><p>If |
96 there is a window resize event when the preserve buffer option is in use, <codeph>eglSwapBuffers()</codeph> creates |
96 there is a window resize event when the preserve buffer option is in use, <codeph>eglSwapBuffers()</codeph> creates |
97 a new surface and typically copies into it any pixels that overlap the previous |
97 a new surface and typically copies into it any pixels that overlap the previous |
98 surface. To illustrate how this works, consider the following scenario:</p><ol> |
98 surface. To illustrate how this works, consider the following scenario:</p><ol> |
105 <li id="GUID-89A1D882-B5DC-4093-98E5-34E3063BBF25"><p>After calling <codeph>eglSwapBuffers()</codeph>, |
105 <li id="GUID-89A1D882-B5DC-4093-98E5-34E3063BBF25"><p>After calling <codeph>eglSwapBuffers()</codeph>, |
106 the application draws a C below the A.</p></li> |
106 the application draws a C below the A.</p></li> |
107 </ol><p>The following diagram illustrates a typical implementation. There |
107 </ol><p>The following diagram illustrates a typical implementation. There |
108 are more details below the diagram.</p><fig id="GUID-D19DF371-8640-4A2B-AF56-57EF2387CEFD"> |
108 are more details below the diagram.</p><fig id="GUID-D19DF371-8640-4A2B-AF56-57EF2387CEFD"> |
109 <title>Handling a window resize with the preserve buffer option</title> |
109 <title>Handling a window resize with the preserve buffer option</title> |
110 <image href="GUID-8A8FA00B-58FA-4D4E-A018-70D5558BCBFE_d0e246511_href.png" placement="inline"/> |
110 <image href="GUID-8A8FA00B-58FA-4D4E-A018-70D5558BCBFE_d0e274482_href.png" placement="inline"/> |
111 </fig><p>The first <codeph>eglSwapBuffers()</codeph> call (marked X in the |
111 </fig><p>The first <codeph>eglSwapBuffers()</codeph> call (marked X in the |
112 diagram above) does the following:</p><ol> |
112 diagram above) does the following:</p><ol> |
113 <li id="GUID-70603721-5603-4015-B382-8D3F9D693139"><p>Promotes the current |
113 <li id="GUID-70603721-5603-4015-B382-8D3F9D693139"><p>Promotes the current |
114 back buffer (showing AB) to the front buffer for display as usual. </p></li> |
114 back buffer (showing AB) to the front buffer for display as usual. </p></li> |
115 <li id="GUID-7040357F-1F40-4E34-ACB2-170815B06D10"><p>Copies the back buffer |
115 <li id="GUID-7040357F-1F40-4E34-ACB2-170815B06D10"><p>Copies the back buffer |