diff options
Diffstat (limited to 'gst/deinterlace2/gstdeinterlace2.h')
| -rw-r--r-- | gst/deinterlace2/gstdeinterlace2.h | 267 |
1 files changed, 267 insertions, 0 deletions
diff --git a/gst/deinterlace2/gstdeinterlace2.h b/gst/deinterlace2/gstdeinterlace2.h new file mode 100644 index 00000000..0f19484f --- /dev/null +++ b/gst/deinterlace2/gstdeinterlace2.h @@ -0,0 +1,267 @@ +/* + * GStreamer + * Copyright (C) 2005 Martin Eikermann <meiker@upb.de> + * Copyright (C) 2008 Sebastian Dröge <slomo@circular-chaos.org> + * + * 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_DEINTERLACE_2_H__ +#define __GST_DEINTERLACE_2_H__ + +#include <liboil/liboil.h> +#include <liboil/liboilfunction.h> +#include <liboil/liboilcpu.h> + +#include <gst/gst.h> +#include <gst/base/gstbasetransform.h> + +G_BEGIN_DECLS + +#define GST_TYPE_DEINTERLACE2 \ + (gst_deinterlace2_get_type()) +#define GST_DEINTERLACE2(obj) \ + (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DEINTERLACE2,GstDeinterlace2)) +#define GST_DEINTERLACE2_CLASS(klass) \ + (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_DEINTERLACE2,GstDeinterlace2)) +#define GST_IS_DEINTERLACE2(obj) \ + (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DEINTERLACE2)) +#define GST_IS_DEINTERLACE2_CLASS(obj) \ + (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_DEINTERLACE2)) + +typedef struct _GstDeinterlace2 GstDeinterlace2; +typedef struct _GstDeinterlace2Class GstDeinterlace2Class; + +typedef struct deinterlace_setting_s deinterlace_setting_t; +typedef struct deinterlace_method_s deinterlace_method_t; +typedef struct deinterlace_scanline_data_s deinterlace_scanline_data_t; +typedef struct deinterlace_frame_data_s deinterlace_frame_data_t; + +/** + * There are two scanline functions that every deinterlacer plugin + * must implement to do its work: one for a 'copy' and one for + * an 'interpolate' for the currently active field. This so so that + * while plugins may be delaying fields, the external API assumes that + * the plugin is completely realtime. + * + * Each deinterlacing routine can require data from up to four fields. + * The most recent field captured is field 0, and increasing numbers go + * backwards in time. + */ +struct deinterlace_scanline_data_s +{ + guint8 *tt0, *t0, *m0, *b0, *bb0; + guint8 *tt1, *t1, *m1, *b1, *bb1; + guint8 *tt2, *t2, *m2, *b2, *bb2; + guint8 *tt3, *t3, *m3, *b3, *bb3; + int bottom_field; +}; + +/** + * | t-3 t-2 t-1 t + * | Field 3 | Field 2 | Field 1 | Field 0 | + * | TT3 | | TT1 | | + * | | T2 | | T0 | + * | M3 | | M1 | | + * | | B2 | | B0 | + * | BB3 | | BB1 | | + * + * While all pointers are passed in, each plugin is only guarenteed for + * the ones it indicates it requires (in the fields_required parameter) + * to be available. + * + * Pointers are always to scanlines in the standard packed 4:2:2 format. + */ +typedef void (*deinterlace_interp_scanline_t) (GstDeinterlace2 * object, + deinterlace_scanline_data_t * data, guint8 * output); +/** + * For the copy scanline, the API is basically the same, except that + * we're given a scanline to 'copy'. + * + * | t-3 t-2 t-1 t + * | Field 3 | Field 2 | Field 1 | Field 0 | + * | | TT2 | | TT0 | + * | T3 | | T1 | | + * | | M2 | | M0 | + * | B3 | | B1 | | + * | | BB2 | | BB0 | + */ +typedef void (*deinterlace_copy_scanline_t) (GstDeinterlace2 * object, + deinterlace_scanline_data_t * data, guint8 * output); + +/** + * The frame function is for deinterlacing plugins that can only act + * on whole frames, rather than on a scanline at a time. + */ +struct deinterlace_frame_data_s +{ + guint8 *f0; + guint8 *f1; + guint8 *f2; + guint8 *f3; +}; + +typedef void (*deinterlace_frame_t) (GstDeinterlace2 * object); + + +/** + * This structure defines the deinterlacer plugin. + */ +struct deinterlace_method_s +{ + int version; + const char *name; + const char *short_name; + int fields_required; + int accelrequired; + int doscalerbob; + int numsettings; + deinterlace_setting_t *settings; + int scanlinemode; + deinterlace_interp_scanline_t interpolate_scanline; + deinterlace_copy_scanline_t copy_scanline; + deinterlace_frame_t deinterlace_frame; + const char *description[10]; +}; + +/** + * Registers a new deinterlace method. + */ +void register_deinterlace_method (deinterlace_method_t * method); + +/** + * Returns how many deinterlacing methods are available. + */ +int get_num_deinterlace_methods (void); + +/** + * Returns the specified method in the list. + */ +deinterlace_method_t *get_deinterlace_method (int i); + +/** + * Builds the usable method list. + */ +void filter_deinterlace_methods (int accel, int fieldsavailable); + +#define MAX_FIELD_HISTORY 10 + +#define PICTURE_PROGRESSIVE 0 +#define PICTURE_INTERLACED_BOTTOM 1 +#define PICTURE_INTERLACED_TOP 2 +#define PICTURE_INTERLACED_MASK (PICTURE_INTERLACED_BOTTOM | PICTURE_INTERLACED_TOP) + +typedef void (MEMCPY_FUNC) (void *pOutput, const void *pInput, size_t nSize); + +typedef struct +{ + /* pointer to the start of data for this field */ + GstBuffer *buf; + /* see PICTURE_ flags */ + guint flags; +} GstPicture; + +typedef enum +{ + GST_DEINTERLACE2_TOM, + GST_DEINTERLACE2_GREEDY_H, + GST_DEINTERLACE2_GREEDY_L, + GST_DEINTERLACE2_VFIR +} GstDeinterlace2Methods; + +typedef enum +{ + GST_DEINTERLACE2_ALL, /* All (missing data is interp.) */ + GST_DEINTERLACE2_TF, /* Top Fields Only */ + GST_DEINTERLACE2_BF /* Bottom Fields Only */ +} GstDeinterlace2Fields; + +typedef enum +{ + GST_DEINTERLACE2_LAYOUT_AUTO, + GST_DEINTERLACE2_LAYOUT_TFF, + GST_DEINTERLACE2_LAYOUT_BFF +} GstDeinterlace2FieldLayout; + +struct _GstDeinterlace2 +{ + GstElement parent; + + GstPad *srcpad, *sinkpad; + + guint history_count; + + guint cpu_feature_flags; + GstDeinterlace2FieldLayout field_layout; + + guint frame_size; + gint frame_rate_n, frame_rate_d; + + GstDeinterlace2Fields fields; + + GstDeinterlace2Methods method_id; + deinterlace_method_t *method; + + /* The most recent pictures + PictureHistory[0] is always the most recent. + Pointers are NULL if the picture in question isn't valid, e.g. because + the program just started or a picture was skipped. + */ + GstPicture field_history[MAX_FIELD_HISTORY]; + + /* Current overlay buffer pointer. */ + GstBuffer *out_buf; + + /* Overlay pitch (number of bytes between scanlines). */ + guint output_stride; + + /* Number of bytes of actual data in each scanline. May be less than + OverlayPitch since the overlay's scanlines might have alignment + requirements. Generally equal to FrameWidth * 2. + */ + guint line_length; + + /* Number of pixels in each scanline. */ + gint frame_width; + + /* Number of scanlines per frame. */ + gint frame_height; + + /* Number of scanlines per field. FrameHeight / 2, mostly for + cleanliness so we don't have to keep dividing FrameHeight by 2. + */ + gint field_height; + + /* Function pointer to optimized memcpy function */ + MEMCPY_FUNC *pMemcpy; + + /* distance between lines in image + need not match the pixel width + */ + guint field_stride; + + gboolean bottom_field; +}; + +struct _GstDeinterlace2Class +{ + GstElementClass parent_class; +}; + +GType gst_deinterlace2_get_type (void); + +G_END_DECLS +#endif /* __GST_DEINTERLACE_2_H__ */ |