3 * Copyright (C) 2005 Martin Eikermann <meiker@upb.de>
4 * Copyright (C) 2008-2010 Sebastian Dröge <slomo@collabora.co.uk>
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.
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.
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.
22 #ifndef __GST_DEINTERLACE_H__
23 #define __GST_DEINTERLACE_H__
26 #include <gst/video/video.h>
27 #include <gst/video/gstvideopool.h>
28 #include <gst/video/gstvideometa.h>
30 #include "gstdeinterlacemethod.h"
34 #define GST_TYPE_DEINTERLACE \
35 (gst_deinterlace_get_type())
36 #define GST_DEINTERLACE(obj) \
37 (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DEINTERLACE,GstDeinterlace))
38 #define GST_DEINTERLACE_CLASS(klass) \
39 (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_DEINTERLACE,GstDeinterlace))
40 #define GST_IS_DEINTERLACE(obj) \
41 (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DEINTERLACE))
42 #define GST_IS_DEINTERLACE_CLASS(obj) \
43 (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_DEINTERLACE))
45 typedef struct _GstDeinterlace GstDeinterlace;
46 typedef struct _GstDeinterlaceClass GstDeinterlaceClass;
50 GST_DEINTERLACE_TOMSMOCOMP,
51 GST_DEINTERLACE_GREEDY_H,
52 GST_DEINTERLACE_GREEDY_L,
54 GST_DEINTERLACE_LINEAR,
55 GST_DEINTERLACE_LINEAR_BLEND,
56 GST_DEINTERLACE_SCALER_BOB,
57 GST_DEINTERLACE_WEAVE,
58 GST_DEINTERLACE_WEAVE_TFF,
59 GST_DEINTERLACE_WEAVE_BFF
60 } GstDeinterlaceMethods;
64 GST_DEINTERLACE_ALL, /* All (missing data is interp.) */
65 GST_DEINTERLACE_TF, /* Top Fields Only */
66 GST_DEINTERLACE_BF, /* Bottom Fields Only */
67 GST_DEINTERLACE_FIELDS_AUTO /* Automatically detect */
68 } GstDeinterlaceFields;
72 GST_DEINTERLACE_LAYOUT_AUTO,
73 GST_DEINTERLACE_LAYOUT_TFF,
74 GST_DEINTERLACE_LAYOUT_BFF
75 } GstDeinterlaceFieldLayout;
78 GST_DEINTERLACE_MODE_AUTO,
79 GST_DEINTERLACE_MODE_INTERLACED,
80 GST_DEINTERLACE_MODE_DISABLED,
81 GST_DEINTERLACE_MODE_AUTO_STRICT
86 GST_DEINTERLACE_LOCKING_NONE,
87 GST_DEINTERLACE_LOCKING_AUTO,
88 GST_DEINTERLACE_LOCKING_ACTIVE,
89 GST_DEINTERLACE_LOCKING_PASSIVE,
90 } GstDeinterlaceLocking;
92 #define GST_DEINTERLACE_MAX_FIELD_HISTORY 10
93 #define GST_DEINTERLACE_MAX_BUFFER_STATE_HISTORY 50
94 /* check max field history is large enough */
95 #if GST_DEINTERLACE_MAX_FIELD_HISTORY < GST_DEINTERLACE_MAX_BUFFER_STATE_HISTORY * 3
96 #undef GST_DEINTERLACE_MAX_FIELD_HISTORY
97 #define GST_DEINTERLACE_MAX_FIELD_HISTORY (GST_DEINTERLACE_MAX_BUFFER_STATE_HISTORY * 3)
100 typedef struct _TelecinePattern TelecinePattern;
101 struct _TelecinePattern
105 guint8 ratio_n, ratio_d;
106 guint8 states[GST_DEINTERLACE_MAX_BUFFER_STATE_HISTORY];
109 typedef struct _GstDeinterlaceBufferState GstDeinterlaceBufferState;
110 struct _GstDeinterlaceBufferState
112 GstClockTime timestamp;
113 GstClockTime duration;
117 struct _GstDeinterlace
121 GstPad *srcpad, *sinkpad;
124 GstDeinterlaceMode mode;
126 GstDeinterlaceFieldLayout field_layout;
128 GstDeinterlaceFields fields;
130 GstDeinterlaceFields user_set_fields;
132 /* current state (differs when flushing/inverse telecine using weave) */
133 GstDeinterlaceMethods method_id;
135 GstDeinterlaceMethods user_set_method_id;
136 GstDeinterlaceMethod *method;
140 GstAllocator *allocator;
141 GstAllocationParams params;
143 gboolean passthrough;
146 GstClockTime field_duration; /* Duration of one field */
148 /* The most recent pictures
149 PictureHistory[0] is always the most recent.
150 Pointers are NULL if the picture in question isn't valid, e.g. because
151 the program just started or a picture was skipped.
153 GstDeinterlaceField field_history[GST_DEINTERLACE_MAX_FIELD_HISTORY];
157 /* Set to TRUE if we're in still frame mode,
158 i.e. just forward all buffers
160 gboolean still_frame_mode;
162 /* Last buffer that was pushed in */
163 GstBuffer *last_buffer;
165 /* Current segment */
170 GstClockTime earliest_time;
174 GstCaps *request_caps;
176 gboolean reconfigure;
177 GstDeinterlaceMode new_mode;
178 GstDeinterlaceFields new_fields;
180 GstDeinterlaceLocking locking;
182 gboolean drop_orphans;
183 gboolean ignore_obscure;
184 gboolean pattern_lock;
185 gboolean pattern_refresh;
186 GstDeinterlaceBufferState buf_states[GST_DEINTERLACE_MAX_BUFFER_STATE_HISTORY];
189 guint8 pattern_phase;
190 guint8 pattern_count;
192 GstClockTime pattern_base_ts;
193 GstClockTime pattern_buf_dur;
197 gboolean telecine_tc_warned;
200 struct _GstDeinterlaceClass
202 GstElementClass parent_class;
205 GType gst_deinterlace_get_type (void);
209 #endif /* __GST_DEINTERLACE_H__ */