summaryrefslogtreecommitdiff
path: root/tests/util/piglit-util-egl.h
blob: 9f8e10822b8be660dd607749e46ed44497b26a99 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
/*
 * Copyright (c) Intel 2011
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * on the rights to use, copy, modify, merge, publish, distribute, sub
 * license, and/or sell copies of the Software, and to permit persons to whom
 * the Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice (including the next
 * paragraph) shall be included in all copies or substantial portions of the
 * Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.  IN NO EVENT SHALL
 * VA LINUX SYSTEM, IBM AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
 * USE OR OTHER DEALINGS IN THE SOFTWARE.
 */

#pragma once

#define EGL_EGLEXT_PROTOTYPES

#include <EGL/egl.h>
#include <EGL/eglext.h>

#include "piglit-util.h"

#ifdef __cplusplus
extern "C" {
#endif

#define EGL_PLATFORM_WAYLAND_EXT          0x31D8
#define EGL_PLATFORM_X11_EXT              0x31D5
#define EGL_PLATFORM_GBM_MESA             0x31D7

#ifndef EGL_KHR_no_config_context
#define EGL_KHR_no_config_context 1
#define EGL_NO_CONFIG_KHR                 ((EGLConfig)0)
#endif /* EGL_KHR_no_config_context */

#ifndef EGL_MESA_platform_surfaceless
#define EGL_MESA_platform_surfaceless 1
#define EGL_PLATFORM_SURFACELESS_MESA           0x31DD
#endif /* EGL_MESA_platform_surfaceless */

/**
 * \brief Convert an EGL error to a string.
 *
 * For example, given EGL_BAD_DRAWABLE, return "EGL_BAD_DRAWABLE".
 *
 * Return "(unrecognized error)" if the enum is not recognized.
 */
const char* piglit_get_egl_error_name(EGLint error);

/**
 * \brief Check for unexpected EGL errors.
 *
 * If eglGetError() returns an error other than \c expected_error, then
 * print a diagnostic and return false.
 *
 * If you expect no error, then set \code expected_error = EGL_SUCCESS \endcode.
 */
bool
piglit_check_egl_error(EGLint expected_error);

/**
 * \brief Get default display for given platform.
 *
 * This function wraps piglit_egl_get_display, providing \c EGL_DEFAULT_DISPLAY
 * for the native_display.
 */
EGLDisplay
piglit_egl_get_default_display(EGLenum platform);

/**
 * \brief Get display for given platform with native_display.
 *
 * If \a platform is EGL_NONE, the this function wraps eglGetDisplay().
 * Otherwise, it wraps eglGetPlatformDisplayEXT().
 *
 * On failure, return EGL_NO_DISPLAY.
 *
 * If EGL does not support the platform extension for the given \a platform,
 * then return EGL_NO_DISPLAY.
 */
EGLDisplay
piglit_egl_get_display(EGLenum platform, void *native_display);

/**
 * \brief Checks whether an EGL extension is supported.
 */
bool piglit_is_egl_extension_supported(EGLDisplay egl_dpy, const char *name);

/**
 * \brief Checks for EGL extension and skips if not supported
 */
void piglit_require_egl_extension(EGLDisplay dpy, const char *name);

/**
 * \brief Wrapper for eglBindAPI().
 *
 * Return true if eglBindAPI succeeds. Return false if eglBindAPI fails
 * because the EGL implementation does not support the API; in most cases,
 * the caller should then report SKIP.
 *
 * If eglBindAPI fails for unexpected reasons, then the test fails.
 */
bool
piglit_egl_bind_api(EGLenum api);

#ifdef __cplusplus
} /* end extern "C" */
#endif