mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-26 02:00:33 +00:00
61ae84b50d
This api is in linux kernel since version 2.6.39,
and present in all version 3.
The commit that adds the API in master branch of the
linux kernel source is:
f8f3914cf9
v4l2 doc: "Some devices require data for each input
or output video frame to be placed in discontiguous
memory buffers"
There are newer structures 'struct v4l2_pix_format_mplane'
and 'struct v4l2_plane'.
So the pixel format is not setup with the same API when using
multi-planar.
Also for gst-v4l2, one of the difference is that in GstV4l2Meta
there are now one mem pointer for each maped plane.
When not using multi-planar, this commit takes care of keeping
the same code path than previously. So that the 2 cases are
in two different blocks triggered from V4L2_TYPE_IS_MULTIPLANAR.
Fixes bug https://bugzilla.gnome.org/show_bug.cgi?id=712754
306 lines
12 KiB
C
306 lines
12 KiB
C
/* GStreamer
|
|
*
|
|
* Copyright (C) 2001-2002 Ronald Bultje <rbultje@ronald.bitfreak.net>
|
|
* 2006 Edgard Lima <edgard.lima@indt.org.br>
|
|
*
|
|
* gstv4l2object.h: base class for V4L2 elements
|
|
*
|
|
* 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., 51 Franklin St, Fifth Floor,
|
|
* Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef __GST_V4L2_OBJECT_H__
|
|
#define __GST_V4L2_OBJECT_H__
|
|
|
|
/* Because of some really cool feature in video4linux1, also known as
|
|
* 'not including sys/types.h and sys/time.h', we had to include it
|
|
* ourselves. In all their intelligence, these people decided to fix
|
|
* this in the next version (video4linux2) in such a cool way that it
|
|
* breaks all compilations of old stuff...
|
|
* The real problem is actually that linux/time.h doesn't use proper
|
|
* macro checks before defining types like struct timeval. The proper
|
|
* fix here is to either fuck the kernel header (which is what we do
|
|
* by defining _LINUX_TIME_H, an innocent little hack) or by fixing it
|
|
* upstream, which I'll consider doing later on. If you get compiler
|
|
* errors here, check your linux/time.h && sys/time.h header setup.
|
|
*/
|
|
#include <sys/ioctl.h>
|
|
#include <sys/types.h>
|
|
#ifdef __sun
|
|
#include <sys/videodev2.h>
|
|
#elif defined(__FreeBSD__)
|
|
#include <linux/videodev2.h>
|
|
#else /* linux */
|
|
#include <linux/types.h>
|
|
#define _LINUX_TIME_H
|
|
#define __user
|
|
#include <linux/videodev2.h>
|
|
#endif
|
|
|
|
#include <gst/gst.h>
|
|
#include <gst/base/gstpushsrc.h>
|
|
|
|
#include <gst/video/video.h>
|
|
|
|
typedef struct _GstV4l2Object GstV4l2Object;
|
|
typedef struct _GstV4l2ObjectClassHelper GstV4l2ObjectClassHelper;
|
|
typedef struct _GstV4l2Xv GstV4l2Xv;
|
|
|
|
#include <gstv4l2bufferpool.h>
|
|
|
|
/* size of v4l2 buffer pool in streaming case */
|
|
#define GST_V4L2_MAX_BUFFERS 16
|
|
#define GST_V4L2_MIN_BUFFERS 1
|
|
|
|
/* max frame width/height */
|
|
#define GST_V4L2_MAX_SIZE (1<<15) /* 2^15 == 32768 */
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GST_V4L2_OBJECT(obj) (GstV4l2Object *)(obj)
|
|
|
|
typedef enum {
|
|
GST_V4L2_IO_AUTO = 0,
|
|
GST_V4L2_IO_RW = 1,
|
|
GST_V4L2_IO_MMAP = 2,
|
|
GST_V4L2_IO_USERPTR = 3,
|
|
GST_V4L2_IO_DMABUF = 4
|
|
} GstV4l2IOMode;
|
|
|
|
typedef gboolean (*GstV4l2GetInOutFunction) (GstV4l2Object * v4l2object, gint * input);
|
|
typedef gboolean (*GstV4l2SetInOutFunction) (GstV4l2Object * v4l2object, gint input);
|
|
typedef gboolean (*GstV4l2UpdateFpsFunction) (GstV4l2Object * v4l2object);
|
|
|
|
#define GST_V4L2_WIDTH(o) (GST_VIDEO_INFO_WIDTH (&(o)->info))
|
|
#define GST_V4L2_HEIGHT(o) (GST_VIDEO_INFO_HEIGHT (&(o)->info))
|
|
#define GST_V4L2_PIXELFORMAT(o) ((o)->fmtdesc->pixelformat)
|
|
#define GST_V4L2_FPS_N(o) (GST_VIDEO_INFO_FPS_N (&(o)->info))
|
|
#define GST_V4L2_FPS_D(o) (GST_VIDEO_INFO_FPS_D (&(o)->info))
|
|
|
|
/* simple check whether the device is open */
|
|
#define GST_V4L2_IS_OPEN(o) ((o)->video_fd > 0)
|
|
|
|
/* check whether the device is 'active' */
|
|
#define GST_V4L2_IS_ACTIVE(o) ((o)->active)
|
|
#define GST_V4L2_SET_ACTIVE(o) ((o)->active = TRUE)
|
|
#define GST_V4L2_SET_INACTIVE(o) ((o)->active = FALSE)
|
|
|
|
struct _GstV4l2Object {
|
|
GstElement * element;
|
|
|
|
enum v4l2_buf_type type; /* V4L2_BUF_TYPE_VIDEO_CAPTURE, V4L2_BUF_TYPE_VIDEO_OUTPUT */
|
|
|
|
/* the video device */
|
|
char *videodev;
|
|
|
|
/* the video-device's file descriptor */
|
|
gint video_fd;
|
|
GstV4l2IOMode mode;
|
|
GstPoll * poll;
|
|
gboolean can_poll_device;
|
|
|
|
gboolean active;
|
|
gboolean streaming;
|
|
|
|
/* the current format */
|
|
struct v4l2_fmtdesc *fmtdesc;
|
|
GstVideoInfo info;
|
|
|
|
/* only used if the device supports MPLANE
|
|
* nb planes is meaning of v4l2 planes
|
|
* the gstreamer equivalent is gst_buffer_n_memory
|
|
*/
|
|
gint n_v4l2_planes;
|
|
|
|
guint32 bytesperline[GST_VIDEO_MAX_PLANES];
|
|
guint32 sizeimage;
|
|
GstClockTime duration;
|
|
|
|
/* if the MPLANE device support both contiguous and non contiguous
|
|
* it allows to select which one we want. But we prefered_non_contiguous
|
|
* non contiguous mode.
|
|
*/
|
|
gboolean prefered_non_contiguous;
|
|
|
|
/* wanted mode */
|
|
GstV4l2IOMode req_mode;
|
|
|
|
/* optional pool */
|
|
GstBufferPool *pool;
|
|
|
|
/* the video device's capabilities */
|
|
struct v4l2_capability vcap;
|
|
|
|
/* the video device's window properties */
|
|
struct v4l2_window vwin;
|
|
|
|
/* some more info about the current input's capabilities */
|
|
struct v4l2_input vinput;
|
|
|
|
/* lists... */
|
|
GSList *formats; /* list of available capture formats */
|
|
GstCaps *probed_caps;
|
|
|
|
GList *colors;
|
|
GList *norms;
|
|
GList *channels;
|
|
GData *controls;
|
|
|
|
/* properties */
|
|
v4l2_std_id tv_norm;
|
|
gchar *channel;
|
|
gulong frequency;
|
|
GstStructure *extra_controls;
|
|
gboolean keep_aspect;
|
|
GValue *par;
|
|
|
|
/* X-overlay */
|
|
GstV4l2Xv *xv;
|
|
gulong xwindow_id;
|
|
|
|
/* funcs */
|
|
GstV4l2GetInOutFunction get_in_out_func;
|
|
GstV4l2SetInOutFunction set_in_out_func;
|
|
GstV4l2UpdateFpsFunction update_fps_func;
|
|
};
|
|
|
|
struct _GstV4l2ObjectClassHelper {
|
|
/* probed devices */
|
|
GList *devices;
|
|
};
|
|
|
|
GType gst_v4l2_object_get_type (void);
|
|
|
|
#define V4L2_STD_OBJECT_PROPS \
|
|
PROP_DEVICE, \
|
|
PROP_DEVICE_NAME, \
|
|
PROP_DEVICE_FD, \
|
|
PROP_FLAGS, \
|
|
PROP_BRIGHTNESS, \
|
|
PROP_CONTRAST, \
|
|
PROP_SATURATION, \
|
|
PROP_HUE, \
|
|
PROP_TV_NORM, \
|
|
PROP_IO_MODE, \
|
|
PROP_EXTRA_CONTROLS, \
|
|
PROP_PIXEL_ASPECT_RATIO, \
|
|
PROP_FORCE_ASPECT_RATIO
|
|
|
|
/* create/destroy */
|
|
GstV4l2Object* gst_v4l2_object_new (GstElement * element,
|
|
enum v4l2_buf_type type,
|
|
const char * default_device,
|
|
GstV4l2GetInOutFunction get_in_out_func,
|
|
GstV4l2SetInOutFunction set_in_out_func,
|
|
GstV4l2UpdateFpsFunction update_fps_func);
|
|
|
|
void gst_v4l2_object_destroy (GstV4l2Object * v4l2object);
|
|
|
|
/* properties */
|
|
|
|
void gst_v4l2_object_install_properties_helper (GObjectClass * gobject_class,
|
|
const char * default_device);
|
|
|
|
gboolean gst_v4l2_object_set_property_helper (GstV4l2Object * v4l2object,
|
|
guint prop_id,
|
|
const GValue * value,
|
|
GParamSpec * pspec);
|
|
gboolean gst_v4l2_object_get_property_helper (GstV4l2Object *v4l2object,
|
|
guint prop_id, GValue * value,
|
|
GParamSpec * pspec);
|
|
/* open/close */
|
|
gboolean gst_v4l2_object_open (GstV4l2Object *v4l2object);
|
|
gboolean gst_v4l2_object_close (GstV4l2Object *v4l2object);
|
|
|
|
/* probing */
|
|
#if 0
|
|
const GList* gst_v4l2_probe_get_properties (GstPropertyProbe * probe);
|
|
|
|
void gst_v4l2_probe_probe_property (GstPropertyProbe * probe, guint prop_id,
|
|
const GParamSpec * pspec,
|
|
GList ** klass_devices);
|
|
gboolean gst_v4l2_probe_needs_probe (GstPropertyProbe * probe, guint prop_id,
|
|
const GParamSpec * pspec,
|
|
GList ** klass_devices);
|
|
GValueArray* gst_v4l2_probe_get_values (GstPropertyProbe * probe, guint prop_id,
|
|
const GParamSpec * pspec,
|
|
GList ** klass_devices);
|
|
#endif
|
|
|
|
GstCaps* gst_v4l2_object_get_all_caps (void);
|
|
|
|
GstStructure* gst_v4l2_object_v4l2fourcc_to_structure (guint32 fourcc);
|
|
|
|
gboolean gst_v4l2_object_set_format (GstV4l2Object * v4l2object, GstCaps * caps);
|
|
|
|
gboolean gst_v4l2_object_caps_equal (GstV4l2Object * v4l2object, GstCaps * caps);
|
|
|
|
gboolean gst_v4l2_object_unlock (GstV4l2Object * v4l2object);
|
|
gboolean gst_v4l2_object_unlock_stop (GstV4l2Object * v4l2object);
|
|
|
|
gboolean gst_v4l2_object_stop (GstV4l2Object * v4l2object);
|
|
|
|
|
|
gboolean gst_v4l2_object_copy (GstV4l2Object * v4l2object,
|
|
GstBuffer * dest, GstBuffer * src);
|
|
|
|
GstCaps * gst_v4l2_object_get_caps (GstV4l2Object * v4l2object,
|
|
GstCaps * filter);
|
|
|
|
|
|
#define GST_IMPLEMENT_V4L2_PROBE_METHODS(Type_Class, interface_as_function) \
|
|
\
|
|
static void \
|
|
interface_as_function ## _probe_probe_property (GstPropertyProbe * probe, \
|
|
guint prop_id, \
|
|
const GParamSpec * pspec) \
|
|
{ \
|
|
Type_Class *this_class = (Type_Class*) G_OBJECT_GET_CLASS (probe); \
|
|
gst_v4l2_probe_probe_property (probe, prop_id, pspec, \
|
|
&this_class->v4l2_class_devices); \
|
|
} \
|
|
\
|
|
static gboolean \
|
|
interface_as_function ## _probe_needs_probe (GstPropertyProbe * probe, \
|
|
guint prop_id, \
|
|
const GParamSpec * pspec) \
|
|
{ \
|
|
Type_Class *this_class = (Type_Class*) G_OBJECT_GET_CLASS (probe); \
|
|
return gst_v4l2_probe_needs_probe (probe, prop_id, pspec, \
|
|
&this_class->v4l2_class_devices); \
|
|
} \
|
|
\
|
|
static GValueArray * \
|
|
interface_as_function ## _probe_get_values (GstPropertyProbe * probe, \
|
|
guint prop_id, \
|
|
const GParamSpec * pspec) \
|
|
{ \
|
|
Type_Class *this_class = (Type_Class*) G_OBJECT_GET_CLASS (probe); \
|
|
return gst_v4l2_probe_get_values (probe, prop_id, pspec, \
|
|
&this_class->v4l2_class_devices); \
|
|
} \
|
|
\
|
|
static void \
|
|
interface_as_function ## _property_probe_interface_init (GstPropertyProbeInterface * iface) \
|
|
{ \
|
|
iface->get_properties = gst_v4l2_probe_get_properties; \
|
|
iface->probe_property = interface_as_function ## _probe_probe_property; \
|
|
iface->needs_probe = interface_as_function ## _probe_needs_probe; \
|
|
iface->get_values = interface_as_function ## _probe_get_values; \
|
|
}
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GST_V4L2_OBJECT_H__ */
|