gstreamer/subprojects/gstreamer-vaapi/gst-libs/gst/vaapi/gstvaapitexture.h

175 lines
5.2 KiB
C
Raw Normal View History

/*
* gstvaapitexture.h - VA texture abstraction
*
* Copyright (C) 2010-2011 Splitted-Desktop Systems
* Author: Gwenole Beauchesne <gwenole.beauchesne@splitted-desktop.com>
2013-11-22 05:37:12 +00:00
* Copyright (C) 2012-2013 Intel Corporation
* Author: Gwenole Beauchesne <gwenole.beauchesne@intel.com>
*
* 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.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* 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
*/
#ifndef GST_VAAPI_TEXTURE_H
#define GST_VAAPI_TEXTURE_H
#include <gst/vaapi/gstvaapitypes.h>
#include <gst/vaapi/gstvaapisurface.h>
G_BEGIN_DECLS
#define GST_VAAPI_TEXTURE(obj) \
((GstVaapiTexture *)(obj))
#define GST_TYPE_VAAPI_TEXTURE (gst_vaapi_texture_get_type ())
/**
* GST_VAAPI_TEXTURE_DISPLAY:
* @texture: a #GstVaapiTexture
*
* Macro that evaluates to the display associated with the @texture
*/
#define GST_VAAPI_TEXTURE_DISPLAY(texture) \
gst_vaapi_texture_get_display (GST_VAAPI_TEXTURE (texture))
/**
* GST_VAAPI_TEXTURE_ID:
* @texture: a #GstVaapiTexture
*
* Macro that evaluates to the GL texture id associated with the @texture
*/
#define GST_VAAPI_TEXTURE_ID(texture) \
gst_vaapi_texture_get_id (GST_VAAPI_TEXTURE (texture))
/**
* GST_VAAPI_TEXTURE_TARGET:
* @texture: a #GstVaapiTexture
*
* Macro that evaluates to the GL texture target associated with the @texture
*/
#define GST_VAAPI_TEXTURE_TARGET(texture) \
gst_vaapi_texture_get_target (GST_VAAPI_TEXTURE (texture))
/**
* GST_VAAPI_TEXTURE_FORMAT:
* @texture: a #GstVaapiTexture
*
* Macro that evaluates to the GL texture format associated with the @texture
*/
#define GST_VAAPI_TEXTURE_FORMAT(texture) \
gst_vaapi_texture_get_format (GST_VAAPI_TEXTURE (texture))
/**
* GST_VAAPI_TEXTURE_WIDTH:
* @texture: a #GstVaapiTexture
*
* Macro that evaluates to the GL texture width associated with the @texture
*/
#define GST_VAAPI_TEXTURE_WIDTH(texture) \
gst_vaapi_texture_get_width (GST_VAAPI_TEXTURE (texture))
/**
* GST_VAAPI_TEXTURE_HEIGHT:
* @texture: a #GstVaapiTexture
*
* Macro that evaluates to the GL texture height associated with the @texture
*/
#define GST_VAAPI_TEXTURE_HEIGHT(texture) \
gst_vaapi_texture_get_height (GST_VAAPI_TEXTURE (texture))
typedef struct _GstVaapiTexture GstVaapiTexture;
/**
* GstVaapiTextureOrientationFlags:
* @GST_VAAPI_TEXTURE_ORIENTATION_FLAG_X_INVERTED: indicates whether
* the right row comes first in memory.
* @GST_VAAPI_TEXTURE_ORIENTATION_FLAG_Y_INVERTED: indicates whether
* the bottom line comes first in memory.
*
* Additional flags to indicate whether the texture data is organized
* in memory with the X or Y, or both, axis inverted. e.g. if only
* @GST_VAAPI_TEXTURE_ORIENTATION_FLAG_Y_INVERTED is set, this means
* that the bottom line comes first in memory, with pixels laid out
* from the left to the right.
*/
typedef enum {
GST_VAAPI_TEXTURE_ORIENTATION_FLAG_X_INVERTED = (GST_MINI_OBJECT_FLAG_LAST << 1),
GST_VAAPI_TEXTURE_ORIENTATION_FLAG_Y_INVERTED = (GST_MINI_OBJECT_FLAG_LAST << 2),
} GstVaapiTextureOrientationFlags;
GType
gst_vaapi_texture_get_type (void) G_GNUC_CONST;
/**
* gst_vaapi_texture_unref: (skip)
* @texture: (transfer full): a #GstVaapiTexture.
*
* Decreases the refcount of the texture. If the refcount reaches 0, the
* texture will be freed.
*/
static inline void
gst_vaapi_texture_unref (GstVaapiTexture * texture)
{
gst_mini_object_unref (GST_MINI_OBJECT_CAST (texture));
}
GstVaapiTexture *
gst_vaapi_texture_new (GstVaapiDisplay * display, guint target, guint format,
guint width, guint height);
GstVaapiTexture *
gst_vaapi_texture_new_wrapped (GstVaapiDisplay * display, guint id,
guint target, guint format, guint width, guint height);
guint
gst_vaapi_texture_get_id (GstVaapiTexture * texture);
GstVaapiDisplay *
gst_vaapi_texture_get_display (GstVaapiTexture * texture);
guint
gst_vaapi_texture_get_target (GstVaapiTexture * texture);
guint
gst_vaapi_texture_get_format (GstVaapiTexture * texture);
guint
gst_vaapi_texture_get_width (GstVaapiTexture * texture);
guint
gst_vaapi_texture_get_height (GstVaapiTexture * texture);
void
gst_vaapi_texture_get_size (GstVaapiTexture * texture, guint * width_ptr,
guint * height_ptr);
guint
gst_vaapi_texture_get_orientation_flags (GstVaapiTexture * texture);
void
gst_vaapi_texture_set_orientation_flags (GstVaapiTexture * texture,
guint flags);
gboolean
gst_vaapi_texture_put_surface (GstVaapiTexture * texture,
GstVaapiSurface * surface, const GstVaapiRectangle * crop_rect,
guint flags);
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GstVaapiTexture, gst_vaapi_texture_unref)
G_END_DECLS
#endif /* GST_VAAPI_TEXTURE_H */