2 * Copyright (c) 2007-2009 Intel Corporation. All Rights Reserved.
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:
12 * The above copyright notice and this permission notice (including the
13 * next paragraph) shall be included in all copies or substantial portions
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.
25 /* Wrap a CI (camera imaging) frame as a VA surface to share captured video between camear
26 * and VA encode. With frame_id, VA driver need to call CI interfaces to get the information
27 * of the frame, and to determine if the frame can be wrapped as a VA surface
29 * Application should make sure the frame is idle before the frame is passed into VA stack
30 * and also a vaSyncSurface should be called before application tries to access the frame
39 VAStatus vaCreateSurfaceFromCIFrame (
41 unsigned long frame_id,
42 VASurfaceID *surface /* out */
45 VAStatus vaCreateSurfaceFromV4L2Buf(
47 int v4l2_fd, /* file descriptor of V4L2 device */
48 struct v4l2_format *v4l2_fmt, /* format of V4L2 */
49 struct v4l2_buffer *v4l2_buf, /* V4L2 buffer */
50 VASurfaceID *surface /* out */
53 VAStatus vaPutSurfaceBuf (
66 VARectangle *cliprects, /* client supplied clip list */
67 unsigned int number_cliprects, /* number of clip rects in the clip list */
68 unsigned int flags /* de-interlacing flags */
73 * The surfaces could be shared and accessed with extern devices
74 * which has special requirements, e.g. stride alignment
75 * This API is used to force libVA video surfaces are allocated
76 * according to these external requirements
77 * Special API for V4L2 user pointer support
79 VAStatus vaCreateSurfacesForUserPtr(
85 VASurfaceID *surfaces, /* out */
86 unsigned size, /* total buffer size need to be allocated */
87 unsigned int fourcc, /* expected fourcc */
88 unsigned int luma_stride, /* luma stride, could be width aligned with a special value */
89 unsigned int chroma_u_stride, /* chroma stride */
90 unsigned int chroma_v_stride,
91 unsigned int luma_offset, /* could be 0 */
92 unsigned int chroma_u_offset, /* UV offset from the beginning of the memory */
93 unsigned int chroma_v_offset
97 * Create surface from the Kernel buffer
99 VAStatus vaCreateSurfaceFromKBuf(
104 VASurfaceID *surface, /* out */
105 unsigned int kbuf_handle, /* kernel buffer handle*/
106 unsigned size, /* kernel buffer size */
107 unsigned int kBuf_fourcc, /* expected fourcc */
108 unsigned int luma_stride, /* luma stride, could be width aligned with a special value */
109 unsigned int chroma_u_stride, /* chroma stride */
110 unsigned int chroma_v_stride,
111 unsigned int luma_offset, /* could be 0 */
112 unsigned int chroma_u_offset, /* UV offset from the beginning of the memory */
113 unsigned int chroma_v_offset