mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-12-01 22:21:13 +00:00
Code Issues 1 Projects Releases Wiki Activity
gstreamer/subprojects/gst-plugins-base/gst-libs/gst/video/video.h

206 lines
6.8 KiB
C
Raw Normal View History

This adds a generic video functions library Original commit message from CVS: This adds a generic video functions library
2002-09-26 12:20:12 +00:00
/* GStreamer
audio: rework audio caps. Rework the audio caps similar to the video caps. Remove width/depth/endianness/signed fields and replace with a simple string format and media type audio/x-raw. Create a GstAudioInfo and some helper methods to parse caps. Remove duplicate code from the ringbuffer and replace with audio info. Use AudioInfo in the base audio filter class. Port elements to new API.
2011-08-18 17:15:03 +00:00
* Copyright (C) <2011> Wim Taymans <wim.taymans@gmail.com>
This adds a generic video functions library Original commit message from CVS: This adds a generic video functions library
2002-09-26 12:20:12 +00:00
*
* 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
Fix FSF address https://bugzilla.gnome.org/show_bug.cgi?id=687520
2012-11-03 23:05:09 +00:00
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
This adds a generic video functions library Original commit message from CVS: This adds a generic video functions library
2002-09-26 12:20:12 +00:00
*/
muhaha Original commit message from CVS: muhaha
2002-11-09 18:31:27 +00:00
#ifndef __GST_VIDEO_H__
#define __GST_VIDEO_H__
This adds a generic video functions library Original commit message from CVS: This adds a generic video functions library
2002-09-26 12:20:12 +00:00
#include <gst/gst.h>
video: expose gst_video_info_align Expose the gst_video_info_align function that adds padding and does stride alignment on a GstVideoInfo. Move this previously private function to video-info.co Move the definition of the alignment structure to video.h where it can be picked up by both the bufferpool and the video-info.
2012-08-20 08:50:59 +00:00
video: GST_EXPORT -> GST_VIDEO_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 11:48:31 +00:00
#include <gst/video/video-prelude.h>
video: expose gst_video_info_align Expose the gst_video_info_align function that adds padding and does stride alignment on a GstVideoInfo. Move this previously private function to video-info.co Move the definition of the alignment structure to video.h where it can be picked up by both the bufferpool and the video-info.
2012-08-20 08:50:59 +00:00
typedef struct _GstVideoAlignment GstVideoAlignment;
video: move methods into separate files Move different video functionalities into different files
2012-06-05 10:47:22 +00:00
#include <gst/video/video-format.h>
#include <gst/video/video-color.h>
video-dither: add video dither helper object Add a new object that implements various dithering methods.
2014-12-02 10:32:28 +00:00
#include <gst/video/video-dither.h>
video: move methods into separate files Move different video functionalities into different files
2012-06-05 10:47:22 +00:00
#include <gst/video/video-info.h>
#include <gst/video/video-frame.h>
gst-libs/gst/video/: Fix up build flags and include statement for the new generated enumtypes files, to fix dist. Original commit message from CVS: * gst-libs/gst/video/Makefile.am: * gst-libs/gst/video/video.h: Fix up build flags and include statement for the new generated enumtypes files, to fix dist.
2009-01-06 10:16:16 +00:00
#include <gst/video/video-enumtypes.h>
video: convertor -> converter
2014-09-24 14:19:30 +00:00
#include <gst/video/video-converter.h>
video-scaler: add video scaler helper object Add a video scaler object build on top of the resampler. It has implementation to deal with interlaced video as well as horizontal and vertical scaling functions.
2014-10-24 13:25:33 +00:00
#include <gst/video/video-scaler.h>
video: Add multiview/stereo support Add flags and enums to support multiview signalling in GstVideoInfo and GstVideoFrame, and the caps serialisation and deserialisation. videoencoder: Copy multiview settings from reference input state Add gst_video_multiview_* support API and GstVideoMultiviewMeta meta https://bugzilla.gnome.org/show_bug.cgi?id=611157
2015-06-11 01:12:39 +00:00
#include <gst/video/video-multiview.h>
video: add dma format and info helper functions From the dmabuf.md[1], "drm-format" field in caps will replace the traditional "format" field, so it needs to import some new helper functions to support this. 1. https://gstreamer.freedesktop.org/documentation/additional/design/dmabuf.html Co-authored-by: Yinhang Liu <yinhang.liu@intel.com> Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/4043>
2022-09-15 08:19:37 +00:00
#include <gst/video/video-info-dma.h>
gst-libs/gst/video/: Add glib-mkenum for GstVideoFormat enum GTYPE auto-generation. Original commit message from CVS: * gst-libs/gst/video/Makefile.am: * gst-libs/gst/video/video.h: Add glib-mkenum for GstVideoFormat enum GTYPE auto-generation. This will help bindings to use it.
2008-12-31 13:01:30 +00:00
video: move methods into separate files Move different video functionalities into different files
2012-06-05 10:47:22 +00:00
G_BEGIN_DECLS
gstvideo: Add GST_VIDEO_BUFFER_PROGRESSIVE flag Maps to GST_BUFFER_FLAG_MEDIA4. The purpose is to explicitly indicate whether a telecined buffer is progressive or not without having to make assumptions based on previous buffers.
2011-01-03 10:41:56 +00:00
video: expose gst_video_info_align Expose the gst_video_info_align function that adds padding and does stride alignment on a GstVideoInfo. Move this previously private function to video-info.co Move the definition of the alignment structure to video.h where it can be picked up by both the bufferpool and the video-info.
2012-08-20 08:50:59 +00:00
/**
* GstVideoAlignment:
* @padding_left: extra pixels on the left side
* @padding_right: extra pixels on the right side
* @padding_top: extra pixels on the top
* @padding_bottom: extra pixels on the bottom
* @stride_align: array with extra alignment requirements for the strides
*
video: fix typo in GstVideoAlignment doc https://bugzilla.gnome.org/show_bug.cgi?id=781490
2017-04-19 09:47:30 +00:00
* Extra alignment parameters for the memory of video buffers. This
video: expose gst_video_info_align Expose the gst_video_info_align function that adds padding and does stride alignment on a GstVideoInfo. Move this previously private function to video-info.co Move the definition of the alignment structure to video.h where it can be picked up by both the bufferpool and the video-info.
2012-08-20 08:50:59 +00:00
* structure is usually used to configure the bufferpool if it supports the
* #GST_BUFFER_POOL_OPTION_VIDEO_ALIGNMENT.
*/
struct _GstVideoAlignment
{
guint padding_top;
guint padding_bottom;
guint padding_left;
guint padding_right;
guint stride_align[GST_VIDEO_MAX_PLANES];
};
videodirection: interface for rotation and flip A GstVideoOrientationMethod enumeration is also provided for the admitted property values. https://bugzilla.gnome.org/show_bug.cgi?id=768687
2016-07-26 17:14:40 +00:00
/**
* GstVideoOrientationMethod:
* @GST_VIDEO_ORIENTATION_IDENTITY: Identity (no rotation)
* @GST_VIDEO_ORIENTATION_90R: Rotate clockwise 90 degrees
* @GST_VIDEO_ORIENTATION_180: Rotate 180 degrees
* @GST_VIDEO_ORIENTATION_90L: Rotate counter-clockwise 90 degrees
* @GST_VIDEO_ORIENTATION_HORIZ: Flip horizontally
* @GST_VIDEO_ORIENTATION_VERT: Flip vertically
video: Document UL_LR / UR_LL video orientation methods correctly They're not flipping along the diagonal axis but a flip and rotation. Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/6936>
2024-05-28 08:52:39 +00:00
* @GST_VIDEO_ORIENTATION_UL_LR: Rotate counter-clockwise 90 degrees and flip vertically
* @GST_VIDEO_ORIENTATION_UR_LL: Rotate clockwise 90 degrees and flip vertically
videodirection: interface for rotation and flip A GstVideoOrientationMethod enumeration is also provided for the admitted property values. https://bugzilla.gnome.org/show_bug.cgi?id=768687
2016-07-26 17:14:40 +00:00
* @GST_VIDEO_ORIENTATION_AUTO: Select flip method based on image-orientation tag
* @GST_VIDEO_ORIENTATION_CUSTOM: Current status depends on plugin internal setup
*
* The different video orientation methods.
*
* Since: 1.10
*/
typedef enum {
GST_VIDEO_ORIENTATION_IDENTITY,
GST_VIDEO_ORIENTATION_90R,
GST_VIDEO_ORIENTATION_180,
GST_VIDEO_ORIENTATION_90L,
GST_VIDEO_ORIENTATION_HORIZ,
GST_VIDEO_ORIENTATION_VERT,
GST_VIDEO_ORIENTATION_UL_LR,
GST_VIDEO_ORIENTATION_UR_LL,
GST_VIDEO_ORIENTATION_AUTO,
GST_VIDEO_ORIENTATION_CUSTOM,
} GstVideoOrientationMethod;
video: Put nicer documentation in GstVideoOrientationMethod Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/1088>
2021-05-04 19:28:25 +00:00
/**
* GST_TYPE_VIDEO_ORIENTATION_METHOD:
*
* Since: 1.20
*/
video/audio: #define metadata strings. For instance "orientation" becomes GST_VIDEO_ORIENTATION_METADATA.
2013-08-21 21:56:15 +00:00
/* metadata macros */
/**
* GST_META_TAG_VIDEO_STR:
docs: fix some doc blocks
2013-09-09 13:52:05 +00:00
*
video/audio: #define metadata strings. For instance "orientation" becomes GST_VIDEO_ORIENTATION_METADATA.
2013-08-21 21:56:15 +00:00
* This metadata is relevant for video streams.
*
* Since: 1.2
*/
#define GST_META_TAG_VIDEO_STR "video"
/**
* GST_META_TAG_VIDEO_ORIENTATION_STR:
docs: fix some doc blocks
2013-09-09 13:52:05 +00:00
*
video/audio: #define metadata strings. For instance "orientation" becomes GST_VIDEO_ORIENTATION_METADATA.
2013-08-21 21:56:15 +00:00
* This metadata stays relevant as long as video orientation is unchanged.
*
* Since: 1.2
*/
#define GST_META_TAG_VIDEO_ORIENTATION_STR "orientation"
/**
* GST_META_TAG_VIDEO_SIZE_STR:
docs: fix some doc blocks
2013-09-09 13:52:05 +00:00
*
video/audio: #define metadata strings. For instance "orientation" becomes GST_VIDEO_ORIENTATION_METADATA.
2013-08-21 21:56:15 +00:00
* This metadata stays relevant as long as video size is unchanged.
*
* Since: 1.2
*/
#define GST_META_TAG_VIDEO_SIZE_STR "size"
/**
* GST_META_TAG_VIDEO_COLORSPACE_STR:
docs: fix some doc blocks
2013-09-09 13:52:05 +00:00
*
video/audio: #define metadata strings. For instance "orientation" becomes GST_VIDEO_ORIENTATION_METADATA.
2013-08-21 21:56:15 +00:00
* This metadata stays relevant as long as video colorspace is unchanged.
*
* Since: 1.2
*/
#define GST_META_TAG_VIDEO_COLORSPACE_STR "colorspace"
video: GST_EXPORT -> GST_VIDEO_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 11:48:31 +00:00
GST_VIDEO_API
video: expose gst_video_info_align Expose the gst_video_info_align function that adds padding and does stride alignment on a GstVideoInfo. Move this previously private function to video-info.co Move the definition of the alignment structure to video.h where it can be picked up by both the bufferpool and the video-info.
2012-08-20 08:50:59 +00:00
void gst_video_alignment_reset (GstVideoAlignment *align);
audio: rework audio caps. Rework the audio caps similar to the video caps. Remove width/depth/endianness/signed fields and replace with a simple string format and media type audio/x-raw. Create a GstAudioInfo and some helper methods to parse caps. Remove duplicate code from the ringbuffer and replace with audio info. Use AudioInfo in the base audio filter class. Port elements to new API.
2011-08-18 17:15:03 +00:00
/* some helper functions */
video: mark symbols explicitly for export with GST_EXPORT
2017-05-16 00:09:38 +00:00
video: GST_EXPORT -> GST_VIDEO_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 11:48:31 +00:00
GST_VIDEO_API
video: clean up header file Sprinkle some spaces and newlines here and there.
2011-05-27 22:25:00 +00:00
gboolean gst_video_calculate_display_ratio (guint * dar_n,
guint * dar_d,
guint video_width,
guint video_height,
guint video_par_n,
guint video_par_d,
guint display_par_n,
guint display_par_d);
video: GST_EXPORT -> GST_VIDEO_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 11:48:31 +00:00
GST_VIDEO_API
video: Add gst_video_guess_framerate() function Takes a nominal frame duration and returns a standard FPS if it matches closely enough (< 0.1%), or else calculates a framerate that'll do.
2014-08-14 13:53:16 +00:00
gboolean gst_video_guess_framerate (GstClockTime duration,
gint * dest_n, gint * dest_d);
avviddec, video.c, h265parse: Workaround for broken field-based interlaced encoders Some encoders (e.g. Makito) have H265 field-based interlacing, but then also specify an 1:2 pixel aspect ratio. That makes it kind-of work with decoders that don't properly support field-based decoding, but makes us end up with the wrong aspect ratio if we implement everything properly. As a workaround, detect 1:2 pixel aspect ratio for field-based interlacing, and check if making that 1:1 would make the new display aspect ratio common. In that case, we override it with 1:1. Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2577>
2022-06-08 16:18:48 +00:00
GST_VIDEO_API
gboolean gst_video_is_common_aspect_ratio (gint width, gint height, gint par_n, gint par_d);
Use the new GstSample for snapshots Make appsink return a GstSample. Remove the pull_buffer_list method because it is not very useful anymore. Pass GstSample to the conversion function. Update playbin2 and examples
2011-12-01 15:48:49 +00:00
/* convert/encode video sample from one format to another */
video: clean up header file Sprinkle some spaces and newlines here and there.
2011-05-27 22:25:00 +00:00
Use the new GstSample for snapshots Make appsink return a GstSample. Remove the pull_buffer_list method because it is not very useful anymore. Pass GstSample to the conversion function. Update playbin2 and examples
2011-12-01 15:48:49 +00:00
typedef void (*GstVideoConvertSampleCallback) (GstSample * sample, GError *error, gpointer user_data);
video: clean up header file Sprinkle some spaces and newlines here and there.
2011-05-27 22:25:00 +00:00
video: GST_EXPORT -> GST_VIDEO_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 11:48:31 +00:00
GST_VIDEO_API
Use the new GstSample for snapshots Make appsink return a GstSample. Remove the pull_buffer_list method because it is not very useful anymore. Pass GstSample to the conversion function. Update playbin2 and examples
2011-12-01 15:48:49 +00:00
void gst_video_convert_sample_async (GstSample * sample,
video: clean up header file Sprinkle some spaces and newlines here and there.
2011-05-27 22:25:00 +00:00
const GstCaps * to_caps,
GstClockTime timeout,
Use the new GstSample for snapshots Make appsink return a GstSample. Remove the pull_buffer_list method because it is not very useful anymore. Pass GstSample to the conversion function. Update playbin2 and examples
2011-12-01 15:48:49 +00:00
GstVideoConvertSampleCallback callback,
video: clean up header file Sprinkle some spaces and newlines here and there.
2011-05-27 22:25:00 +00:00
gpointer user_data,
GDestroyNotify destroy_notify);
video: GST_EXPORT -> GST_VIDEO_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 11:48:31 +00:00
GST_VIDEO_API
Use the new GstSample for snapshots Make appsink return a GstSample. Remove the pull_buffer_list method because it is not very useful anymore. Pass GstSample to the conversion function. Update playbin2 and examples
2011-12-01 15:48:49 +00:00
GstSample * gst_video_convert_sample (GstSample * sample,
video: clean up header file Sprinkle some spaces and newlines here and there.
2011-05-27 22:25:00 +00:00
const GstCaps * to_caps,
GstClockTime timeout,
GError ** error);
libs: Use foo/foo.h as single-include header consistently everywhere https://bugzilla.gnome.org/show_bug.cgi?id=688785
2012-12-12 17:13:10 +00:00
video: Add API to parse the image orientation from a GstTagList Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/1088>
2021-05-04 19:50:59 +00:00
GST_VIDEO_API
gboolean gst_video_orientation_from_tag (GstTagList * taglist,
GstVideoOrientationMethod * method);
Add G_BEGIN_DECLS and G_END_DECLS around headers where missing, so that they work when included from C++ code Original commit message from CVS: Add G_BEGIN_DECLS and G_END_DECLS around headers where missing, so that they work when included from C++ code
2005-02-09 22:31:05 +00:00
G_END_DECLS
libs: Use foo/foo.h as single-include header consistently everywhere https://bugzilla.gnome.org/show_bug.cgi?id=688785
2012-12-12 17:13:10 +00:00
#include <gst/video/colorbalancechannel.h>
#include <gst/video/colorbalance.h>
video: Sort includes in video.h Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-base/-/merge_requests/1128>
2021-03-30 18:38:25 +00:00
#include <gst/video/gstvideoaffinetransformationmeta.h>
video: build GstVideoAggregator which was moved from -bad
2018-12-26 17:02:42 +00:00
#include <gst/video/gstvideoaggregator.h>
codec: Introduce GstVideoCodecAlphaMeta This meta hold one buffer of the same codec data as the parent memory. This extra frame luma will be used as the alpha values for the final combined frame. This is notably used to support VP8/VP9 alpha as defined in WebM and matroska specification. Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-base/-/merge_requests/1128>
2021-03-03 01:09:26 +00:00
#include <gst/video/gstvideocodecalphameta.h>
libs: Use foo/foo.h as single-include header consistently everywhere https://bugzilla.gnome.org/show_bug.cgi?id=688785
2012-12-12 17:13:10 +00:00
#include <gst/video/gstvideodecoder.h>
#include <gst/video/gstvideoencoder.h>
#include <gst/video/gstvideofilter.h>
#include <gst/video/gstvideometa.h>
#include <gst/video/gstvideopool.h>
#include <gst/video/gstvideosink.h>
video: Sort includes in video.h Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-base/-/merge_requests/1128>
2021-03-30 18:38:25 +00:00
#include <gst/video/gstvideotimecode.h>
libs: Use foo/foo.h as single-include header consistently everywhere https://bugzilla.gnome.org/show_bug.cgi?id=688785
2012-12-12 17:13:10 +00:00
#include <gst/video/gstvideoutils.h>
#include <gst/video/navigation.h>
video: Sort includes in video.h Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-base/-/merge_requests/1128>
2021-03-30 18:38:25 +00:00
#include <gst/video/video-anc.h>
libs: Use foo/foo.h as single-include header consistently everywhere https://bugzilla.gnome.org/show_bug.cgi?id=688785
2012-12-12 17:13:10 +00:00
#include <gst/video/video-blend.h>
videodirection: interface for rotation and flip A GstVideoOrientationMethod enumeration is also provided for the admitted property values. https://bugzilla.gnome.org/show_bug.cgi?id=768687
2016-07-26 17:14:40 +00:00
#include <gst/video/videodirection.h>
video: Sort includes in video.h Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-base/-/merge_requests/1128>
2021-03-30 18:38:25 +00:00
#include <gst/video/video-event.h>
#include <gst/video/video-hdr.h>
libs: Use foo/foo.h as single-include header consistently everywhere https://bugzilla.gnome.org/show_bug.cgi?id=688785
2012-12-12 17:13:10 +00:00
#include <gst/video/videoorientation.h>
#include <gst/video/video-overlay-composition.h>
#include <gst/video/videooverlay.h>
video: Include new video-sei.h in video.h Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2688>
2022-06-30 05:42:43 +00:00
#include <gst/video/video-sei.h>
libs: Use foo/foo.h as single-include header consistently everywhere https://bugzilla.gnome.org/show_bug.cgi?id=688785
2012-12-12 17:13:10 +00:00
muhaha Original commit message from CVS: muhaha
2002-11-09 18:31:27 +00:00
#endif /* __GST_VIDEO_H__ */
Reference in a new issue Copy permalink