va/va_tpi.c

   1 /*
   2  * Copyright (c) 2007 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 PRECISION INSIGHT 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 #define _GNU_SOURCE 1
  26 #include "sysdeps.h"
  27 #include "va.h"
  28 #include "va_backend.h"
  29 #include "va_backend_tpi.h"
  30
  31 #include <assert.h>
  32 #include <stdarg.h>
  33 #include <stdio.h>
  34 #include <stdlib.h>
  35 #include <string.h>
  36 #include <dlfcn.h>
  37 #include <unistd.h>
  38
  39 #define CTX(dpy) (((VADisplayContextP)dpy)->pDriverContext)
  40 #define CHECK_DISPLAY(dpy) if( !vaDisplayIsValid(dpy) ) { return VA_STATUS_ERROR_INVALID_DISPLAY; }
  41
  42 /* Wrap a CI (camera imaging) frame as a VA surface to share captured video between camear
  43  * and VA encode. With frame_id, VA driver need to call CI interfaces to get the information
  44  * of the frame, and to determine if the frame can be wrapped as a VA surface
  45  *
  46  * Application should make sure the frame is idle before the frame is passed into VA stack
  47  * and also a vaSyncSurface should be called before application tries to access the frame
  48  * from CI stack
  49  */
  50 VAStatus vaCreateSurfaceFromCIFrame (
  51     VADisplay dpy,
  52     unsigned long frame_id,
  53     VASurfaceID *surface        /* out */
  54 )
  55 {
  56   VADriverContextP ctx;
  57   struct VADriverVTableTPI *tpi;
  58   CHECK_DISPLAY(dpy);
  59   ctx = CTX(dpy);
  60
  61   tpi = ( struct VADriverVTableTPI *)ctx->vtable_tpi;
  62   if (tpi && tpi->vaCreateSurfaceFromCIFrame) {
  63       return tpi->vaCreateSurfaceFromCIFrame( ctx, frame_id, surface );
  64   } else
  65       return VA_STATUS_ERROR_UNIMPLEMENTED;
  66
  67 }
  68
  69 /* Wrap a V4L2 buffer as a VA surface, so that V4L2 camera, VA encode
  70  * can share the data without copy
  71  * The VA driver should query the camera device from v4l2_fd to see
  72  * if camera device memory/buffer can be wrapped into a VA surface
  73  * Buffer information is passed in by v4l2_fmt and v4l2_buf structure,
  74  * VA driver also needs do further check if the buffer can meet encode
  75  * hardware requirement, such as dimension, fourcc, stride, etc
  76  *
  77  * Application should make sure the buffer is idle before the frame into VA stack
  78  * and also a vaSyncSurface should be called before application tries to access the frame
  79  * from V4L2 stack
  80  */
  81 VAStatus vaCreateSurfaceFromV4L2Buf(
  82     VADisplay dpy,
  83     int v4l2_fd,         /* file descriptor of V4L2 device */
  84     struct v4l2_format *v4l2_fmt,       /* format of V4L2 */
  85     struct v4l2_buffer *v4l2_buf,       /* V4L2 buffer */
  86     VASurfaceID *surface               /* out */
  87 )
  88 {
  89   VADriverContextP ctx;
  90   struct VADriverVTableTPI *tpi;
  91   CHECK_DISPLAY(dpy);
  92   ctx = CTX(dpy);
  93
  94   tpi = ( struct VADriverVTableTPI *)ctx->vtable_tpi;
  95   if (tpi && tpi->vaCreateSurfaceFromV4L2Buf) {
  96       return tpi->vaCreateSurfaceFromV4L2Buf( ctx, v4l2_fd, v4l2_fmt, v4l2_buf, surface );
  97   } else
  98       return VA_STATUS_ERROR_UNIMPLEMENTED;
  99 }
 100
 101
 102 /*
 103  * The surfaces could be shared and accessed with extern devices
 104  * which has special requirements, e.g. stride alignment
 105  * This API is used to force libVA video surfaces are allocated
 106  * according to these external requirements
 107  * Special API for V4L2 user pointer support
 108  */
 109 VAStatus vaCreateSurfacesForUserPtr(
 110     VADisplay dpy,
 111     int width,
 112     int height,
 113     int format,
 114     int num_surfaces,
 115     VASurfaceID *surfaces,       /* out */
 116     unsigned size, /* total buffer size need to be allocated */
 117     unsigned int fourcc, /* expected fourcc */
 118     unsigned int luma_stride, /* luma stride, could be width aligned with a special value */
 119     unsigned int chroma_u_stride, /* chroma stride */
 120     unsigned int chroma_v_stride,
 121     unsigned int luma_offset, /* could be 0 */
 122     unsigned int chroma_u_offset, /* UV offset from the beginning of the memory */
 123     unsigned int chroma_v_offset
 124 )
 125 {
 126   VADriverContextP ctx;
 127   struct VADriverVTableTPI *tpi;
 128   CHECK_DISPLAY(dpy);
 129   ctx = CTX(dpy);
 130
 131   tpi = (struct VADriverVTableTPI *)ctx->vtable_tpi;
 132   if (tpi && tpi->vaCreateSurfacesForUserPtr) {
 133       return tpi->vaCreateSurfacesForUserPtr( ctx, width, height, format, num_surfaces,
 134                                               surfaces,size, fourcc, luma_stride, chroma_u_stride,
 135                                               chroma_v_stride, luma_offset, chroma_u_offset, chroma_v_offset );
 136   } else
 137       return VA_STATUS_ERROR_UNIMPLEMENTED;
 138 }
 139
 140 /*
 141  * Create surface from the Kernel buffer
 142  */
 143 VAStatus vaCreateSurfaceFromKBuf(
 144     VADisplay dpy,
 145     int width,
 146     int height,
 147     int format,
 148     VASurfaceID *surface,       /* out */
 149     unsigned int kbuf_handle, /* kernel buffer handle*/
 150     unsigned size, /* kernel buffer size */
 151     unsigned int kBuf_fourcc, /* expected fourcc */
 152     unsigned int luma_stride, /* luma stride, could be width aligned with a special value */
 153     unsigned int chroma_u_stride, /* chroma stride */
 154     unsigned int chroma_v_stride,
 155     unsigned int luma_offset, /* could be 0 */
 156     unsigned int chroma_u_offset, /* UV offset from the beginning of the memory */
 157     unsigned int chroma_v_offset
 158 )
 159 {
 160   VADriverContextP ctx;
 161   struct VADriverVTableTPI *tpi;
 162   CHECK_DISPLAY(dpy);
 163   ctx = CTX(dpy);
 164
 165   tpi = (struct VADriverVTableTPI *)ctx->vtable_tpi;
 166   if (tpi && tpi->vaCreateSurfaceFromKBuf) {
 167       return tpi->vaCreateSurfaceFromKBuf( ctx, width, height, format, surface, kbuf_handle,
 168                                               size, kBuf_fourcc, luma_stride, chroma_u_stride,
 169                                               chroma_v_stride, luma_offset, chroma_u_offset, chroma_v_offset );
 170   } else
 171       return VA_STATUS_ERROR_UNIMPLEMENTED;
 172 }
 173
 174
 175 VAStatus vaPutSurfaceBuf (
 176     VADisplay dpy,
 177     VASurfaceID surface,
 178     unsigned char* data,
 179     int* data_len,
 180     short srcx,
 181     short srcy,
 182     unsigned short srcw,
 183     unsigned short srch,
 184     short destx,
 185     short desty,
 186     unsigned short destw,
 187     unsigned short desth,
 188     VARectangle *cliprects, /* client supplied clip list */
 189     unsigned int number_cliprects, /* number of clip rects in the clip list */
 190     unsigned int flags /* de-interlacing flags */
 191 )
 192 {
 193   VADriverContextP ctx;
 194   struct VADriverVTableTPI *tpi;
 195   CHECK_DISPLAY(dpy);
 196   ctx = CTX(dpy);
 197
 198   tpi = ( struct VADriverVTableTPI *)ctx->vtable_tpi;
 199   if (tpi && tpi->vaPutSurfaceBuf) {
 200       return tpi->vaPutSurfaceBuf( ctx, surface, data, data_len, srcx, srcy, srcw, srch,
 201                                       destx, desty, destw, desth, cliprects, number_cliprects, flags );
 202   } else
 203       return VA_STATUS_ERROR_UNIMPLEMENTED;
 204 }