1/* GStreamer
2 * Copyright (C) Collabora Ltd.
3 * Author: Matthieu Bouron <matthieu.bouron@collabora.com>
4 * Copyright (C) 2015, Matthew Waters <matthew@centricular.com>
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Library General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Library General Public License for more details.
15 *
16 * You should have received a copy of the GNU Library General Public
17 * License along with this library; if not, write to the
18 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
19 * Boston, MA 02110-1301, USA.
20 */
21
22#ifndef __GST_VIDEO_AFFINE_TRANSFORMATION_META_H__
23#define __GST_VIDEO_AFFINE_TRANSFORMATION_META_H__
24
25#include <gst/gst.h>
26#include <gst/video/video.h>
27
28G_BEGIN_DECLS
29
30#define GST_VIDEO_AFFINE_TRANSFORMATION_META_API_TYPE (gst_video_affine_transformation_meta_api_get_type())
31#define GST_VIDEO_AFFINE_TRANSFORMATION_META_INFO (gst_video_affine_transformation_meta_get_info())
32
33typedef struct _GstVideoAffineTransformationMeta GstVideoAffineTransformationMeta;
34typedef gboolean (*GstVideoAffineTransformationGetMatrix) (GstVideoAffineTransformationMeta * meta, gfloat * matrix);
35
36#define GST_CAPS_FEATURE_META_GST_VIDEO_AFFINE_TRANSFORMATION_META "meta:GstVideoAffineTransformation"
37#define GST_BUFFER_POOL_OPTION_VIDEO_AFFINE_TRANSFORMATION_META "GstBufferPoolOptionVideoAffineTransformation"
38
39/**
40 * GstVideoAffineTransformationMeta:
41 * @meta: parent #GstMeta
42 * @matrix: the column-major 4x4 transformation matrix
43 *
44 * Extra buffer metadata for performing an affine transformation using a 4x4
45 * matrix. The transformation matrix can be composed with
46 * gst_video_affine_transformation_meta_apply_matrix().
47 *
48 * The vertices operated on are all in the range 0 to 1, not in
49 * Normalized Device Coordinates (-1 to +1). Transforming points in this space
50 * are assumed to have an origin at (0.5, 0.5, 0.5) in a left-handed coordinate
51 * system with the x-axis moving horizontally (positive values to the right),
52 * the y-axis moving vertically (positive values up the screen) and the z-axis
53 * perpendicular to the screen (positive values into the screen).
54 *
55 * Since: 1.8
56 */
57struct _GstVideoAffineTransformationMeta
58{
59 GstMeta meta;
60
61 gfloat matrix[16];
62};
63
64GST_VIDEO_API
65GType gst_video_affine_transformation_meta_api_get_type (void);
66
67GST_VIDEO_API
68const GstMetaInfo *gst_video_affine_transformation_meta_get_info (void);
69
70#define gst_buffer_get_video_affine_transformation_meta(b) \
71 ((GstVideoAffineTransformationMeta *)gst_buffer_get_meta((b),GST_VIDEO_AFFINE_TRANSFORMATION_META_API_TYPE))
72GST_VIDEO_API
73GstVideoAffineTransformationMeta *gst_buffer_add_video_affine_transformation_meta (GstBuffer * buffer);
74
75GST_VIDEO_API
76void gst_video_affine_transformation_meta_apply_matrix (GstVideoAffineTransformationMeta * meta,
77 const gfloat matrix[16]);
78
79G_END_DECLS
80
81#endif /* __GST_VIDEO_AFFINE_TRANSFORMATION_META_H__ */
82

source code of include/gstreamer-1.0/gst/video/gstvideoaffinetransformationmeta.h