|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-DEA883D0-7C53-407A-AC5D-0A3208E667C7" xml:lang="en"><title>EGL |
|
13 Reusable Sync Extension</title><shortdesc>This topic describes the EGL reusable sync extension, which introduces |
|
14 sync objects into EGL. Sync objects provide a synchronization mechanism and |
|
15 represent events, whose completion can be tested or waited on. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
16 <p>The following table provides a link to the specification.</p> |
|
17 <table id="GUID-3E2BB969-C9C3-473B-B448-5BEAA279619B"> |
|
18 <tgroup cols="2"><colspec colname="col1" colwidth="0.20*"/><colspec colname="col2" colwidth="1.80*"/> |
|
19 <thead> |
|
20 <row> |
|
21 <entry valign="top">Version </entry> |
|
22 <entry valign="top">Specification</entry> |
|
23 </row> |
|
24 </thead> |
|
25 <tbody> |
|
26 <row> |
|
27 <entry>Version 20</entry> |
|
28 <entry><xref href="http://www.khronos.org/registry/egl/extensions/KHR/EGL_KHR_reusable_sync.txt" scope="external">http://www.khronos.org/registry/egl/extensions/KHR/EGL_KHR_reusable_sync.txt</xref></entry> |
|
29 </row> |
|
30 </tbody> |
|
31 </tgroup> |
|
32 </table> |
|
33 <p>The OpenWF-C Engine and Support components use EGL sync objects for synchronization. |
|
34 Therefore the EGL implementation must support the extension if OpenWF composition |
|
35 is in use. The EGL Reference Implementation component implements the extension. </p> |
|
36 <p>The following table lists the reusable sync extension APIs. |
|
37 Clients obtain an extension function by calling <codeph>eglGetProcAddress()</codeph> and |
|
38 pass in the function name.</p> |
|
39 <table id="GUID-CE850680-15FF-4861-8B03-5D56125282D7"> |
|
40 <tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/> |
|
41 <thead> |
|
42 <row> |
|
43 <entry valign="top">Function</entry> |
|
44 <entry valign="top">Description</entry> |
|
45 </row> |
|
46 </thead> |
|
47 <tbody> |
|
48 <row> |
|
49 <entry><codeph>eglCreateSyncKHR()</codeph></entry> |
|
50 <entry>Creates a sync object which is associated with the initialized EGL |
|
51 display and whose status is unsignaled.</entry> |
|
52 </row> |
|
53 <row> |
|
54 <entry><codeph>eglDestroySyncKHR()</codeph></entry> |
|
55 <entry>Destroys an existing sync object.</entry> |
|
56 </row> |
|
57 <row> |
|
58 <entry><codeph>eglClientWaitSyncKHR()</codeph></entry> |
|
59 <entry>Blocks the calling thread until the sync object is signaled or after |
|
60 the specified timeout period.</entry> |
|
61 </row> |
|
62 <row> |
|
63 <entry><codeph>eglSignalSyncKHR()</codeph></entry> |
|
64 <entry>Signals or unsignals the sync object. </entry> |
|
65 </row> |
|
66 <row> |
|
67 <entry><codeph>eglGetSyncAttribKHR()</codeph></entry> |
|
68 <entry>Queries attributes of the sync object.</entry> |
|
69 </row> |
|
70 </tbody> |
|
71 </tgroup> |
|
72 </table> |
|
73 <codeblock xml:space="preserve"/> |
|
74 </conbody><related-links> |
|
75 <link href="GUID-A5914CFF-6F86-53E8-9928-36D3379835B1.dita"><linktext>EGL Interface |
|
76 Overview</linktext></link> |
|
77 <link href="GUID-894AB487-C127-532D-852B-37CB0DEA1440.dita"><linktext>Symbian-Specific |
|
78 Behavior</linktext></link> |
|
79 <link href="GUID-46813F51-370B-5853-917C-6916925A347D.dita"><linktext>EGL Tutorial</linktext> |
|
80 </link> |
|
81 <link href="GUID-DC8BFEF5-DA50-52DA-8CE2-5729A4A005F6.dita"><linktext>EGL Collection |
|
82 Overview</linktext></link> |
|
83 <link href="GUID-83510B5B-9725-5272-BF51-23A089178DAC.dita"> |
|
84 <linktext>OpenWF Support Component Overview</linktext></link> |
|
85 </related-links></concept> |