1 /*M///////////////////////////////////////////////////////////////////////////////////////
2 //
3 //  IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
4 //
5 //  By downloading, copying, installing or using the software you agree to this license.
6 //  If you do not agree to this license, do not download, install,
7 //  copy or use the software.
8 //
9 //
10 //                          License Agreement
11 //                For Open Source Computer Vision Library
12 //
13 // Copyright (C) 2000-2008, Intel Corporation, all rights reserved.
14 // Copyright (C) 2009, Willow Garage Inc., all rights reserved.
15 // Copyright (C) 2013, OpenCV Foundation, all rights reserved.
16 // Third party copyrights are property of their respective owners.
17 //
18 // Redistribution and use in source and binary forms, with or without modification,
19 // are permitted provided that the following conditions are met:
20 //
21 //   * Redistribution's of source code must retain the above copyright notice,
22 //     this list of conditions and the following disclaimer.
23 //
24 //   * Redistribution's in binary form must reproduce the above copyright notice,
25 //     this list of conditions and the following disclaimer in the documentation
26 //     and/or other materials provided with the distribution.
27 //
28 //   * The name of the copyright holders may not be used to endorse or promote products
29 //     derived from this software without specific prior written permission.
30 //
31 // This software is provided by the copyright holders and contributors "as is" and
32 // any express or implied warranties, including, but not limited to, the implied
33 // warranties of merchantability and fitness for a particular purpose are disclaimed.
34 // In no event shall the Intel Corporation or contributors be liable for any direct,
35 // indirect, incidental, special, exemplary, or consequential damages
36 // (including, but not limited to, procurement of substitute goods or services;
37 // loss of use, data, or profits; or business interruption) however caused
38 // and on any theory of liability, whether in contract, strict liability,
39 // or tort (including negligence or otherwise) arising in any way out of
40 // the use of this software, even if advised of the possibility of such damage.
41 //
42 //M*/
43 
44 #ifndef __FRAME_QUEUE_HPP__
45 #define __FRAME_QUEUE_HPP__
46 
47 #include "opencv2/core/utility.hpp"
48 #include "opencv2/core/private.cuda.hpp"
49 
50 #include <nvcuvid.h>
51 
52 namespace cv { namespace cudacodec { namespace detail
53 {
54 
55 class FrameQueue
56 {
57 public:
58     static const int MaximumSize = 20; // MAX_FRM_CNT;
59 
60     FrameQueue();
61 
endDecode()62     void endDecode() { endOfDecode_ = true; }
isEndOfDecode() const63     bool isEndOfDecode() const { return endOfDecode_ != 0;}
64 
65     // Spins until frame becomes available or decoding gets canceled.
66     // If the requested frame is available the method returns true.
67     // If decoding was interupted before the requested frame becomes
68     // available, the method returns false.
69     bool waitUntilFrameAvailable(int pictureIndex);
70 
71     void enqueue(const CUVIDPARSERDISPINFO* picParams);
72 
73     // Deque the next frame.
74     // Parameters:
75     //      displayInfo - New frame info gets placed into this object.
76     // Returns:
77     //      true, if a new frame was returned,
78     //      false, if the queue was empty and no new frame could be returned.
79     bool dequeue(CUVIDPARSERDISPINFO& displayInfo);
80 
releaseFrame(const CUVIDPARSERDISPINFO & picParams)81     void releaseFrame(const CUVIDPARSERDISPINFO& picParams) { isFrameInUse_[picParams.picture_index] = false; }
82 
83 private:
isInUse(int pictureIndex) const84     bool isInUse(int pictureIndex) const { return isFrameInUse_[pictureIndex] != 0; }
85 
86     Mutex mtx_;
87 
88     volatile int isFrameInUse_[MaximumSize];
89     volatile int endOfDecode_;
90 
91     int framesInQueue_;
92     int readPosition_;
93     CUVIDPARSERDISPINFO displayQueue_[MaximumSize];
94 };
95 
96 }}}
97 
98 #endif // __FRAME_QUEUE_HPP__
99