2018-02-13 21:41:28 +00:00
|
|
|
/* GStreamer Intel MSDK plugin
|
|
|
|
* Copyright (c) 2018, Intel Corporation
|
|
|
|
* Copyright (c) 2018, Igalia S.L.
|
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions are met:
|
|
|
|
*
|
|
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
|
|
* this list of conditions and the following disclaimer.
|
|
|
|
*
|
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
|
|
* and/or other materials provided with the distribution.
|
|
|
|
*
|
|
|
|
* 3. Neither the name of the copyright holder nor the names of its contributors
|
|
|
|
* may be used to endorse or promote products derived from this software
|
|
|
|
* without specific prior written permission.
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
|
|
|
|
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
|
|
|
|
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
|
|
|
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
|
|
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
|
|
|
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
|
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGDECE
|
|
|
|
* OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
|
|
|
|
* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef GST_MSDK_CONTEXT_H
|
|
|
|
#define GST_MSDK_CONTEXT_H
|
|
|
|
|
|
|
|
#include "msdk.h"
|
|
|
|
#ifndef _WIN32
|
|
|
|
#include <va/va.h>
|
|
|
|
#endif
|
|
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
|
|
#define GST_TYPE_MSDK_CONTEXT \
|
|
|
|
(gst_msdk_context_get_type ())
|
|
|
|
#define GST_MSDK_CONTEXT(obj) \
|
|
|
|
(G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_MSDK_CONTEXT, \
|
|
|
|
GstMsdkContext))
|
|
|
|
#define GST_MSDK_CONTEXT_CLASS(klass) \
|
|
|
|
(G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_MSDK_CONTEXT, \
|
|
|
|
GstMsdkContextClass))
|
|
|
|
#define GST_IS_MSDK_CONTEXT(obj) \
|
|
|
|
(G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_MSDK_CONTEXT))
|
|
|
|
#define GST_IS_MSDK_CONTEXT_CLASS(klass) \
|
|
|
|
(G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_MSDK_CONTEXT))
|
|
|
|
#define GST_MSDK_CONTEXT_CAST(obj) ((GstMsdkContext*)(obj))
|
|
|
|
|
|
|
|
typedef struct _GstMsdkContext GstMsdkContext;
|
|
|
|
typedef struct _GstMsdkContextClass GstMsdkContextClass;
|
|
|
|
typedef struct _GstMsdkContextPrivate GstMsdkContextPrivate;
|
|
|
|
|
2018-02-13 22:50:48 +00:00
|
|
|
typedef enum {
|
|
|
|
GST_MSDK_JOB_DECODER = 0x01,
|
|
|
|
GST_MSDK_JOB_ENCODER = 0x02,
|
|
|
|
GST_MSDK_JOB_VPP = 0x04,
|
|
|
|
} GstMsdkContextJobType;
|
|
|
|
|
2018-02-13 21:41:28 +00:00
|
|
|
/*
|
|
|
|
* GstMsdkContext:
|
|
|
|
*/
|
|
|
|
struct _GstMsdkContext
|
|
|
|
{
|
|
|
|
GstObject parent_instance;
|
|
|
|
|
|
|
|
GstMsdkContextPrivate *priv;
|
|
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
|
|
* GstMsdkContextClass:
|
|
|
|
*/
|
|
|
|
struct _GstMsdkContextClass
|
|
|
|
{
|
|
|
|
GstObjectClass parent_class;
|
|
|
|
};
|
|
|
|
|
|
|
|
GType gst_msdk_context_get_type (void);
|
|
|
|
|
2018-02-13 22:50:48 +00:00
|
|
|
GstMsdkContext * gst_msdk_context_new (gboolean hardware, GstMsdkContextJobType job_type);
|
|
|
|
GstMsdkContext * gst_msdk_context_new_with_parent (GstMsdkContext * parent);
|
2018-02-13 21:41:28 +00:00
|
|
|
mfxSession gst_msdk_context_get_session (GstMsdkContext * context);
|
|
|
|
|
|
|
|
gpointer gst_msdk_context_get_handle (GstMsdkContext * context);
|
|
|
|
gint gst_msdk_context_get_fd (GstMsdkContext * context);
|
|
|
|
|
2018-02-13 21:43:42 +00:00
|
|
|
/* GstMsdkContext contains mfxFrameAllocResponses,
|
|
|
|
* if app calls MFXVideoCORE_SetFrameAllocator.
|
|
|
|
*/
|
|
|
|
typedef struct _GstMsdkAllocResponse GstMsdkAllocResponse;
|
|
|
|
|
|
|
|
struct _GstMsdkAllocResponse {
|
2019-09-09 05:40:53 +00:00
|
|
|
gint refcount;
|
2019-09-11 02:49:10 +00:00
|
|
|
mfxFrameAllocResponse response;
|
2018-02-13 21:43:42 +00:00
|
|
|
mfxFrameAllocRequest request;
|
msdk: manage MSDK surfaces seperately
Currently a gst buffer has one mfxFrameSurface when it's allocated and
can't be changed.
This is based on that the life of gst buffer and mfxFrameSurface would
be same.
But it's not true. Sometimes even if a gst buffer of a frame is finished
on downstream,
mfxFramesurface coupled with the gst buffer is still locked, which means
it's still being used in the driver.
So this patch does this.
Every time a gst buffer is acquired from the pool, it confirms if the
surface coupled with the buffer is unlocked.
If not, replace it with new unlocked one.
In this way, user(decoder or encoder) doesn't need to manage gst buffers
including locked surface.
To do that, this patch includes the following:
1. GstMsdkContext
- Manages MSDK surfaces available, used, locked respectively as the
following:
1\ surfaces_avail : surfaces which are free and unused anywhere
2\ surfaces_used : surfaces coupled with a gst buffer and being used
now.
3\ surfaces_locked : surfaces still locked even after the gst buffer
is released.
- Provide an api to get MSDK surface available.
- Provide an api to release MSDK surface.
2. GstMsdkVideoMemory
- Gets a surface available when it's allocated.
- Provide an api to get an available surface with new unlocked one.
- Provide an api to release surface in the msdk video memory.
3. GstMsdkBufferPool
- In acquire_buffer, every time a gst buffer is acquired, get new
available surface from the list.
- In release_buffer, it confirms if the buffer's surface is unlocked or
not.
- If unlocked, it is put to the available list.
- If still locked, it is put to the locked list.
This also fixes bug #793525.
https://bugzilla.gnome.org/show_bug.cgi?id=793413
https://bugzilla.gnome.org/show_bug.cgi?id=793525
2018-03-08 20:37:12 +00:00
|
|
|
GList *surfaces_avail;
|
|
|
|
GList *surfaces_used;
|
|
|
|
GList *surfaces_locked;
|
2018-02-13 21:43:42 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
GstMsdkAllocResponse *
|
|
|
|
gst_msdk_context_get_cached_alloc_responses (GstMsdkContext * context,
|
|
|
|
mfxFrameAllocResponse * resp);
|
|
|
|
|
|
|
|
GstMsdkAllocResponse *
|
|
|
|
gst_msdk_context_get_cached_alloc_responses_by_request (GstMsdkContext * context,
|
|
|
|
mfxFrameAllocRequest * req);
|
|
|
|
|
|
|
|
void
|
|
|
|
gst_msdk_context_add_alloc_response (GstMsdkContext * context,
|
|
|
|
GstMsdkAllocResponse * resp);
|
|
|
|
|
|
|
|
gboolean
|
|
|
|
gst_msdk_context_remove_alloc_response (GstMsdkContext * context,
|
|
|
|
mfxFrameAllocResponse * resp);
|
|
|
|
|
msdk: manage MSDK surfaces seperately
Currently a gst buffer has one mfxFrameSurface when it's allocated and
can't be changed.
This is based on that the life of gst buffer and mfxFrameSurface would
be same.
But it's not true. Sometimes even if a gst buffer of a frame is finished
on downstream,
mfxFramesurface coupled with the gst buffer is still locked, which means
it's still being used in the driver.
So this patch does this.
Every time a gst buffer is acquired from the pool, it confirms if the
surface coupled with the buffer is unlocked.
If not, replace it with new unlocked one.
In this way, user(decoder or encoder) doesn't need to manage gst buffers
including locked surface.
To do that, this patch includes the following:
1. GstMsdkContext
- Manages MSDK surfaces available, used, locked respectively as the
following:
1\ surfaces_avail : surfaces which are free and unused anywhere
2\ surfaces_used : surfaces coupled with a gst buffer and being used
now.
3\ surfaces_locked : surfaces still locked even after the gst buffer
is released.
- Provide an api to get MSDK surface available.
- Provide an api to release MSDK surface.
2. GstMsdkVideoMemory
- Gets a surface available when it's allocated.
- Provide an api to get an available surface with new unlocked one.
- Provide an api to release surface in the msdk video memory.
3. GstMsdkBufferPool
- In acquire_buffer, every time a gst buffer is acquired, get new
available surface from the list.
- In release_buffer, it confirms if the buffer's surface is unlocked or
not.
- If unlocked, it is put to the available list.
- If still locked, it is put to the locked list.
This also fixes bug #793525.
https://bugzilla.gnome.org/show_bug.cgi?id=793413
https://bugzilla.gnome.org/show_bug.cgi?id=793525
2018-03-08 20:37:12 +00:00
|
|
|
mfxFrameSurface1 *
|
|
|
|
gst_msdk_context_get_surface_available (GstMsdkContext * context, mfxFrameAllocResponse * resp);
|
|
|
|
|
|
|
|
void
|
|
|
|
gst_msdk_context_put_surface_locked (GstMsdkContext * context, mfxFrameAllocResponse * resp, mfxFrameSurface1 * surface);
|
|
|
|
|
|
|
|
void
|
|
|
|
gst_msdk_context_put_surface_available (GstMsdkContext * context, mfxFrameAllocResponse * resp, mfxFrameSurface1 * surface);
|
|
|
|
|
2018-02-13 22:50:48 +00:00
|
|
|
GstMsdkContextJobType
|
|
|
|
gst_msdk_context_get_job_type (GstMsdkContext * context);
|
|
|
|
|
|
|
|
void
|
|
|
|
gst_msdk_context_add_job_type (GstMsdkContext * context, GstMsdkContextJobType job_type);
|
|
|
|
|
2018-02-13 22:52:14 +00:00
|
|
|
gint
|
|
|
|
gst_msdk_context_get_shared_async_depth (GstMsdkContext * context);
|
|
|
|
|
|
|
|
void
|
|
|
|
gst_msdk_context_add_shared_async_depth (GstMsdkContext * context, gint async_depth);
|
|
|
|
|
2018-12-29 05:56:49 +00:00
|
|
|
void
|
|
|
|
gst_msdk_context_set_frame_allocator (GstMsdkContext * context,
|
|
|
|
mfxFrameAllocator * allocator);
|
|
|
|
|
2018-02-13 21:41:28 +00:00
|
|
|
G_END_DECLS
|
|
|
|
|
|
|
|
#endif /* GST_MSDK_CONTEXT_H */
|