Home | History | Annotate | Download | only in va
      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 (at) 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