mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-01 22:21:13 +00:00
ddce68a5c2
Make a new GstVideoFormatinfo structure that contains the specific information related to a format such as the number of planes, components, subsampling, pixel stride etc. The result is that we are now able to introduce the concept of components again in the API. Use tables to specify the formats and its properties. Use macros to get information about the video format description. Move code to set strides, offsets and size into one function. Remove methods that are not handled with the structures. Add methods to retrieve pointers and strides to the components in the video.
108 lines
3.7 KiB
C
108 lines
3.7 KiB
C
/* GStreamer
|
|
* Copyright (C) <2011> Wim Taymans <wim.taymans@gmail.com>
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 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
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#ifndef __GST_META_VIDEO_H__
|
|
#define __GST_META_VIDEO_H__
|
|
|
|
#include <gst/gst.h>
|
|
|
|
#include <gst/video/video.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GST_META_API_VIDEO "GstMetaVideo"
|
|
#define GST_META_INFO_VIDEO (gst_meta_video_get_info())
|
|
typedef struct _GstMetaVideo GstMetaVideo;
|
|
|
|
#define GST_META_API_VIDEO_CROP "GstMetaVideoCrop"
|
|
#define GST_META_INFO_VIDEO_CROP (gst_meta_video_crop_get_info())
|
|
typedef struct _GstMetaVideoCrop GstMetaVideoCrop;
|
|
|
|
/**
|
|
* GstMetaVideo:
|
|
* @meta: parent #GstMeta
|
|
* @flags: additional video flags
|
|
* @n_planes: the number of planes in the image
|
|
* @offset: array of offsets for the planes
|
|
* @stride: array of strides for the planes
|
|
* @map: map the memory of a plane
|
|
* @unmap: unmap the memory of a plane
|
|
*
|
|
* Extra buffer metadata describing image properties
|
|
*/
|
|
struct _GstMetaVideo {
|
|
GstMeta meta;
|
|
|
|
GstBuffer *buffer;
|
|
|
|
GstVideoFlags flags;
|
|
GstVideoFormat format;
|
|
guint width;
|
|
guint height;
|
|
|
|
guint n_planes;
|
|
gsize offset[GST_VIDEO_MAX_PLANES];
|
|
gint stride[GST_VIDEO_MAX_PLANES];
|
|
|
|
gpointer (*map) (GstMetaVideo *meta, guint plane, gint *stride,
|
|
GstMapFlags flags);
|
|
gboolean (*unmap) (GstMetaVideo *meta, guint plane, gpointer data);
|
|
};
|
|
|
|
const GstMetaInfo * gst_meta_video_get_info (void);
|
|
|
|
#define gst_buffer_get_meta_video(b) ((GstMetaVideo*)gst_buffer_get_meta((b),GST_META_INFO_VIDEO))
|
|
GstMetaVideo * gst_buffer_add_meta_video (GstBuffer *buffer, GstVideoFlags flags,
|
|
GstVideoFormat format, guint width, guint height);
|
|
GstMetaVideo * gst_buffer_add_meta_video_full (GstBuffer *buffer, GstVideoFlags flags,
|
|
GstVideoFormat format, guint width, guint height,
|
|
guint n_planes, gsize offset[GST_VIDEO_MAX_PLANES],
|
|
gint stride[GST_VIDEO_MAX_PLANES]);
|
|
|
|
gpointer gst_meta_video_map (GstMetaVideo *meta, guint plane, gint *stride,
|
|
GstMapFlags flags);
|
|
gboolean gst_meta_video_unmap (GstMetaVideo *meta, guint plane, gpointer data);
|
|
|
|
/**
|
|
* GstMetaVideoCrop:
|
|
* @meta: parent #GstMeta
|
|
* @x: the horizontal offset
|
|
* @y: the vertical offset
|
|
* @width: the cropped width
|
|
* @height: the cropped height
|
|
*
|
|
* Extra buffer metadata describing image cropping.
|
|
*/
|
|
struct _GstMetaVideoCrop {
|
|
GstMeta meta;
|
|
|
|
guint x;
|
|
guint y;
|
|
guint width;
|
|
guint height;
|
|
};
|
|
|
|
const GstMetaInfo * gst_meta_video_crop_get_info (void);
|
|
|
|
#define gst_buffer_get_meta_video_crop(b) ((GstMetaVideoCrop*)gst_buffer_get_meta((b),GST_META_INFO_VIDEO_CROP))
|
|
#define gst_buffer_add_meta_video_crop(b) ((GstMetaVideoCrop*)gst_buffer_add_meta((b),GST_META_INFO_VIDEO_CROP, NULL))
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GST_META_VIDEO_H__ */
|