mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-23 18:21:04 +00:00
videobox: Split declarations into a header file and add autocrop stuff to the docs
This commit is contained in:
Sebastian Dröge
parent
6976f3d39a
commit
867b8c9d15
3 changed files with 110 additions and 76 deletions
|
|
@ -8,4 +8,5 @@ libgstvideobox_la_LIBADD = $(GST_BASE_LIBS) $(GST_PLUGINS_BASE_LIBS) \
|
|||
libgstvideobox_la_LDFLAGS = $(GST_PLUGIN_LDFLAGS)
|
||||
libgstvideobox_la_LIBTOOLFLAGS = --tag=disable-static
|
||||
|
||||
noinst_HEADERS = gstvideobox.h
|
||||
EXTRA_DIST = README
|
||||
|
|
|
|||
|
|
@ -34,14 +34,30 @@
|
|||
*
|
||||
* The videobox plugin has many uses such as doing a mosaic of pictures,
|
||||
* letterboxing video, cutting out pieces of video, picture in picture, etc..
|
||||
*
|
||||
* Setting autocrop to true changes the behavior of the plugin so that
|
||||
* caps determine crop properties rather than the other way around: given
|
||||
* input and output dimensions, the crop values are selected so that the
|
||||
* smaller frame is effectively centered in the larger frame. This
|
||||
* involves either cropping or padding.
|
||||
*
|
||||
* If you use autocrop there is little point in setting the other
|
||||
* properties manually because they will be overriden if the caps change,
|
||||
* but nothing stops you from doing so.
|
||||
*
|
||||
* Sample pipeline:
|
||||
* |[
|
||||
* gst-launch videotestsrc ! videobox autocrop=true ! \
|
||||
* "video/x-raw-yuv, width=600, height=400" ! ffmpegcolorspace ! ximagesink
|
||||
* ]|
|
||||
*/
|
||||
|
||||
#ifdef HAVE_CONFIG_H
|
||||
#include "config.h"
|
||||
#endif
|
||||
#include <gst/gst.h>
|
||||
#include <gst/base/gstbasetransform.h>
|
||||
#include <gst/video/video.h>
|
||||
|
||||
#include "gstvideobox.h"
|
||||
|
||||
#include <math.h>
|
||||
#include <liboil/liboil.h>
|
||||
#include <string.h>
|
||||
|
|
@ -49,59 +65,6 @@
|
|||
GST_DEBUG_CATEGORY_STATIC (videobox_debug);
|
||||
#define GST_CAT_DEFAULT videobox_debug
|
||||
|
||||
#define GST_TYPE_VIDEO_BOX \
|
||||
(gst_video_box_get_type())
|
||||
#define GST_VIDEO_BOX(obj) \
|
||||
(G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_VIDEO_BOX,GstVideoBox))
|
||||
#define GST_VIDEO_BOX_CLASS(klass) \
|
||||
(G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_VIDEO_BOX,GstVideoBoxClass))
|
||||
#define GST_IS_VIDEO_BOX(obj) \
|
||||
(G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_VIDEO_BOX))
|
||||
#define GST_IS_VIDEO_BOX_CLASS(klass) \
|
||||
(G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_VIDEO_BOX))
|
||||
|
||||
typedef struct _GstVideoBox GstVideoBox;
|
||||
typedef struct _GstVideoBoxClass GstVideoBoxClass;
|
||||
|
||||
typedef enum
|
||||
{
|
||||
VIDEO_BOX_FILL_BLACK,
|
||||
VIDEO_BOX_FILL_GREEN,
|
||||
VIDEO_BOX_FILL_BLUE,
|
||||
VIDEO_BOX_FILL_LAST
|
||||
}
|
||||
GstVideoBoxFill;
|
||||
|
||||
struct _GstVideoBox
|
||||
{
|
||||
GstBaseTransform element;
|
||||
|
||||
/* Guarding everything below */
|
||||
GMutex *mutex;
|
||||
/* caps */
|
||||
guint32 in_fourcc;
|
||||
gint in_width, in_height;
|
||||
guint32 out_fourcc;
|
||||
gint out_width, out_height;
|
||||
|
||||
gint box_left, box_right, box_top, box_bottom;
|
||||
|
||||
gint border_left, border_right, border_top, border_bottom;
|
||||
gint crop_left, crop_right, crop_top, crop_bottom;
|
||||
|
||||
gdouble alpha;
|
||||
gdouble border_alpha;
|
||||
|
||||
GstVideoBoxFill fill_type;
|
||||
|
||||
gboolean autocrop;
|
||||
};
|
||||
|
||||
struct _GstVideoBoxClass
|
||||
{
|
||||
GstBaseTransformClass parent_class;
|
||||
};
|
||||
|
||||
/* elementfactory information */
|
||||
static const GstElementDetails gst_video_box_details =
|
||||
GST_ELEMENT_DETAILS ("Video box filter",
|
||||
|
|
@ -132,25 +95,6 @@ enum
|
|||
/* FILL ME */
|
||||
};
|
||||
|
||||
/*
|
||||
|
||||
Setting autocrop to true changes the behavior of the plugin so that
|
||||
caps determine crop properties rather than the other way around: given
|
||||
input and output dimensions, the crop values are selected so that the
|
||||
smaller frame is effectively centered in the larger frame. This
|
||||
involves either cropping or padding.
|
||||
|
||||
If you use autocrop there is little point in setting the other
|
||||
properties manually because they will be overriden if the caps change,
|
||||
but nothing stops you from doing so.
|
||||
|
||||
Sample pipeline:
|
||||
gst-launch videotestsrc ! videobox autocrop=true ! \
|
||||
"video/x-raw-yuv, width=600, height=400" ! ffmpegcolorspace ! ximagesink
|
||||
|
||||
*/
|
||||
|
||||
|
||||
static GstStaticPadTemplate gst_video_box_src_template =
|
||||
GST_STATIC_PAD_TEMPLATE ("src",
|
||||
GST_PAD_SRC,
|
||||
|
|
@ -167,7 +111,6 @@ static GstStaticPadTemplate gst_video_box_sink_template =
|
|||
GST_VIDEO_CAPS_YUV ("I420"))
|
||||
);
|
||||
|
||||
|
||||
GST_BOILERPLATE (GstVideoBox, gst_video_box, GstBaseTransform,
|
||||
GST_TYPE_BASE_TRANSFORM);
|
||||
|
||||
|
|
@ -273,6 +216,14 @@ gst_video_box_class_init (GstVideoBoxClass * klass)
|
|||
g_param_spec_double ("border_alpha", "Border Alpha",
|
||||
"Alpha value of the border", 0.0, 1.0, DEFAULT_BORDER_ALPHA,
|
||||
G_PARAM_READWRITE));
|
||||
/**
|
||||
* GstVideoBox:autocrop
|
||||
*
|
||||
* If set to %TRUE videobox will automatically crop/pad the input
|
||||
* video to be centered in the output.
|
||||
*
|
||||
* Since: 0.10.16
|
||||
**/
|
||||
g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_AUTOCROP,
|
||||
g_param_spec_boolean ("autocrop", "Auto crop",
|
||||
"Auto crop", FALSE, G_PARAM_READWRITE));
|
||||
|
|
|
|||
82
gst/videobox/gstvideobox.h
Normal file
82
gst/videobox/gstvideobox.h
Normal file
|
|
@ -0,0 +1,82 @@
|
|||
/* GStreamer
|
||||
* Copyright (C) <1999> Erik Walthinsen <omega@cse.ogi.edu>
|
||||
*
|
||||
* 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.
|
||||
*/
|
||||
|
||||
#include <gst/gst.h>
|
||||
#include <gst/base/gstbasetransform.h>
|
||||
#include <gst/video/video.h>
|
||||
|
||||
#ifndef __GST_VIDEO_BOX_H__
|
||||
#define __GST_VIDEO_BOX_H__
|
||||
|
||||
#define GST_TYPE_VIDEO_BOX \
|
||||
(gst_video_box_get_type())
|
||||
#define GST_VIDEO_BOX(obj) \
|
||||
(G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_VIDEO_BOX,GstVideoBox))
|
||||
#define GST_VIDEO_BOX_CLASS(klass) \
|
||||
(G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_VIDEO_BOX,GstVideoBoxClass))
|
||||
#define GST_IS_VIDEO_BOX(obj) \
|
||||
(G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_VIDEO_BOX))
|
||||
#define GST_IS_VIDEO_BOX_CLASS(klass) \
|
||||
(G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_VIDEO_BOX))
|
||||
|
||||
typedef struct _GstVideoBox GstVideoBox;
|
||||
typedef struct _GstVideoBoxClass GstVideoBoxClass;
|
||||
|
||||
typedef enum
|
||||
{
|
||||
VIDEO_BOX_FILL_BLACK,
|
||||
VIDEO_BOX_FILL_GREEN,
|
||||
VIDEO_BOX_FILL_BLUE,
|
||||
VIDEO_BOX_FILL_LAST
|
||||
}
|
||||
GstVideoBoxFill;
|
||||
|
||||
struct _GstVideoBox
|
||||
{
|
||||
GstBaseTransform element;
|
||||
|
||||
/* <private> */
|
||||
|
||||
/* Guarding everything below */
|
||||
GMutex *mutex;
|
||||
/* caps */
|
||||
guint32 in_fourcc;
|
||||
gint in_width, in_height;
|
||||
guint32 out_fourcc;
|
||||
gint out_width, out_height;
|
||||
|
||||
gint box_left, box_right, box_top, box_bottom;
|
||||
|
||||
gint border_left, border_right, border_top, border_bottom;
|
||||
gint crop_left, crop_right, crop_top, crop_bottom;
|
||||
|
||||
gdouble alpha;
|
||||
gdouble border_alpha;
|
||||
|
||||
GstVideoBoxFill fill_type;
|
||||
|
||||
gboolean autocrop;
|
||||
};
|
||||
|
||||
struct _GstVideoBoxClass
|
||||
{
|
||||
GstBaseTransformClass parent_class;
|
||||
};
|
||||
|
||||
#endif /* __GST_VIDEO_BOX_H__ */
|
||||
Loading…
Reference in a new issue