mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-12-26 02:00:33 +00:00
Code Issues 1 Projects Releases Wiki Activity
gstreamer/gst-libs/gst/vaapi/gstvaapisurfaceproxy.h

151 lines
4.7 KiB
C
Raw Normal View History

Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
/*
* gstvaapisurfaceproxy.h - VA surface proxy
*
legal: fix copyright notices to include "Copyright" term.
2012-01-16 09:41:10 +00:00
* Copyright (C) 2010-2011 Splitted-Desktop Systems
legal: add per-file authorship information. Credit original authors on a per-file basis as we cannot expect people to know all country-specific rules, or bother browsing through the git history.
2013-11-22 04:57:18 +00:00
* Author: Gwenole Beauchesne <gwenole.beauchesne@splitted-desktop.com>
legal: update copyright notice dates.
2013-11-22 05:37:12 +00:00
* Copyright (C) 2011-2013 Intel Corporation
legal: add per-file authorship information. Credit original authors on a per-file basis as we cannot expect people to know all country-specific rules, or bother browsing through the git history.
2013-11-22 04:57:18 +00:00
* Author: Gwenole Beauchesne <gwenole.beauchesne@intel.com>
Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
*
Relicense gst-libs/ code to LGPL v2.1+.
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.
Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
*
Relicense gst-libs/ code to LGPL v2.1+.
2010-05-03 07:07:27 +00:00
* This library is distributed in the hope that it will be useful,
Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
* but WITHOUT ANY WARRANTY; without even the implied warranty of
Relicense gst-libs/ code to LGPL v2.1+.
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.
Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
*
Relicense gst-libs/ code to LGPL v2.1+.
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
Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
*/
#ifndef GST_VAAPI_SURFACE_PROXY_H
#define GST_VAAPI_SURFACE_PROXY_H
#include <gst/vaapi/gstvaapisurface.h>
decoder: simplify acquisition/release of spare surface. Introduce gst_vaapi_surface_proxy_new_from_pool() to allocate a new surface proxy from the context surface pool. This change also makes sure to retain the parent surface pool in the proxy. Besides, it was also totally useless to attach/detach parent context to VA surface each time we acquire/release it. Since the whole context owns all associated VA surfaces, we can mark this as such only once and for all.
2013-04-03 09:37:44 +00:00
#include <gst/vaapi/gstvaapisurfacepool.h>
Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
G_BEGIN_DECLS
surfaceproxy: add more attributes for raw decoding modes. Add more attributes for raw decoding modes, i.e. directly through the libgstvaapi helper library. In particular, add presentation timestamp, duration and a couple of flags (interlaced, TFF, RFF, one-field).
2013-04-16 16:35:48 +00:00
/**
* GstVaapiSurfaceProxyFlags:
* @GST_VAAPI_SURFACE_PROXY_FLAG_INTERLACED: interlaced frame
* @GST_VAAPI_SURFACE_PROXY_FLAG_TFF: top-field-first
decoder: h264: add initial support for repeat-first-field (RFF) flag. Use the SEI pic_timing() message to track and propagate down the repeat first field (RFF) flag. This is only initial support as there is one other condition that could induce the RFF flag, which is not handled yet.
2014-11-13 14:13:24 +00:00
* @GST_VAAPI_SURFACE_PROXY_FLAG_RFF: repeat-first-field
surfaceproxy: add more attributes for raw decoding modes. Add more attributes for raw decoding modes, i.e. directly through the libgstvaapi helper library. In particular, add presentation timestamp, duration and a couple of flags (interlaced, TFF, RFF, one-field).
2013-04-16 16:35:48 +00:00
* @GST_VAAPI_SURFACE_PROXY_FLAG_ONEFIELD: only one field is available
decoder: propagate MVC metadata ("view-id", head of multiview set). Add new GstVaapiSurfaceProxy flag FFB, which means "first frame in bundle", and really expresses the first view component of a multi view coded frame. e.g. in H.264 MVC, the surface proxy has flag FFB set if VOIdx = 0. Likewise, new API is exposed to retrieve the associated "view-id".
2014-06-30 17:01:35 +00:00
* @GST_VAAPI_SURFACE_PROXY_FLAG_FFB: first frame in bundle, e.g. the first
* view component of a MultiView Coded (MVC) frame
surfaceproxy: add more attributes for raw decoding modes. Add more attributes for raw decoding modes, i.e. directly through the libgstvaapi helper library. In particular, add presentation timestamp, duration and a couple of flags (interlaced, TFF, RFF, one-field).
2013-04-16 16:35:48 +00:00
* @GST_VAAPI_SURFACE_PROXY_FLAG_LAST: first flag that can be used by subclasses
*
* Flags for #GstVaapiDecoderFrame.
*/
typedef enum {
GST_VAAPI_SURFACE_PROXY_FLAG_INTERLACED = (1 << 0),
GST_VAAPI_SURFACE_PROXY_FLAG_TFF = (1 << 1),
GST_VAAPI_SURFACE_PROXY_FLAG_RFF = (1 << 2),
GST_VAAPI_SURFACE_PROXY_FLAG_ONEFIELD = (1 << 3),
decoder: propagate MVC metadata ("view-id", head of multiview set). Add new GstVaapiSurfaceProxy flag FFB, which means "first frame in bundle", and really expresses the first view component of a multi view coded frame. e.g. in H.264 MVC, the surface proxy has flag FFB set if VOIdx = 0. Likewise, new API is exposed to retrieve the associated "view-id".
2014-06-30 17:01:35 +00:00
GST_VAAPI_SURFACE_PROXY_FLAG_FFB = (1 << 4),
surfaceproxy: add more attributes for raw decoding modes. Add more attributes for raw decoding modes, i.e. directly through the libgstvaapi helper library. In particular, add presentation timestamp, duration and a couple of flags (interlaced, TFF, RFF, one-field).
2013-04-16 16:35:48 +00:00
GST_VAAPI_SURFACE_PROXY_FLAG_LAST = (1 << 8)
} GstVaapiSurfaceProxyFlags;
Add timestamps to GstVaapiSurfaceProxy.
2010-04-29 12:52:27 +00:00
/**
* GST_VAAPI_SURFACE_PROXY_SURFACE:
surfaceproxy: add more attributes for raw decoding modes. Add more attributes for raw decoding modes, i.e. directly through the libgstvaapi helper library. In particular, add presentation timestamp, duration and a couple of flags (interlaced, TFF, RFF, one-field).
2013-04-16 16:35:48 +00:00
* @proxy: a #GstVaapiSurfaceProxy
*
* Macro that evaluates to the #GstVaapiSurface of @proxy.
*/
#define GST_VAAPI_SURFACE_PROXY_SURFACE(proxy) \
gst_vaapi_surface_proxy_get_surface(proxy)
/**
* GST_VAAPI_SURFACE_PROXY_SURFACE_ID:
* @proxy: a #GstVaapiSurfaceProxy
Add timestamps to GstVaapiSurfaceProxy.
2010-04-29 12:52:27 +00:00
*
surfaceproxy: add more attributes for raw decoding modes. Add more attributes for raw decoding modes, i.e. directly through the libgstvaapi helper library. In particular, add presentation timestamp, duration and a couple of flags (interlaced, TFF, RFF, one-field).
2013-04-16 16:35:48 +00:00
* Macro that evaluates to the VA surface ID of the underlying @proxy
* surface.
Add timestamps to GstVaapiSurfaceProxy.
2010-04-29 12:52:27 +00:00
*/
surfaceproxy: add more attributes for raw decoding modes. Add more attributes for raw decoding modes, i.e. directly through the libgstvaapi helper library. In particular, add presentation timestamp, duration and a couple of flags (interlaced, TFF, RFF, one-field).
2013-04-16 16:35:48 +00:00
#define GST_VAAPI_SURFACE_PROXY_SURFACE_ID(proxy) \
gst_vaapi_surface_proxy_get_surface_id(proxy)
decoder: propagate MVC metadata ("view-id", head of multiview set). Add new GstVaapiSurfaceProxy flag FFB, which means "first frame in bundle", and really expresses the first view component of a multi view coded frame. e.g. in H.264 MVC, the surface proxy has flag FFB set if VOIdx = 0. Likewise, new API is exposed to retrieve the associated "view-id".
2014-06-30 17:01:35 +00:00
/**
* GST_VAAPI_SURFACE_PROXY_VIEW_ID:
* @proxy: a #GstVaapiSurfaceProxy
*
* Macro that evaluates to the decoded view ID of the underlying @proxy
* surface.
*/
#define GST_VAAPI_SURFACE_PROXY_VIEW_ID(proxy) \
gst_vaapi_surface_proxy_get_view_id(proxy)
surfaceproxy: add more attributes for raw decoding modes. Add more attributes for raw decoding modes, i.e. directly through the libgstvaapi helper library. In particular, add presentation timestamp, duration and a couple of flags (interlaced, TFF, RFF, one-field).
2013-04-16 16:35:48 +00:00
/**
* GST_VAAPI_SURFACE_PROXY_TIMESTAMP:
* @proxy: a #GstVaapiSurfaceProxy
*
* Macro that evaluates to the presentation timestamp of the
* underlying @proxy surface.
*/
#define GST_VAAPI_SURFACE_PROXY_TIMESTAMP(proxy) \
gst_vaapi_surface_proxy_get_timestamp(proxy)
/**
* GST_VAAPI_SURFACE_PROXY_DURATION:
* @proxy: a #GstVaapiSurfaceProxy
*
* Macro that evaluates to the presentation duration of the
* underlying @proxy surface.
*/
#define GST_VAAPI_SURFACE_PROXY_DURATION(proxy) \
gst_vaapi_surface_proxy_get_duration(proxy)
Add timestamps to GstVaapiSurfaceProxy.
2010-04-29 12:52:27 +00:00
decoder: simplify acquisition/release of spare surface. Introduce gst_vaapi_surface_proxy_new_from_pool() to allocate a new surface proxy from the context surface pool. This change also makes sure to retain the parent surface pool in the proxy. Besides, it was also totally useless to attach/detach parent context to VA surface each time we acquire/release it. Since the whole context owns all associated VA surfaces, we can mark this as such only once and for all.
2013-04-03 09:37:44 +00:00
GstVaapiSurfaceProxy *
gst_vaapi_surface_proxy_new_from_pool(GstVaapiSurfacePool *pool);
surfaceproxy: add copy function. Add gst_vaapi_surface_proxy_copy() function that creates a new surface proxy with the same information from the parent proxy, except that the user-defined destroy notify function is not copied over. The underlying VA surface is pushed back to the video pool only when the last reference to the parent surface proxy is released.
2013-11-28 16:25:05 +00:00
GstVaapiSurfaceProxy *
gst_vaapi_surface_proxy_copy(GstVaapiSurfaceProxy *proxy);
surfaceproxy: port to GstVaapiMiniObject. GstVaapiSurfaceProxy does not use any particular functionality from GObject. Actually, it only needs a basic object type with reference counting. This is an API and ABI change.
2012-12-03 12:46:28 +00:00
GstVaapiSurfaceProxy *
gst_vaapi_surface_proxy_ref(GstVaapiSurfaceProxy *proxy);
Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
surfaceproxy: port to GstVaapiMiniObject. GstVaapiSurfaceProxy does not use any particular functionality from GObject. Actually, it only needs a basic object type with reference counting. This is an API and ABI change.
2012-12-03 12:46:28 +00:00
void
gst_vaapi_surface_proxy_unref(GstVaapiSurfaceProxy *proxy);
Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
surfaceproxy: port to GstVaapiMiniObject. GstVaapiSurfaceProxy does not use any particular functionality from GObject. Actually, it only needs a basic object type with reference counting. This is an API and ABI change.
2012-12-03 12:46:28 +00:00
void
gst_vaapi_surface_proxy_replace(GstVaapiSurfaceProxy **old_proxy_ptr,
GstVaapiSurfaceProxy *new_proxy);
Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
surfaceproxy: add more attributes for raw decoding modes. Add more attributes for raw decoding modes, i.e. directly through the libgstvaapi helper library. In particular, add presentation timestamp, duration and a couple of flags (interlaced, TFF, RFF, one-field).
2013-04-16 16:35:48 +00:00
guint
gst_vaapi_surface_proxy_get_flags(GstVaapiSurfaceProxy *proxy);
Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
GstVaapiSurface *
gst_vaapi_surface_proxy_get_surface(GstVaapiSurfaceProxy *proxy);
surfaceproxy: add helper to retrieve the VA surface ID.
2012-01-05 15:59:57 +00:00
GstVaapiID
gst_vaapi_surface_proxy_get_surface_id(GstVaapiSurfaceProxy *proxy);
decoder: propagate MVC metadata ("view-id", head of multiview set). Add new GstVaapiSurfaceProxy flag FFB, which means "first frame in bundle", and really expresses the first view component of a multi view coded frame. e.g. in H.264 MVC, the surface proxy has flag FFB set if VOIdx = 0. Likewise, new API is exposed to retrieve the associated "view-id".
2014-06-30 17:01:35 +00:00
guintptr
gst_vaapi_surface_proxy_get_view_id(GstVaapiSurfaceProxy *proxy);
surfaceproxy: add more attributes for raw decoding modes. Add more attributes for raw decoding modes, i.e. directly through the libgstvaapi helper library. In particular, add presentation timestamp, duration and a couple of flags (interlaced, TFF, RFF, one-field).
2013-04-16 16:35:48 +00:00
GstClockTime
gst_vaapi_surface_proxy_get_timestamp(GstVaapiSurfaceProxy *proxy);
GstClockTime
gst_vaapi_surface_proxy_get_duration(GstVaapiSurfaceProxy *proxy);
surfaceproxy: drop user-data support from GstVaapiSurfaceProxy. Drop user-data support from GstVaapiSurfaceProxy. Rather make it explicit to call some user-provided function when the surface proxy is released.
2013-04-16 11:48:00 +00:00
void
gst_vaapi_surface_proxy_set_destroy_notify(GstVaapiSurfaceProxy *proxy,
GDestroyNotify destroy_func, gpointer user_data);
decoder: add support for video cropping. Add gst_vaapi_picture_set_crop_rect() helper function to copy the video cropping information from raw bitstreams to each picture being decoded. Also add helper function to surface proxy to propagate that information outside of libgstvaapi. e.g. plug-in elements or standalone applications. Signed-off-by: Sreerenj Balachandran <sreerenj.balachandran@intel.com> Signed-off-by: Gwenole Beauchesne <gwenole.beauchesne@intel.com>
2013-02-15 16:42:12 +00:00
const GstVaapiRectangle *
gst_vaapi_surface_proxy_get_crop_rect(GstVaapiSurfaceProxy *proxy);
void
gst_vaapi_surface_proxy_set_crop_rect(GstVaapiSurfaceProxy *proxy,
const GstVaapiRectangle *crop_rect);
Add surface proxy that holds a reference to the parent surface and that returns the surface to that context on destruction.
2010-04-23 16:00:50 +00:00
G_END_DECLS
#endif /* GST_VAAPI_SURFACE_PROXY_H */
Reference in a new issue Copy permalink