73 be the surface's master display and waits for it to complete before sending |
73 be the surface's master display and waits for it to complete before sending |
74 the notification to the client. </p> <fig id="GUID-14C89A10-7762-5836-AF7F-B187704510E5"> |
74 the notification to the client. </p> <fig id="GUID-14C89A10-7762-5836-AF7F-B187704510E5"> |
75 <title> The surface is visible on Screen2 only, |
75 <title> The surface is visible on Screen2 only, |
76 Composition Engine 1 replies before Composition Engine 2 |
76 Composition Engine 1 replies before Composition Engine 2 |
77 </title> |
77 </title> |
78 <image href="GUID-5F9BEEF7-19BC-550F-BD97-60F70B55E906_d0e277039_href.png" placement="inline"/> |
78 <image href="GUID-5F9BEEF7-19BC-550F-BD97-60F70B55E906_d0e283039_href.png" placement="inline"/> |
79 </fig> <p>In the next diagram, the surface is still visible on <i>Screen2</i> only. |
79 </fig> <p>In the next diagram, the surface is still visible on <i>Screen2</i> only. |
80 This time, however, <i>Composition Engine 2</i> replies before <i>Composition |
80 This time, however, <i>Composition Engine 2</i> replies before <i>Composition |
81 Engine 1</i>. The Surface Update Server considers <i>Composition Engine 1</i> to |
81 Engine 1</i>. The Surface Update Server considers <i>Composition Engine 1</i> to |
82 be the master until it receives an error (<codeph>KErrNotVisible</codeph> in |
82 be the master until it receives an error (<codeph>KErrNotVisible</codeph> in |
83 this example) from <i>Composition Engine 1</i>. It then considers <i>Backend2</i> to |
83 this example) from <i>Composition Engine 1</i>. It then considers <i>Backend2</i> to |
86 that <i>Composition Engine 1</i> returns the error. This is because <i>Backend2</i> replied |
86 that <i>Composition Engine 1</i> returns the error. This is because <i>Backend2</i> replied |
87 before <i>Backend1.</i> </p> <fig id="GUID-0708D124-F89D-5BCA-85B0-E28E4CCD26C7"> |
87 before <i>Backend1.</i> </p> <fig id="GUID-0708D124-F89D-5BCA-85B0-E28E4CCD26C7"> |
88 <title> The surface is visible on Screen2 only, |
88 <title> The surface is visible on Screen2 only, |
89 Composition Engine 2 replies before Composition Engine 1 |
89 Composition Engine 2 replies before Composition Engine 1 |
90 </title> |
90 </title> |
91 <image href="GUID-B4653180-46EB-58A8-B2A8-0DD2C3D30FE7_d0e277089_href.png" placement="inline"/> |
91 <image href="GUID-B4653180-46EB-58A8-B2A8-0DD2C3D30FE7_d0e283089_href.png" placement="inline"/> |
92 </fig> <p>In this final diagram, the surface is visible on both screens. <i>Screen1</i> is |
92 </fig> <p>In this final diagram, the surface is visible on both screens. <i>Screen1</i> is |
93 considered the surface's master display and the client is notified when <i>Composition |
93 considered the surface's master display and the client is notified when <i>Composition |
94 Engine 1</i> completes. When <i>Composition Engine 2</i> completes, the Surface |
94 Engine 1</i> completes. When <i>Composition Engine 2</i> completes, the Surface |
95 Update Server discards its notification. </p> <fig id="GUID-FA4BE8A3-33A2-53E7-9124-53D404B0305A"> |
95 Update Server discards its notification. </p> <fig id="GUID-FA4BE8A3-33A2-53E7-9124-53D404B0305A"> |
96 <title> The surface is visible on both screens. </title> |
96 <title> The surface is visible on both screens. </title> |
97 <image href="GUID-467EF3F5-754B-550A-A9C7-246D68C91F0A_d0e277109_href.png" placement="inline"/> |
97 <image href="GUID-467EF3F5-754B-550A-A9C7-246D68C91F0A_d0e283109_href.png" placement="inline"/> |
98 </fig> </section> |
98 </fig> </section> |
99 <section><title>Example</title> <p>The following code snippet shows using |
99 <section><title>Example</title> <p>The following code snippet shows using |
100 the global surface update feature to request composition to all of the screens |
100 the global surface update feature to request composition to all of the screens |
101 that are registered with the Surface Update Server. </p> <codeblock id="GUID-45C71218-12FC-58A9-877E-27D642F5E949" xml:space="preserve">TRequestStatus status; |
101 that are registered with the Surface Update Server. </p> <codeblock id="GUID-45C71218-12FC-58A9-877E-27D642F5E949" xml:space="preserve">TRequestStatus status; |
102 RRegion *region; |
102 RRegion *region; |