1 #ifndef _EGLUPLATFORM_HPP
2 #define _EGLUPLATFORM_HPP
3 /*-------------------------------------------------------------------------
4  * drawElements Quality Program Tester Core
5  * ----------------------------------------
6  *
7  * Copyright 2014 The Android Open Source Project
8  *
9  * Licensed under the Apache License, Version 2.0 (the "License");
10  * you may not use this file except in compliance with the License.
11  * You may obtain a copy of the License at
12  *
13  *      http://www.apache.org/licenses/LICENSE-2.0
14  *
15  * Unless required by applicable law or agreed to in writing, software
16  * distributed under the License is distributed on an "AS IS" BASIS,
17  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18  * See the License for the specific language governing permissions and
19  * limitations under the License.
20  *
21  *//*!
22  * \file
23  * \brief EGL platform interface.
24  *//*--------------------------------------------------------------------*/
25 
26 #include "tcuDefs.hpp"
27 #include "egluNativeDisplay.hpp"
28 #include "gluRenderContext.hpp"
29 
30 namespace tcu
31 {
32 class CommandLine;
33 class FunctionLibrary;
34 }
35 
36 namespace eglu
37 {
38 
39 /*--------------------------------------------------------------------*//*!
40  * \brief EGL platform interface
41  *
42  * EGL platform interface provides mechanism to implement platform-specific
43  * bits of EGL API for use in EGL tests, or OpenGL (ES) context creation.
44  *
45  * A single platform can support multiple native object types. This is
46  * accomplished by registering multiple object factories. Command line
47  * parameters (such as --deqp-egl-display-type=) are used to select
48  * object types.
49  *
50  * See following classes for complete description of the porting layer:
51  *
52  *  * eglu::NativeDisplay, created by eglu::NativeDisplayFactory
53  *  * eglu::NativeWindow, created by eglu::NativeWindowFactory
54  *  * eglu::NativePixmap, created by eglu::NativePixmapFactory
55  *
56  * If you implement EGL support, you may use it to enable GL support by
57  * adding eglu::GLContextFactory to m_contextFactoryRegistry in your
58  * glu::Platform implementation.
59  *
60  * EGL platform implementation is required by EGL tests. OpenGL (ES) and
61  * OpenCL tests can benefit from, but do not require EGL platform
62  * implementation.
63  *//*--------------------------------------------------------------------*/
64 class Platform
65 {
66 public:
67 										Platform						(void);
68 	// Code outside porting layer will never attempt to delete eglu::Platform
69 	virtual								~Platform						(void);
70 
getNativeDisplayFactoryRegistry(void) const71 	const NativeDisplayFactoryRegistry&	getNativeDisplayFactoryRegistry	(void) const { return m_nativeDisplayFactoryRegistry;	}
72 
73 	/*--------------------------------------------------------------------*//*!
74 	 * \brief Get fallback GL library
75 	 *
76 	 * EGL tests use eglGetProcAddress() to load API entry points. However,
77 	 * if the platform does not support EGL_KHR_get_all_proc_addresses extension,
78 	 * core API entry points must be loaded using alternative method, namely
79 	 * this default GL function library.
80 	 *
81 	 * You may implement platform-specific way for loading GL entry points
82 	 * by implementing this method.
83 	 *
84 	 * Default implementation provides entry points for ES2 and ES3 APIs
85 	 * if binary is directly linked against GLES library.
86 	 *
87 	 * \param contextType	GL context type
88 	 * \param cmdLine		Reserved for future use
89 	 *//*--------------------------------------------------------------------*/
90 	virtual tcu::FunctionLibrary*		createDefaultGLFunctionLibrary	(glu::ApiType apiType, const tcu::CommandLine& cmdLine) const;
91 
92 protected:
93 
94 	/*--------------------------------------------------------------------*//*!
95 	 * \brief Native display factory registry
96 	 *
97 	 * Native display factory registry holds list of eglu::NativeDisplayFactory
98 	 * objects that can create eglu::NativeDisplay instances. You should
99 	 * implement eglu::NativeDisplay and eglu::NativeDisplayFactory and add
100 	 * instance of that factory implementation to this registry.
101 	 *
102 	 * --deqp-egl-display-type command line argument is used to select the
103 	 * display factory to use. If no type is given in command line, first entry
104 	 * is used.
105 	 *//*--------------------------------------------------------------------*/
106 	NativeDisplayFactoryRegistry		m_nativeDisplayFactoryRegistry;
107 };
108 
109 } // eglu
110 
111 #endif // _EGLUPLATFORM_HPP
112