1/*
2 * Copyright (c) 2007-2011 Intel Corporation. All Rights Reserved.
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the
6 * "Software"), to deal in the Software without restriction, including
7 * without limitation the rights to use, copy, modify, merge, publish,
8 * distribute, sub license, and/or sell copies of the Software, and to
9 * permit persons to whom the Software is furnished to do so, subject to
10 * the following conditions:
11 *
12 * The above copyright notice and this permission notice (including the
13 * next paragraph) shall be included in all copies or substantial portions
14 * of the Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
17 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
19 * IN NO EVENT SHALL INTEL AND/OR ITS SUPPLIERS BE LIABLE FOR
20 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
21 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
22 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
23 */
24
25/**
26 * \file va_compat.h
27 * \brief The Compatibility API
28 *
29 * This file contains the \ref api_compat "Compatibility API".
30 */
31
32#ifndef VA_COMPAT_H
33#define VA_COMPAT_H
34
35#ifdef __cplusplus
36extern "C" {
37#endif
38
39/**
40 * \defgroup api_compat Compatibility API
41 *
42 * The Compatibility API allows older programs that are not ported to
43 * the current API to still build and run correctly. In particular,
44 * this exposes older API to allow for backwards source compatibility.
45 *
46 * @{
47 */
48
49/**
50 * Makes a string literal out of the macro argument
51 */
52#define VA_CPP_HELPER_STRINGIFY(x) \
53    VA_CPP_HELPER_STRINGIFY_(x)
54#define VA_CPP_HELPER_STRINGIFY_(x) \
55    #x
56
57/**
58 * Concatenates two macro arguments at preprocessing time.
59 */
60#define VA_CPP_HELPER_CONCAT(a, b) \
61    VA_CPP_HELPER_CONCAT_(a, b)
62#define VA_CPP_HELPER_CONCAT_(a, b) \
63    a ## b
64
65/**
66 * Generates the number of macro arguments at preprocessing time.
67 * <http://groups.google.com/group/comp.std.c/browse_thread/thread/77ee8c8f92e4a3fb/346fc464319b1ee5>
68 *
69 * Note: this doesn't work for macros with no arguments
70 */
71#define VA_CPP_HELPER_N_ARGS(...) \
72    VA_CPP_HELPER_N_ARGS_(__VA_ARGS__, VA_CPP_HELPER_N_ARGS_LIST_REV())
73#define VA_CPP_HELPER_N_ARGS_(...) \
74    VA_CPP_HELPER_N_ARGS_LIST(__VA_ARGS__)
75#define VA_CPP_HELPER_N_ARGS_LIST(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a12, a13, a14, a15, a16, N, ...) N
76#define VA_CPP_HELPER_N_ARGS_LIST_REV() \
77    15, 14, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0
78
79/**
80 * Generates a versioned function alias.
81 *
82 * VA_CPP_HELPER_ALIAS(vaSomeFunction, 0,32,0) will generate
83 *   .symber vaSomeFunction_0_32_0, vaSomeFunction@VA_API_0.32.0
84 */
85#define VA_CPP_HELPER_ALIAS(func, major, minor, micro) \
86    VA_CPP_HELPER_ALIAS_(func, major, minor, micro, "@")
87#define VA_CPP_HELPER_ALIAS_DEFAULT(func, major, minor, micro) \
88    VA_CPP_HELPER_ALIAS_(func, major, minor, micro, "@@")
89#define VA_CPP_HELPER_ALIAS_(func, major, minor, micro, binding)        \
90    asm(".symver " #func "_" #major "_" #minor "_" #micro ", "          \
91        #func binding "VA_API_" #major "." #minor "." #micro)
92
93/* vaCreateSurfaces() */
94
95#ifndef VA_COMPAT_DISABLED
96#define vaCreateSurfaces(dpy, ...)                                      \
97    VA_CPP_HELPER_CONCAT(vaCreateSurfaces,                              \
98                         VA_CPP_HELPER_N_ARGS(dpy, __VA_ARGS__))        \
99    (dpy, __VA_ARGS__)
100#endif
101
102#define vaCreateSurfaces6(dpy, width, height, format, num_surfaces, surfaces) \
103    (vaCreateSurfaces)(dpy, format, width, height, surfaces, num_surfaces, \
104                       NULL, 0)
105
106#define vaCreateSurfaces8(dpy, format, width, height, surfaces, num_surfaces, attribs, num_attribs) \
107    (vaCreateSurfaces)(dpy, format, width, height, surfaces, num_surfaces, \
108                       attribs, num_attribs)
109
110/*@}*/
111
112#ifdef __cplusplus
113}
114#endif
115
116#endif /* VA_COMPAT_H */
117