• Home
  • History
  • Annotate
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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
36  extern "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