| GStreamer VA-API Plugins 0.10 Library Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | ||||
struct GstVaapiContext; struct GstVaapiContextClass; GstVaapiContext * gst_vaapi_context_new (GstVaapiDisplay *display,GstVaapiProfile profile,GstVaapiEntrypoint entrypoint,guint width,guint height); gboolean gst_vaapi_context_reset (GstVaapiContext *context,GstVaapiProfile profile,GstVaapiEntrypoint entrypoint,guint width,guint height); GstVaapiID gst_vaapi_context_get_id (GstVaapiContext *context); GstVaapiProfile gst_vaapi_context_get_profile (GstVaapiContext *context); gboolean gst_vaapi_context_set_profile (GstVaapiContext *context,GstVaapiProfile profile); GstVaapiEntrypoint gst_vaapi_context_get_entrypoint (GstVaapiContext *context); void gst_vaapi_context_get_size (GstVaapiContext *context,guint *pwidth,guint *pheight); GstVaapiSurface * gst_vaapi_context_get_surface (GstVaapiContext *context); guint gst_vaapi_context_get_surface_count (GstVaapiContext *context); void gst_vaapi_context_put_surface (GstVaapiContext *context,GstVaapiSurface *surface); GstVaapiSurface * gst_vaapi_context_find_surface_by_id (GstVaapiContext *context,GstVaapiID id); gboolean gst_vaapi_context_apply_composition (GstVaapiContext *context,GstVideoOverlayComposition *composition);
"entrypoint" guint : Read / Write / Construct Only "height" guint : Read / Write / Construct Only "profile" guint : Read / Write "ref-frames" guint : Read / Write / Construct Only "width" guint : Read / Write / Construct Only
GstVaapiContext * gst_vaapi_context_new (GstVaapiDisplay *display,GstVaapiProfile profile,GstVaapiEntrypoint entrypoint,guint width,guint height);
Creates a new GstVaapiContext with the specified codec profile
and entrypoint.
|
a GstVaapiDisplay |
|
a GstVaapiProfile |
|
a GstVaapiEntrypoint |
|
coded width from the bitstream |
|
coded height from the bitstream |
Returns : |
the newly allocated GstVaapiContext object |
gboolean gst_vaapi_context_reset (GstVaapiContext *context,GstVaapiProfile profile,GstVaapiEntrypoint entrypoint,guint width,guint height);
Resets context to the specified codec profile and entrypoint.
The surfaces will be reallocated if the coded size changed.
|
a GstVaapiContext |
|
a GstVaapiProfile |
|
a GstVaapiEntrypoint |
|
coded width from the bitstream |
|
coded height from the bitstream |
Returns : |
TRUE on success |
GstVaapiID gst_vaapi_context_get_id (GstVaapiContext *context);
Returns the underlying VAContextID of the context.
|
a GstVaapiContext |
Returns : |
the underlying VA context id |
GstVaapiProfile gst_vaapi_context_get_profile (GstVaapiContext *context);
Returns the VA profile used by the context.
|
a GstVaapiContext |
Returns : |
the VA profile used by the context
|
gboolean gst_vaapi_context_set_profile (GstVaapiContext *context,GstVaapiProfile profile);
Sets the new profile to use with the context. If profile matches
the previous profile, this call has no effect. Otherwise, the
underlying VA context is recreated, while keeping the previously
allocated surfaces.
|
a GstVaapiContext |
|
the new GstVaapiProfile to use |
Returns : |
TRUE on success |
GstVaapiEntrypoint gst_vaapi_context_get_entrypoint (GstVaapiContext *context);
Returns the VA entrypoint used by the context
|
a GstVaapiContext |
Returns : |
the VA entrypoint used by the context
|
void gst_vaapi_context_get_size (GstVaapiContext *context,guint *pwidth,guint *pheight);
Retrieves the size of the surfaces attached to context.
|
a GstVaapiContext |
|
return location for the width, or NULL
|
|
return location for the height, or NULL
|
GstVaapiSurface * gst_vaapi_context_get_surface (GstVaapiContext *context);
Acquires a free surface. The returned surface but be released with
gst_vaapi_context_put_surface(). This function returns NULL if
there is no free surface available in the pool. The surfaces are
pre-allocated during context creation though.
|
a GstVaapiContext |
Returns : |
a free surface, or NULL if none is available |
guint gst_vaapi_context_get_surface_count (GstVaapiContext *context);
Retrieves the number of free surfaces left in the pool.
|
a GstVaapiContext |
Returns : |
the number of free surfaces available in the pool |
void gst_vaapi_context_put_surface (GstVaapiContext *context,GstVaapiSurface *surface);
Releases a surface acquired by gst_vaapi_context_get_surface().
|
a GstVaapiContext |
|
the GstVaapiSurface to release |
GstVaapiSurface * gst_vaapi_context_find_surface_by_id (GstVaapiContext *context,GstVaapiID id);
Finds VA surface by id in the list of surfaces attached to the context.
|
a GstVaapiContext |
|
the VA surface id to find |
Returns : |
the matching GstVaapiSurface object, or NULL if
none was found |
gboolean gst_vaapi_context_apply_composition (GstVaapiContext *context,GstVideoOverlayComposition *composition);
Applies video composition planes to all surfaces bound to context.
This helper function resets any additional subpictures the user may
have associated himself. A NULL composition will also clear all
the existing subpictures.
|
a GstVaapiContext |
|
a GstVideoOverlayComposition |
Returns : |
TRUE if all composition planes could be applied,
FALSE otherwise |
"entrypoint" property"entrypoint" guint : Read / Write / Construct Only
The decoder entrypoint.
Default value: 0
"height" property"height" guint : Read / Write / Construct Only
The height of the decoded surfaces.
Allowed values: <= G_MAXLONG
Default value: 0
"profile" property"profile" guint : Read / Write
The profile used for decoding.
Default value: 0
"ref-frames" property"ref-frames" guint : Read / Write / Construct Only
The number of reference frames.
Allowed values: <= G_MAXLONG
Default value: 0
"width" property"width" guint : Read / Write / Construct Only
The width of decoded surfaces.
Allowed values: <= G_MAXLONG
Default value: 0