2010-03-04 17:39:01 +00:00
|
|
|
/*
|
|
|
|
* gstvaapisurface.h - VA surface abstraction
|
|
|
|
*
|
2012-01-16 09:41:10 +00:00
|
|
|
* Copyright (C) 2010-2011 Splitted-Desktop Systems
|
2013-01-29 13:03:27 +00:00
|
|
|
* Copyright (C) 2011-2012 Intel Corporation
|
2010-03-04 17:39:01 +00:00
|
|
|
*
|
2010-05-03 07:07:27 +00:00
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public License
|
|
|
|
* as published by the Free Software Foundation; either version 2.1
|
|
|
|
* of the License, or (at your option) any later version.
|
2010-03-04 17:39:01 +00:00
|
|
|
*
|
2010-05-03 07:07:27 +00:00
|
|
|
* This library is distributed in the hope that it will be useful,
|
2010-03-04 17:39:01 +00:00
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
2010-05-03 07:07:27 +00:00
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
2010-03-04 17:39:01 +00:00
|
|
|
*
|
2010-05-03 07:07:27 +00:00
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
|
|
* License along with this library; if not, write to the Free
|
|
|
|
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
|
|
* Boston, MA 02110-1301 USA
|
2010-03-04 17:39:01 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef GST_VAAPI_SURFACE_H
|
|
|
|
#define GST_VAAPI_SURFACE_H
|
|
|
|
|
2010-03-23 16:21:28 +00:00
|
|
|
#include <gst/vaapi/gstvaapiobject.h>
|
2010-03-04 17:39:01 +00:00
|
|
|
#include <gst/vaapi/gstvaapidisplay.h>
|
2010-03-23 10:36:20 +00:00
|
|
|
#include <gst/vaapi/gstvaapiimage.h>
|
|
|
|
#include <gst/vaapi/gstvaapisubpicture.h>
|
2011-11-25 19:59:56 +00:00
|
|
|
#include <gst/video/video-overlay-composition.h>
|
2010-03-04 17:39:01 +00:00
|
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
2011-07-22 13:33:13 +00:00
|
|
|
/**
|
|
|
|
* GST_VAAPI_SURFACE_CAPS_NAME:
|
|
|
|
*
|
|
|
|
* Generic caps type for VA surfaces.
|
|
|
|
*/
|
2012-09-04 12:12:18 +00:00
|
|
|
#define GST_VAAPI_SURFACE_CAPS_NAME "video/x-surface"
|
2011-07-22 13:33:13 +00:00
|
|
|
|
2010-05-07 06:35:31 +00:00
|
|
|
/**
|
|
|
|
* GST_VAAPI_SURFACE_CAPS:
|
|
|
|
*
|
|
|
|
* Generic caps for VA surfaces.
|
|
|
|
*/
|
2011-11-04 21:16:23 +00:00
|
|
|
#define GST_VAAPI_SURFACE_CAPS \
|
|
|
|
GST_VAAPI_SURFACE_CAPS_NAME ", " \
|
|
|
|
"type = vaapi, " \
|
|
|
|
"opengl = (boolean) { true, false }, " \
|
|
|
|
"width = (int) [ 1, MAX ], " \
|
|
|
|
"height = (int) [ 1, MAX ], " \
|
2010-05-07 06:35:31 +00:00
|
|
|
"framerate = (fraction) [ 0, MAX ]"
|
|
|
|
|
2010-03-19 15:45:21 +00:00
|
|
|
/**
|
|
|
|
* GstVaapiChromaType:
|
|
|
|
* @GST_VAAPI_CHROMA_TYPE_YUV420: 4:2:0 chroma format
|
|
|
|
* @GST_VAAPI_CHROMA_TYPE_YUV422: 4:2:2 chroma format
|
|
|
|
* @GST_VAAPI_CHROMA_TYPE_YUV444: 4:4:4 chroma format
|
|
|
|
*
|
|
|
|
* The set of all chroma types for #GstVaapiSurface.
|
|
|
|
*/
|
2012-09-04 11:40:04 +00:00
|
|
|
typedef enum {
|
2010-03-11 13:58:32 +00:00
|
|
|
GST_VAAPI_CHROMA_TYPE_YUV420 = 1,
|
|
|
|
GST_VAAPI_CHROMA_TYPE_YUV422,
|
|
|
|
GST_VAAPI_CHROMA_TYPE_YUV444
|
2012-09-04 11:40:04 +00:00
|
|
|
} GstVaapiChromaType;
|
2010-03-11 13:58:32 +00:00
|
|
|
|
2010-03-30 08:11:50 +00:00
|
|
|
/**
|
|
|
|
* GstVaapiSurfaceStatus:
|
|
|
|
* @GST_VAAPI_SURFACE_STATUS_IDLE:
|
|
|
|
* the surface is not being rendered or displayed
|
|
|
|
* @GST_VAAPI_SURFACE_STATUS_RENDERING:
|
|
|
|
* the surface is used for rendering (decoding to the surface in progress)
|
|
|
|
* @GST_VAAPI_SURFACE_STATUS_DISPLAYING:
|
|
|
|
* the surface is being displayed to screen
|
|
|
|
* @GST_VAAPI_SURFACE_STATUS_SKIPPED:
|
|
|
|
* indicates a skipped frame during encode
|
|
|
|
*
|
|
|
|
* The set of all surface status for #GstVaapiSurface.
|
|
|
|
*/
|
2012-09-04 11:40:04 +00:00
|
|
|
typedef enum {
|
2010-03-30 08:11:50 +00:00
|
|
|
GST_VAAPI_SURFACE_STATUS_IDLE = 1 << 0,
|
|
|
|
GST_VAAPI_SURFACE_STATUS_RENDERING = 1 << 1,
|
|
|
|
GST_VAAPI_SURFACE_STATUS_DISPLAYING = 1 << 2,
|
|
|
|
GST_VAAPI_SURFACE_STATUS_SKIPPED = 1 << 3
|
2012-09-04 11:40:04 +00:00
|
|
|
} GstVaapiSurfaceStatus;
|
2010-03-30 08:11:50 +00:00
|
|
|
|
2010-03-21 08:22:46 +00:00
|
|
|
/**
|
|
|
|
* GstVaapiSurfaceRenderFlags
|
|
|
|
* @GST_VAAPI_PICTURE_STRUCTURE_TOP_FIELD:
|
|
|
|
* selects the top field of the surface
|
|
|
|
* @GST_VAAPI_PICTURE_STRUCTURE_BOTTOM_FIELD:
|
|
|
|
* selects the bottom field of the surface
|
|
|
|
* @GST_VAAPI_PICTURE_STRUCTURE_FRAME:
|
|
|
|
* selects the entire surface
|
|
|
|
* @GST_VAAPI_COLOR_STANDARD_ITUR_BT_601:
|
|
|
|
* uses ITU-R BT.601 standard for color space conversion
|
|
|
|
* @GST_VAAPI_COLOR_STANDARD_ITUR_BT_709:
|
|
|
|
* uses ITU-R BT.709 standard for color space conversion
|
|
|
|
*
|
|
|
|
* The set of all render flags for gst_vaapi_window_put_surface().
|
|
|
|
*/
|
2012-09-04 11:40:04 +00:00
|
|
|
typedef enum {
|
2010-03-21 08:22:46 +00:00
|
|
|
GST_VAAPI_PICTURE_STRUCTURE_TOP_FIELD = 1 << 0,
|
|
|
|
GST_VAAPI_PICTURE_STRUCTURE_BOTTOM_FIELD = 1 << 1,
|
|
|
|
GST_VAAPI_PICTURE_STRUCTURE_FRAME =
|
|
|
|
(
|
|
|
|
GST_VAAPI_PICTURE_STRUCTURE_TOP_FIELD |
|
|
|
|
GST_VAAPI_PICTURE_STRUCTURE_BOTTOM_FIELD
|
|
|
|
),
|
|
|
|
GST_VAAPI_COLOR_STANDARD_ITUR_BT_601 = 1 << 2,
|
|
|
|
GST_VAAPI_COLOR_STANDARD_ITUR_BT_709 = 1 << 3,
|
2012-09-04 11:40:04 +00:00
|
|
|
} GstVaapiSurfaceRenderFlags;
|
2010-03-21 08:22:46 +00:00
|
|
|
|
2013-04-30 15:22:15 +00:00
|
|
|
#define GST_VAAPI_SURFACE(obj) \
|
|
|
|
((GstVaapiSurface *)(obj))
|
2010-03-04 17:39:01 +00:00
|
|
|
|
|
|
|
typedef struct _GstVaapiSurface GstVaapiSurface;
|
2013-04-03 09:37:44 +00:00
|
|
|
typedef struct _GstVaapiSurfaceProxy GstVaapiSurfaceProxy;
|
2010-03-04 17:39:01 +00:00
|
|
|
|
|
|
|
GstVaapiSurface *
|
2010-03-11 13:58:32 +00:00
|
|
|
gst_vaapi_surface_new(
|
|
|
|
GstVaapiDisplay *display,
|
|
|
|
GstVaapiChromaType chroma_type,
|
|
|
|
guint width,
|
|
|
|
guint height
|
|
|
|
);
|
2010-03-04 17:39:01 +00:00
|
|
|
|
2010-03-30 07:39:16 +00:00
|
|
|
GstVaapiID
|
2010-03-25 09:49:17 +00:00
|
|
|
gst_vaapi_surface_get_id(GstVaapiSurface *surface);
|
|
|
|
|
2010-03-11 13:58:32 +00:00
|
|
|
GstVaapiChromaType
|
|
|
|
gst_vaapi_surface_get_chroma_type(GstVaapiSurface *surface);
|
|
|
|
|
2010-03-04 17:39:01 +00:00
|
|
|
guint
|
|
|
|
gst_vaapi_surface_get_width(GstVaapiSurface *surface);
|
|
|
|
|
|
|
|
guint
|
|
|
|
gst_vaapi_surface_get_height(GstVaapiSurface *surface);
|
|
|
|
|
2010-03-12 17:39:11 +00:00
|
|
|
void
|
|
|
|
gst_vaapi_surface_get_size(
|
|
|
|
GstVaapiSurface *surface,
|
|
|
|
guint *pwidth,
|
|
|
|
guint *pheight
|
|
|
|
);
|
|
|
|
|
2010-03-18 15:28:59 +00:00
|
|
|
GstVaapiImage *
|
|
|
|
gst_vaapi_surface_derive_image(GstVaapiSurface *surface);
|
|
|
|
|
2010-03-15 11:49:03 +00:00
|
|
|
gboolean
|
|
|
|
gst_vaapi_surface_get_image(GstVaapiSurface *surface, GstVaapiImage *image);
|
|
|
|
|
|
|
|
gboolean
|
|
|
|
gst_vaapi_surface_put_image(GstVaapiSurface *surface, GstVaapiImage *image);
|
|
|
|
|
2010-03-23 10:36:20 +00:00
|
|
|
gboolean
|
|
|
|
gst_vaapi_surface_associate_subpicture(
|
|
|
|
GstVaapiSurface *surface,
|
|
|
|
GstVaapiSubpicture *subpicture,
|
|
|
|
const GstVaapiRectangle *src_rect,
|
|
|
|
const GstVaapiRectangle *dst_rect
|
|
|
|
);
|
|
|
|
|
|
|
|
gboolean
|
|
|
|
gst_vaapi_surface_deassociate_subpicture(
|
|
|
|
GstVaapiSurface *surface,
|
|
|
|
GstVaapiSubpicture *subpicture
|
|
|
|
);
|
|
|
|
|
2010-03-15 16:13:51 +00:00
|
|
|
gboolean
|
|
|
|
gst_vaapi_surface_sync(GstVaapiSurface *surface);
|
|
|
|
|
2010-03-30 08:11:50 +00:00
|
|
|
gboolean
|
|
|
|
gst_vaapi_surface_query_status(
|
|
|
|
GstVaapiSurface *surface,
|
|
|
|
GstVaapiSurfaceStatus *pstatus
|
|
|
|
);
|
|
|
|
|
2011-11-25 19:59:56 +00:00
|
|
|
gboolean
|
2011-12-13 14:51:58 +00:00
|
|
|
gst_vaapi_surface_set_subpictures_from_composition(
|
2011-12-14 13:40:37 +00:00
|
|
|
GstVaapiSurface *surface,
|
|
|
|
GstVideoOverlayComposition *composition,
|
|
|
|
gboolean propagate_context
|
2011-11-25 19:59:56 +00:00
|
|
|
);
|
|
|
|
|
2010-03-04 17:39:01 +00:00
|
|
|
G_END_DECLS
|
|
|
|
|
|
|
|
#endif /* GST_VAAPI_SURFACE_H */
|