equal
deleted
inserted
replaced
22 onto the screen and not rendering the content to the surface. </p> |
22 onto the screen and not rendering the content to the surface. </p> |
23 <section><title> Key concepts</title> <p>The following diagram illustrates |
23 <section><title> Key concepts</title> <p>The following diagram illustrates |
24 some of the key concepts that are used in the documentation of surfaces. </p> <fig id="GUID-F134C262-EC19-5925-A188-2C7C2CD5EEEA"> |
24 some of the key concepts that are used in the documentation of surfaces. </p> <fig id="GUID-F134C262-EC19-5925-A188-2C7C2CD5EEEA"> |
25 <title>Composition of the UI surface and an external surface, showing the |
25 <title>Composition of the UI surface and an external surface, showing the |
26 viewport and extent</title> |
26 viewport and extent</title> |
27 <image href="GUID-2468821F-6C66-5761-AE56-CEC942A2EE95_d0e194954_href.png" placement="inline"/> |
27 <image href="GUID-2468821F-6C66-5761-AE56-CEC942A2EE95_d0e199963_href.png" placement="inline"/> |
28 </fig> <dl> |
28 </fig> <dl> |
29 <dlentry> |
29 <dlentry> |
30 <dt>Graphics surface</dt> |
30 <dt>Graphics surface</dt> |
31 <dd><p>A graphics surface (usually simply called a <i>surface</i>) is a hardware-independent |
31 <dd><p>A graphics surface (usually simply called a <i>surface</i>) is a hardware-independent |
32 memory buffer for holding an image or part of a scene. A surface has a set |
32 memory buffer for holding an image or part of a scene. A surface has a set |
63 shown in the previous figure. Notice that the UI surface is the topmost layer |
63 shown in the previous figure. Notice that the UI surface is the topmost layer |
64 and that it contains a hole through which the external surface |
64 and that it contains a hole through which the external surface |
65 can be seen.</p> <fig id="GUID-4DB99814-988F-5D51-A1A7-E864B6DA6DFB"> |
65 can be seen.</p> <fig id="GUID-4DB99814-988F-5D51-A1A7-E864B6DA6DFB"> |
66 <title> A cross section through the surfaces, showing the display |
66 <title> A cross section through the surfaces, showing the display |
67 output </title> |
67 output </title> |
68 <image href="GUID-78B63C44-7765-5408-A611-DFE8709196F8_d0e195032_href.png" placement="inline"/> |
68 <image href="GUID-78B63C44-7765-5408-A611-DFE8709196F8_d0e200041_href.png" placement="inline"/> |
69 </fig> </section> |
69 </fig> </section> |
70 <section id="GUID-F9D7659B-1325-5DC2-9D7A-9B6C0DFB8A62"><title>Supported Uses</title> <p>You |
70 <section id="GUID-F9D7659B-1325-5DC2-9D7A-9B6C0DFB8A62"><title>Supported Uses</title> <p>You |
71 can: </p> <ul> |
71 can: </p> <ul> |
72 <li id="GUID-97CAD13E-1C70-59FF-B271-F3E77198086A"><p>Display an external |
72 <li id="GUID-97CAD13E-1C70-59FF-B271-F3E77198086A"><p>Display an external |
73 surface (for example, video content or a viewfinder image) within a window. </p> </li> |
73 surface (for example, video content or a viewfinder image) within a window. </p> </li> |
90 of the background surface by quadrant angles. </p> </li> |
90 of the background surface by quadrant angles. </p> </li> |
91 <li id="GUID-5631047A-A8AD-59DF-82FF-021964BA571D"><p>Flip the background |
91 <li id="GUID-5631047A-A8AD-59DF-82FF-021964BA571D"><p>Flip the background |
92 surface from top to bottom and rotate it by 180° to achieve a mirroring effect. </p> </li> |
92 surface from top to bottom and rotate it by 180° to achieve a mirroring effect. </p> </li> |
93 </ul> <p>The following diagrams shows some surface configuration use cases. </p> <fig id="GUID-FF25ED24-7A3D-5C4B-A711-D6AEA53E972F"> |
93 </ul> <p>The following diagrams shows some surface configuration use cases. </p> <fig id="GUID-FF25ED24-7A3D-5C4B-A711-D6AEA53E972F"> |
94 <title> Surface configuration use cases </title> |
94 <title> Surface configuration use cases </title> |
95 <image href="GUID-D04DD8E6-804F-539E-8BD1-146210F4A51C_d0e195099_href.png" placement="inline"/> |
95 <image href="GUID-D04DD8E6-804F-539E-8BD1-146210F4A51C_d0e200108_href.png" placement="inline"/> |
96 </fig> </section> |
96 </fig> </section> |
97 <section id="GUID-7EAB8F5D-6290-5B63-B396-8A1FAE7D91A5"><title> Configuration</title> <p>There |
97 <section id="GUID-7EAB8F5D-6290-5B63-B396-8A1FAE7D91A5"><title> Configuration</title> <p>There |
98 are a number of ways in which dynamically updated content can be configured |
98 are a number of ways in which dynamically updated content can be configured |
99 to appear on a window. </p> <p><b>A single content surface filling the window </b> </p> <p>External |
99 to appear on a window. </p> <p><b>A single content surface filling the window </b> </p> <p>External |
100 content can be fitted onto a Window Server window. Each axis of the surface |
100 content can be fitted onto a Window Server window. Each axis of the surface |