docs/plugins/: Add videocrop to docs.

Original commit message from CVS:
* docs/plugins/Makefile.am:
* docs/plugins/gst-plugins-bad-plugins-docs.sgml:
* docs/plugins/gst-plugins-bad-plugins-sections.txt:
* docs/plugins/gst-plugins-bad-plugins.hierarchy:
Add videocrop to docs.
* gst/videocrop/Makefile.am:
* gst/videocrop/gstvideocrop.c:
* gst/videocrop/gstvideocrop.h:
Move boilerplate stuff and structures into a header file.
* tests/check/Makefile.am:
* tests/check/elements/.cvsignore:
* tests/check/elements/videocrop.c: (video_crop_get_test_caps),
(test_unit_sizes), (videocrop_test_cropping_init_context),
(videocrop_test_cropping_deinit_context),
(videocrop_test_cropping), (test_cropping), (videocrop_suite):
Add unit tests for videocrop.

1 files changed, 85 insertions, 0 deletions

diff --git a/gst/videocrop/gstvideocrop.h b/gst/videocrop/gstvideocrop.h
new file mode 100644
index 00000000..23ffca16
--- /dev/null
+++ b/gst/videocrop/gstvideocrop.h
@@ -0,0 +1,85 @@
+/* GStreamer video frame cropping
+ * Copyright (C) 2006 Tim-Philipp Müller <tim centricular net>
+ *
+ * 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_VIDEO_CROP_H__
+#define __GST_VIDEO_CROP_H__
+
+#include <gst/base/gstbasetransform.h>
+
+G_BEGIN_DECLS
+
+#define GST_TYPE_VIDEO_CROP \
+  (gst_video_crop_get_type())
+#define GST_VIDEO_CROP(obj) \
+  (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_VIDEO_CROP,GstVideoCrop))
+#define GST_VIDEO_CROP_CLASS(klass) \
+  (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_VIDEO_CROP,GstVideoCropClass))
+#define GST_IS_VIDEO_CROP(obj) \
+  (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_VIDEO_CROP))
+#define GST_IS_VIDEO_CROP_CLASS(klass) \
+  (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_VIDEO_CROP))
+
+typedef struct _GstVideoCropImageDetails GstVideoCropImageDetails;
+struct _GstVideoCropImageDetails
+{
+  /*< private >*/
+  gboolean packed;              /* TRUE if packed, FALSE if planar */
+
+  guint width;
+  guint height;
+  guint size;
+
+  /* for packed RGB and YUV */
+  guint stride;
+  guint bytes_per_pixel;
+
+  /* for planar YUV */
+  guint y_stride, y_off;
+  guint u_stride, u_off;
+  guint v_stride, v_off;
+};
+
+typedef struct _GstVideoCrop GstVideoCrop;
+typedef struct _GstVideoCropClass GstVideoCropClass;
+
+struct _GstVideoCrop
+{
+  GstBaseTransform basetransform;
+
+  /*< private >*/
+  gboolean noop;                /* TRUE if crop_left,_right,_top and _bottom are all 0 */
+
+  gint crop_left;
+  gint crop_right;
+  gint crop_top;
+  gint crop_bottom;
+
+  GstVideoCropImageDetails in;  /* details of input image */
+  GstVideoCropImageDetails out; /* details of output image */
+};
+
+struct _GstVideoCropClass
+{
+  GstBaseTransformClass basetransform_class;
+};
+
+G_END_DECLS
+
+#endif /* __GST_VIDEO_CROP_H__ */
+