2 * Copyright (C) <2002> David A. Schleef <ds@schleef.org>
3 * Copyright (C) <1999> Erik Walthinsen <omega@cse.ogi.edu>
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Library General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Library General Public License for more details.
15 * You should have received a copy of the GNU Library General Public
16 * License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
18 * Boston, MA 02110-1301, USA.
21 #ifndef __GST_VIDEO_TEST_SRC_H__
22 #define __GST_VIDEO_TEST_SRC_H__
25 #include <gst/base/gstpushsrc.h>
27 #include <gst/video/gstvideometa.h>
28 #include <gst/video/gstvideopool.h>
32 #define GST_TYPE_VIDEO_TEST_SRC \
33 (gst_video_test_src_get_type())
34 #define GST_VIDEO_TEST_SRC(obj) \
35 (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_VIDEO_TEST_SRC,GstVideoTestSrc))
36 #define GST_VIDEO_TEST_SRC_CLASS(klass) \
37 (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_VIDEO_TEST_SRC,GstVideoTestSrcClass))
38 #define GST_IS_VIDEO_TEST_SRC(obj) \
39 (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_VIDEO_TEST_SRC))
40 #define GST_IS_VIDEO_TEST_SRC_CLASS(klass) \
41 (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_VIDEO_TEST_SRC))
44 * GstVideoTestSrcPattern:
45 * @GST_VIDEO_TEST_SRC_SMPTE: A standard SMPTE test pattern
46 * @GST_VIDEO_TEST_SRC_SNOW: Random noise
47 * @GST_VIDEO_TEST_SRC_BLACK: A black image
48 * @GST_VIDEO_TEST_SRC_WHITE: A white image
49 * @GST_VIDEO_TEST_SRC_RED: A red image
50 * @GST_VIDEO_TEST_SRC_GREEN: A green image
51 * @GST_VIDEO_TEST_SRC_BLUE: A blue image
52 * @GST_VIDEO_TEST_SRC_CHECKERS1: Checkers pattern (1px)
53 * @GST_VIDEO_TEST_SRC_CHECKERS2: Checkers pattern (2px)
54 * @GST_VIDEO_TEST_SRC_CHECKERS4: Checkers pattern (4px)
55 * @GST_VIDEO_TEST_SRC_CHECKERS8: Checkers pattern (8px)
56 * @GST_VIDEO_TEST_SRC_CIRCULAR: Circular pattern
57 * @GST_VIDEO_TEST_SRC_BLINK: Alternate between black and white
58 * @GST_VIDEO_TEST_SRC_SMPTE75: SMPTE test pattern (75% color bars)
59 * @GST_VIDEO_TEST_SRC_ZONE_PLATE: Zone plate
60 * @GST_VIDEO_TEST_SRC_GAMUT: Gamut checking pattern
61 * @GST_VIDEO_TEST_SRC_CHROMA_ZONE_PLATE: Chroma zone plate
62 * @GST_VIDEO_TEST_SRC_BALL: Moving ball
63 * @GST_VIDEO_TEST_SRC_SMPTE100: SMPTE test pattern (100% color bars)
64 * @GST_VIDEO_TEST_SRC_BAR: Bar with foreground color
66 * The test pattern to produce.
68 * The Gamut pattern creates a checkerboard pattern of colors at the
69 * edge of the YCbCr gamut and nearby colors that are out of gamut.
70 * The pattern is divided into 4 regions: black, white, red, and blue.
71 * After conversion to RGB, the out-of-gamut colors should be converted
72 * to the same value as their in-gamut neighbors. If the checkerboard
73 * pattern is still visible after conversion, this indicates a faulty
74 * conversion. Image manipulation, such as adjusting contrast or
75 * brightness, can also cause the pattern to be visible.
77 * The Zone Plate pattern is based on BBC R&D Report 1978/23, and can
78 * be used to test spatial frequency response of a system. This
79 * pattern generator is controlled by the xoffset and yoffset parameters
80 * and also by all the parameters starting with 'k'. The default
81 * parameters produce a grey pattern. Try 'videotestsrc
82 * pattern=zone-plate kx2=20 ky2=20 kt=1' to produce something
86 GST_VIDEO_TEST_SRC_SMPTE,
87 GST_VIDEO_TEST_SRC_SNOW,
88 GST_VIDEO_TEST_SRC_BLACK,
89 GST_VIDEO_TEST_SRC_WHITE,
90 GST_VIDEO_TEST_SRC_RED,
91 GST_VIDEO_TEST_SRC_GREEN,
92 GST_VIDEO_TEST_SRC_BLUE,
93 GST_VIDEO_TEST_SRC_CHECKERS1,
94 GST_VIDEO_TEST_SRC_CHECKERS2,
95 GST_VIDEO_TEST_SRC_CHECKERS4,
96 GST_VIDEO_TEST_SRC_CHECKERS8,
97 GST_VIDEO_TEST_SRC_CIRCULAR,
98 GST_VIDEO_TEST_SRC_BLINK,
99 GST_VIDEO_TEST_SRC_SMPTE75,
100 GST_VIDEO_TEST_SRC_ZONE_PLATE,
101 GST_VIDEO_TEST_SRC_GAMUT,
102 GST_VIDEO_TEST_SRC_CHROMA_ZONE_PLATE,
103 GST_VIDEO_TEST_SRC_SOLID,
104 GST_VIDEO_TEST_SRC_BALL,
105 GST_VIDEO_TEST_SRC_SMPTE100,
106 GST_VIDEO_TEST_SRC_BAR
107 } GstVideoTestSrcPattern;
109 typedef struct _GstVideoTestSrc GstVideoTestSrc;
110 typedef struct _GstVideoTestSrcClass GstVideoTestSrcClass;
115 * Opaque data structure.
117 struct _GstVideoTestSrc {
123 GstVideoTestSrcPattern pattern_type;
132 gint64 timestamp_offset; /* base offset */
134 /* running time and frames for current caps */
135 GstClockTime running_time; /* total running time */
136 gint64 n_frames; /* total frames sent */
138 /* previous caps running time and frames */
139 GstClockTime accum_rtime; /* accumulated running_time */
140 gint64 accum_frames; /* accumulated frames */
157 guint foreground_color;
158 guint background_color;
160 /* moving color bars */
161 gint horizontal_offset;
162 gint horizontal_speed;
164 void (*make_image) (GstVideoTestSrc *v, GstVideoFrame *frame);
166 /* temporary AYUV/ARGB scanline */
170 guint16 *tmpline_u16;
173 struct _GstVideoTestSrcClass {
174 GstPushSrcClass parent_class;
177 GType gst_video_test_src_get_type (void);
181 #endif /* __GST_VIDEO_TEST_SRC_H__ */