vldXvMC.h

   1 /*****************************************************************************
   2  * VLD XvMC Nonstandard extension API.
   3  *
   4  * Copyright (c) 2004 The Unichrome Project. All rights reserved.
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a
   7  * copy of this software and associated documentation files (the "Software"),
   8  * to deal in the Software without restriction, including without limitation
   9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  10  * and/or sell copies of the Software, and to permit persons to whom the
  11  * Software is furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice shall be included in
  14  * all copies or substantial portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  19  * AUTHOR(S) OR COPYRIGHT HOLDER(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  21  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  22  * DEALINGS IN THE SOFTWARE.
  23  *
  24  * Author: Thomas Hellström, 2004.
  25  */
  26
  27
  28 #ifndef _VLDXVMC_H
  29 #define _VLDXVMC_H
  30
  31 #include <X11/Xlib.h>
  32 #include <X11/extensions/XvMC.h>
  33
  34 /*
  35  * New "Motion compensation type".
  36  */
  37
  38 #define XVMC_VLD 0x0020000
  39
  40 /*
  41  * Below Flags to be passed in the XvMCMpegControl structure 'flag' field.
  42  */
  43
  44 #define XVMC_PROGRESSIVE_SEQUENCE 0x00000010
  45
  46 /*
  47  * Zig-Zag Scan / Alternative Scan.
  48  */
  49
  50 #define XVMC_ZIG_ZAG_SCAN         0x00000000
  51 #define XVMC_ALTERNATE_SCAN       0x00000100
  52
  53 /*
  54  * Frame DCT and frame prediction are used. /
  55  * Field prediction
  56  */
  57
  58 #define XVMC_PRED_DCT_FRAME       0x00000040
  59 #define XVMC_PRED_DCT_FIELD       0x00000000
  60
  61 /*
  62  * Top / Bottom field first
  63  */
  64
  65 #define XVMC_TOP_FIELD_FIRST      0x00000080
  66 #define XVMC_BOTTOM_FIELD_FIRST   0x00000000
  67
  68 /*
  69  * Motion vectors coded in intra macroblocks
  70  */
  71
  72 #define XVMC_CONCEALMENT_MOTION_VECTORS 0x00000200
  73
  74 /*
  75  * Which of two mappings between quantiser_scale_code
  76  * and quantiser_scale shall apply.
  77  */
  78
  79 #define XVMC_Q_SCALE_TYPE         0x00000400
  80
  81 /*
  82  * Intra VLC Format: Bit = 0,  Bit = 1
  83  * Intra blocks      B-14      B-15
  84  * Non-intra blocks  B-14      B-14
  85  */
  86 #define XVMC_INTRA_VLC_FORMAT     0x00000800
  87
  88 /*
  89  * Also XVMC_SECOND_FIELD should be set in flags if active.
  90  */
  91
  92 #define XVMC_I_PICTURE 1
  93 #define XVMC_P_PICTURE 2
  94 #define XVMC_B_PICTURE 3
  95
  96 typedef struct _XvMCMpegControl{
  97     unsigned
  98         BVMV_range,        /* Backward vertical motion vector range */
  99         BHMV_range,        /* Backward horizontal motion vector range */
 100         FVMV_range,        /* Forward vertical motion vector range */
 101         FHMV_range,        /* Forward horizontal motion vector range */
 102         picture_structure, /* XVMC_TOP_FIELD, XVMC_BOTTOM_FIELD,
 103                             *  XVMC_FRAME_PICTURE
 104                             */
 105         intra_dc_precision, /* 0x00 - 0x03 corresponds to 8 to 11 bits prec. */
 106         picture_coding_type,/* XVMC_X_PICTURE */
 107         mpeg_coding,        /* XVMC_MPEG_2 */
 108         flags;              /* See above */
 109 }XvMCMpegControl;
 110
 111
 112 /*
 113  * The following function is called BEFORE starting sending slices to the
 114  * lib. It grabs the decoder hardware and prepares it for coming slices.
 115  * The function XvMCSyncSurface will release the hardware for other contexts
 116  * in addition to it's current functionality.
 117  */
 118
 119 extern Status XvMCBeginSurface(Display *display,
 120                                XvMCContext *context,
 121                                XvMCSurface *target_surface,
 122                                XvMCSurface *past_surface,
 123                                XvMCSurface *future_surface,
 124                                const XvMCMpegControl *control);
 125
 126
 127 /*
 128  * The quantizer matrix structure. This should be filled in by the user and
 129  * uploaded whenever a change is needed. The lib initializes with
 130  * default matrices and will automatically load the hardware with new matrices
 131  * on decoder context switches. To load data, set the corresponding load flag
 132  * to true and fill in the values. The VIA MPEG2 engine only uses the
 133  * intra_quantiser_matrix and the non_intra_quantiser_matrix.
 134  */
 135
 136 typedef struct _XvMCQMatrix {
 137     int load_intra_quantiser_matrix;
 138     int load_non_intra_quantiser_matrix;
 139     int load_chroma_intra_quantiser_matrix;
 140     int load_chroma_non_intra_quantiser_matrix;
 141     unsigned char intra_quantiser_matrix[64];
 142     unsigned char non_intra_quantiser_matrix[64];
 143     unsigned char chroma_intra_quantiser_matrix[64];
 144     unsigned char chroma_non_intra_quantiser_matrix[64];
 145 } XvMCQMatrix;
 146
 147 /*
 148  * Upload a XvMCQMatrix structure to the clientlib.
 149  * The hardware will start using it the next XvMCBeginSurface.
 150  */
 151
 152 extern Status XvMCLoadQMatrix(Display *display, XvMCContext *context,
 153                               const XvMCQMatrix *qmx);
 154
 155
 156 /*
 157  * Put a slice to the decoder. The hardware will start processing it
 158  * immediately.
 159  */
 160
 161 extern Status XvMCPutSlice(Display *display,XvMCContext *context,
 162                            char *slice, int nBytes);
 163 /*
 164  * Put a slice without the slice start code to the decoder.
 165  * The hardware will start processing it
 166  * immediately. This function is for client optimization.
 167  * XvMCPutSlice(display,context,slice,nBytes) is equivalent to
 168  * XvMCPutSlice2(display,context,slice+4,nBytes-4,slice[3]);
 169  */
 170
 171 extern Status XvMCPutSlice2(Display *display,XvMCContext *context,
 172                            char *slice, int nBytes, int sliceCode);
 173
 174 #endif