mirror of
https://github.com/opencv/opencv.git
synced 2024-12-03 00:10:21 +08:00
76211709a3
also refactored VideoSource interface (made it simplier, now it has only 2 abstract methods)
154 lines
3.5 KiB
ReStructuredText
154 lines
3.5 KiB
ReStructuredText
Video Decoding
|
|
==============
|
|
|
|
.. highlight:: cpp
|
|
|
|
|
|
|
|
gpucodec::VideoReader
|
|
---------------------
|
|
Video reader interface.
|
|
|
|
.. ocv:class:: gpucodec::VideoReader
|
|
|
|
|
|
|
|
gpucodec::VideoReader::nextFrame
|
|
--------------------------------
|
|
Grabs, decodes and returns the next video frame.
|
|
|
|
.. ocv:function:: bool gpucodec::VideoReader::nextFrame(OutputArray frame)
|
|
|
|
If no frames has been grabbed (there are no more frames in video file), the methods return ``false`` . The method throws :ocv:class:`Exception` if error occurs.
|
|
|
|
|
|
|
|
gpucodec::VideoReader::format
|
|
-----------------------------
|
|
Returns information about video file format.
|
|
|
|
.. ocv:function:: FormatInfo gpucodec::VideoReader::format() const
|
|
|
|
|
|
|
|
gpucodec::Codec
|
|
---------------
|
|
Video codecs supported by :ocv:class:`gpucodec::VideoReader` .
|
|
|
|
.. ocv:enum:: gpucodec::Codec
|
|
|
|
.. ocv:emember:: MPEG1 = 0
|
|
.. ocv:emember:: MPEG2
|
|
.. ocv:emember:: MPEG4
|
|
.. ocv:emember:: VC1
|
|
.. ocv:emember:: H264
|
|
.. ocv:emember:: JPEG
|
|
.. ocv:emember:: H264_SVC
|
|
.. ocv:emember:: H264_MVC
|
|
|
|
.. ocv:emember:: Uncompressed_YUV420 = (('I'<<24)|('Y'<<16)|('U'<<8)|('V'))
|
|
|
|
Y,U,V (4:2:0)
|
|
|
|
.. ocv:emember:: Uncompressed_YV12 = (('Y'<<24)|('V'<<16)|('1'<<8)|('2'))
|
|
|
|
Y,V,U (4:2:0)
|
|
|
|
.. ocv:emember:: Uncompressed_NV12 = (('N'<<24)|('V'<<16)|('1'<<8)|('2'))
|
|
|
|
Y,UV (4:2:0)
|
|
|
|
.. ocv:emember:: Uncompressed_YUYV = (('Y'<<24)|('U'<<16)|('Y'<<8)|('V'))
|
|
|
|
YUYV/YUY2 (4:2:2)
|
|
|
|
.. ocv:emember:: Uncompressed_UYVY = (('U'<<24)|('Y'<<16)|('V'<<8)|('Y'))
|
|
|
|
UYVY (4:2:2)
|
|
|
|
|
|
|
|
gpucodec::ChromaFormat
|
|
----------------------
|
|
Chroma formats supported by :ocv:class:`gpucodec::VideoReader` .
|
|
|
|
.. ocv:enum:: gpucodec::ChromaFormat
|
|
|
|
.. ocv:emember:: Monochrome = 0
|
|
.. ocv:emember:: YUV420
|
|
.. ocv:emember:: YUV422
|
|
.. ocv:emember:: YUV444
|
|
|
|
|
|
|
|
gpucodec::FormatInfo
|
|
--------------------
|
|
.. ocv:struct:: gpucodec::FormatInfo
|
|
|
|
Struct providing information about video file format. ::
|
|
|
|
struct FormatInfo
|
|
{
|
|
Codec codec;
|
|
ChromaFormat chromaFormat;
|
|
int width;
|
|
int height;
|
|
};
|
|
|
|
|
|
|
|
gpucodec::createVideoReader
|
|
---------------------------
|
|
Creates video reader.
|
|
|
|
.. ocv:function:: Ptr<VideoReader> gpucodec::createVideoReader(const String& filename)
|
|
.. ocv:function:: Ptr<VideoReader> gpucodec::createVideoReader(const Ptr<RawVideoSource>& source)
|
|
|
|
:param filename: Name of the input video file.
|
|
|
|
:param source: RAW video source implemented by user.
|
|
|
|
FFMPEG is used to read videos. User can implement own demultiplexing with :ocv:class:`gpucodec::RawVideoSource` .
|
|
|
|
|
|
|
|
gpucodec::RawVideoSource
|
|
------------------------
|
|
.. ocv:class:: gpucodec::RawVideoSource
|
|
|
|
Interface for video demultiplexing. ::
|
|
|
|
class RawVideoSource
|
|
{
|
|
public:
|
|
virtual ~RawVideoSource() {}
|
|
|
|
virtual bool getNextPacket(unsigned char** data, int* size, bool* endOfFile) = 0;
|
|
|
|
virtual FormatInfo format() const = 0;
|
|
};
|
|
|
|
User can implement own demultiplexing by implementing this interface.
|
|
|
|
|
|
|
|
gpucodec::RawVideoSource::getNextPacket
|
|
---------------------------------------
|
|
Returns next packet with RAW video frame.
|
|
|
|
.. ocv:function:: bool gpucodec::VideoSource::getNextPacket(unsigned char** data, int* size, bool* endOfFile) = 0
|
|
|
|
:param data: Pointer to frame data.
|
|
|
|
:param size: Size in bytes of current frame.
|
|
|
|
:param endOfStream: Indicates that it is end of stream.
|
|
|
|
|
|
|
|
gpucodec::RawVideoSource::format
|
|
--------------------------------
|
|
Returns information about video file format.
|
|
|
|
.. ocv:function:: virtual FormatInfo gpucodec::RawVideoSource::format() const = 0
|