1 /*
2 * Copyright (c) 2013 The WebM project authors. All Rights Reserved.
3 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
11 #include <string>
12
13 #include "third_party/googletest/src/include/gtest/gtest.h"
14 #include "./vpx_config.h"
15 #include "test/codec_factory.h"
16 #include "test/decode_test_driver.h"
17 #include "test/md5_helper.h"
18 #if CONFIG_WEBM_IO
19 #include "test/webm_video_source.h"
20 #endif
21 #include "vpx_util/vpx_thread.h"
22
23 namespace {
24
25 using std::string;
26
27 class VPxWorkerThreadTest : public ::testing::TestWithParam<bool> {
28 protected:
~VPxWorkerThreadTest()29 virtual ~VPxWorkerThreadTest() {}
SetUp()30 virtual void SetUp() { vpx_get_worker_interface()->init(&worker_); }
31
TearDown()32 virtual void TearDown() { vpx_get_worker_interface()->end(&worker_); }
33
Run(VPxWorker * worker)34 void Run(VPxWorker *worker) {
35 const bool synchronous = GetParam();
36 if (synchronous) {
37 vpx_get_worker_interface()->execute(worker);
38 } else {
39 vpx_get_worker_interface()->launch(worker);
40 }
41 }
42
43 VPxWorker worker_;
44 };
45
ThreadHook(void * data,void * return_value)46 int ThreadHook(void *data, void *return_value) {
47 int *const hook_data = reinterpret_cast<int *>(data);
48 *hook_data = 5;
49 return *reinterpret_cast<int *>(return_value);
50 }
51
TEST_P(VPxWorkerThreadTest,HookSuccess)52 TEST_P(VPxWorkerThreadTest, HookSuccess) {
53 // should be a no-op.
54 EXPECT_NE(vpx_get_worker_interface()->sync(&worker_), 0);
55
56 for (int i = 0; i < 2; ++i) {
57 EXPECT_NE(vpx_get_worker_interface()->reset(&worker_), 0);
58
59 int hook_data = 0;
60 int return_value = 1; // return successfully from the hook
61 worker_.hook = ThreadHook;
62 worker_.data1 = &hook_data;
63 worker_.data2 = &return_value;
64
65 Run(&worker_);
66 EXPECT_NE(vpx_get_worker_interface()->sync(&worker_), 0);
67 EXPECT_FALSE(worker_.had_error);
68 EXPECT_EQ(5, hook_data);
69
70 // should be a no-op.
71 EXPECT_NE(vpx_get_worker_interface()->sync(&worker_), 0);
72 }
73 }
74
TEST_P(VPxWorkerThreadTest,HookFailure)75 TEST_P(VPxWorkerThreadTest, HookFailure) {
76 EXPECT_NE(vpx_get_worker_interface()->reset(&worker_), 0);
77
78 int hook_data = 0;
79 int return_value = 0; // return failure from the hook
80 worker_.hook = ThreadHook;
81 worker_.data1 = &hook_data;
82 worker_.data2 = &return_value;
83
84 Run(&worker_);
85 EXPECT_FALSE(vpx_get_worker_interface()->sync(&worker_));
86 EXPECT_EQ(1, worker_.had_error);
87
88 // Ensure _reset() clears the error and _launch() can be called again.
89 return_value = 1;
90 EXPECT_NE(vpx_get_worker_interface()->reset(&worker_), 0);
91 EXPECT_FALSE(worker_.had_error);
92 vpx_get_worker_interface()->launch(&worker_);
93 EXPECT_NE(vpx_get_worker_interface()->sync(&worker_), 0);
94 EXPECT_FALSE(worker_.had_error);
95 }
96
TEST_P(VPxWorkerThreadTest,EndWithoutSync)97 TEST_P(VPxWorkerThreadTest, EndWithoutSync) {
98 // Create a large number of threads to increase the chances of detecting a
99 // race. Doing more work in the hook is no guarantee as any race would occur
100 // post hook execution in the main thread loop driver.
101 static const int kNumWorkers = 64;
102 VPxWorker workers[kNumWorkers];
103 int hook_data[kNumWorkers];
104 int return_value[kNumWorkers];
105
106 for (int n = 0; n < kNumWorkers; ++n) {
107 vpx_get_worker_interface()->init(&workers[n]);
108 return_value[n] = 1; // return successfully from the hook
109 workers[n].hook = ThreadHook;
110 workers[n].data1 = &hook_data[n];
111 workers[n].data2 = &return_value[n];
112 }
113
114 for (int i = 0; i < 2; ++i) {
115 for (int n = 0; n < kNumWorkers; ++n) {
116 EXPECT_NE(vpx_get_worker_interface()->reset(&workers[n]), 0);
117 hook_data[n] = 0;
118 }
119
120 for (int n = 0; n < kNumWorkers; ++n) {
121 Run(&workers[n]);
122 }
123
124 for (int n = kNumWorkers - 1; n >= 0; --n) {
125 vpx_get_worker_interface()->end(&workers[n]);
126 }
127 }
128 }
129
TEST(VPxWorkerThreadTest,TestInterfaceAPI)130 TEST(VPxWorkerThreadTest, TestInterfaceAPI) {
131 EXPECT_EQ(0, vpx_set_worker_interface(NULL));
132 EXPECT_TRUE(vpx_get_worker_interface() != NULL);
133 for (int i = 0; i < 6; ++i) {
134 VPxWorkerInterface winterface = *vpx_get_worker_interface();
135 switch (i) {
136 default:
137 case 0: winterface.init = NULL; break;
138 case 1: winterface.reset = NULL; break;
139 case 2: winterface.sync = NULL; break;
140 case 3: winterface.launch = NULL; break;
141 case 4: winterface.execute = NULL; break;
142 case 5: winterface.end = NULL; break;
143 }
144 EXPECT_EQ(0, vpx_set_worker_interface(&winterface));
145 }
146 }
147
148 // -----------------------------------------------------------------------------
149 // Multi-threaded decode tests
150 #if CONFIG_WEBM_IO
151 struct FileList {
152 const char *name;
153 const char *expected_md5;
154 };
155
156 // Decodes |filename| with |num_threads|. Returns the md5 of the decoded frames.
DecodeFile(const string & filename,int num_threads)157 string DecodeFile(const string &filename, int num_threads) {
158 libvpx_test::WebMVideoSource video(filename);
159 video.Init();
160
161 vpx_codec_dec_cfg_t cfg = vpx_codec_dec_cfg_t();
162 cfg.threads = num_threads;
163 libvpx_test::VP9Decoder decoder(cfg, 0);
164
165 libvpx_test::MD5 md5;
166 for (video.Begin(); video.cxdata(); video.Next()) {
167 const vpx_codec_err_t res =
168 decoder.DecodeFrame(video.cxdata(), video.frame_size());
169 if (res != VPX_CODEC_OK) {
170 EXPECT_EQ(VPX_CODEC_OK, res) << decoder.DecodeError();
171 break;
172 }
173
174 libvpx_test::DxDataIterator dec_iter = decoder.GetDxData();
175 const vpx_image_t *img = NULL;
176
177 // Get decompressed data
178 while ((img = dec_iter.Next())) {
179 md5.Add(img);
180 }
181 }
182 return string(md5.Get());
183 }
184
DecodeFiles(const FileList files[])185 void DecodeFiles(const FileList files[]) {
186 for (const FileList *iter = files; iter->name != NULL; ++iter) {
187 SCOPED_TRACE(iter->name);
188 for (int t = 1; t <= 8; ++t) {
189 EXPECT_EQ(iter->expected_md5, DecodeFile(iter->name, t))
190 << "threads = " << t;
191 }
192 }
193 }
194
195 // Trivial serialized thread worker interface implementation.
196 // Note any worker that requires synchronization between other workers will
197 // hang.
198 namespace impl {
199 namespace {
200
Init(VPxWorker * const worker)201 void Init(VPxWorker *const worker) { memset(worker, 0, sizeof(*worker)); }
Reset(VPxWorker * const)202 int Reset(VPxWorker *const /*worker*/) { return 1; }
Sync(VPxWorker * const worker)203 int Sync(VPxWorker *const worker) { return !worker->had_error; }
204
Execute(VPxWorker * const worker)205 void Execute(VPxWorker *const worker) {
206 worker->had_error |= !worker->hook(worker->data1, worker->data2);
207 }
208
Launch(VPxWorker * const worker)209 void Launch(VPxWorker *const worker) { Execute(worker); }
End(VPxWorker * const)210 void End(VPxWorker *const /*worker*/) {}
211
212 } // namespace
213 } // namespace impl
214
TEST(VPxWorkerThreadTest,TestSerialInterface)215 TEST(VPxWorkerThreadTest, TestSerialInterface) {
216 static const VPxWorkerInterface serial_interface = {
217 impl::Init, impl::Reset, impl::Sync, impl::Launch, impl::Execute, impl::End
218 };
219 // TODO(jzern): Avoid using a file that will use the row-based thread
220 // loopfilter, with the simple serialized implementation it will hang. This is
221 // due to its expectation that rows will be run in parallel as they wait on
222 // progress in the row above before proceeding.
223 static const char expected_md5[] = "b35a1b707b28e82be025d960aba039bc";
224 static const char filename[] = "vp90-2-03-size-226x226.webm";
225 VPxWorkerInterface default_interface = *vpx_get_worker_interface();
226
227 EXPECT_NE(vpx_set_worker_interface(&serial_interface), 0);
228 EXPECT_EQ(expected_md5, DecodeFile(filename, 2));
229
230 // Reset the interface.
231 EXPECT_NE(vpx_set_worker_interface(&default_interface), 0);
232 EXPECT_EQ(expected_md5, DecodeFile(filename, 2));
233 }
234
TEST(VP9DecodeMultiThreadedTest,NoTilesNonFrameParallel)235 TEST(VP9DecodeMultiThreadedTest, NoTilesNonFrameParallel) {
236 // no tiles or frame parallel; this exercises loop filter threading.
237 EXPECT_EQ("b35a1b707b28e82be025d960aba039bc",
238 DecodeFile("vp90-2-03-size-226x226.webm", 2));
239 }
240
TEST(VP9DecodeMultiThreadedTest,FrameParallel)241 TEST(VP9DecodeMultiThreadedTest, FrameParallel) {
242 static const FileList files[] = { { "vp90-2-08-tile_1x2_frame_parallel.webm",
243 "68ede6abd66bae0a2edf2eb9232241b6" },
244 { "vp90-2-08-tile_1x4_frame_parallel.webm",
245 "368ebc6ebf3a5e478d85b2c3149b2848" },
246 { "vp90-2-08-tile_1x8_frame_parallel.webm",
247 "17e439da2388aff3a0f69cb22579c6c1" },
248 { NULL, NULL } };
249
250 DecodeFiles(files);
251 }
252
TEST(VP9DecodeMultiThreadedTest,FrameParallelResize)253 TEST(VP9DecodeMultiThreadedTest, FrameParallelResize) {
254 static const FileList files[] = {
255 { "vp90-2-14-resize-fp-tiles-1-16.webm",
256 "0cd5e632c326297e975f38949c31ea94" },
257 { "vp90-2-14-resize-fp-tiles-1-2-4-8-16.webm",
258 "5c78a96a42e7f4a4f6b2edcdb791e44c" },
259 { "vp90-2-14-resize-fp-tiles-1-2.webm",
260 "e030450ae85c3277be2a418769df98e2" },
261 { "vp90-2-14-resize-fp-tiles-1-4.webm",
262 "312eed4e2b64eb7a4e7f18916606a430" },
263 { "vp90-2-14-resize-fp-tiles-16-1.webm",
264 "1755c16d8af16a9cb3fe7338d90abe52" },
265 { "vp90-2-14-resize-fp-tiles-16-2.webm",
266 "500300592d3fcb6f12fab25e48aaf4df" },
267 { "vp90-2-14-resize-fp-tiles-16-4.webm",
268 "47c48379fa6331215d91c67648e1af6e" },
269 { "vp90-2-14-resize-fp-tiles-16-8-4-2-1.webm",
270 "eecf17290739bc708506fa4827665989" },
271 { "vp90-2-14-resize-fp-tiles-16-8.webm",
272 "29b6bb54e4c26b5ca85d5de5fed94e76" },
273 { "vp90-2-14-resize-fp-tiles-1-8.webm",
274 "1b6f175e08cd82cf84bb800ac6d1caa3" },
275 { "vp90-2-14-resize-fp-tiles-2-16.webm",
276 "ca3b03e4197995d8d5444ede7a6c0804" },
277 { "vp90-2-14-resize-fp-tiles-2-1.webm",
278 "99aec065369d70bbb78ccdff65afed3f" },
279 { "vp90-2-14-resize-fp-tiles-2-4.webm",
280 "22d0ebdb49b87d2920a85aea32e1afd5" },
281 { "vp90-2-14-resize-fp-tiles-2-8.webm",
282 "c2115cf051c62e0f7db1d4a783831541" },
283 { "vp90-2-14-resize-fp-tiles-4-16.webm",
284 "c690d7e1719b31367564cac0af0939cb" },
285 { "vp90-2-14-resize-fp-tiles-4-1.webm",
286 "a926020b2cc3e15ad4cc271853a0ff26" },
287 { "vp90-2-14-resize-fp-tiles-4-2.webm",
288 "42699063d9e581f1993d0cf890c2be78" },
289 { "vp90-2-14-resize-fp-tiles-4-8.webm",
290 "7f76d96036382f45121e3d5aa6f8ec52" },
291 { "vp90-2-14-resize-fp-tiles-8-16.webm",
292 "76a43fcdd7e658542913ea43216ec55d" },
293 { "vp90-2-14-resize-fp-tiles-8-1.webm",
294 "8e3fbe89486ca60a59299dea9da91378" },
295 { "vp90-2-14-resize-fp-tiles-8-2.webm",
296 "ae96f21f21b6370cc0125621b441fc52" },
297 { "vp90-2-14-resize-fp-tiles-8-4.webm",
298 "3eb4f24f10640d42218f7fd7b9fd30d4" },
299 { NULL, NULL }
300 };
301
302 DecodeFiles(files);
303 }
304
TEST(VP9DecodeMultiThreadedTest,NonFrameParallel)305 TEST(VP9DecodeMultiThreadedTest, NonFrameParallel) {
306 static const FileList files[] = {
307 { "vp90-2-08-tile_1x2.webm", "570b4a5d5a70d58b5359671668328a16" },
308 { "vp90-2-08-tile_1x4.webm", "988d86049e884c66909d2d163a09841a" },
309 { "vp90-2-08-tile_1x8.webm", "0941902a52e9092cb010905eab16364c" },
310 { "vp90-2-08-tile-4x1.webm", "06505aade6647c583c8e00a2f582266f" },
311 { "vp90-2-08-tile-4x4.webm", "85c2299892460d76e2c600502d52bfe2" },
312 { NULL, NULL }
313 };
314
315 DecodeFiles(files);
316 }
317 #endif // CONFIG_WEBM_IO
318
319 INSTANTIATE_TEST_CASE_P(Synchronous, VPxWorkerThreadTest, ::testing::Bool());
320
321 } // namespace
322