mirror of
https://github.com/opencv/opencv.git
synced 2024-12-12 15:19:11 +08:00
190 lines
6.5 KiB
ReStructuredText
190 lines
6.5 KiB
ReStructuredText
Video Encoding
|
|
==============
|
|
|
|
.. highlight:: cpp
|
|
|
|
|
|
|
|
gpucodec::VideoWriter
|
|
---------------------
|
|
Video writer interface.
|
|
|
|
.. ocv:class:: gpucodec::VideoWriter
|
|
|
|
The implementation uses H264 video codec.
|
|
|
|
.. note:: Currently only Windows platform is supported.
|
|
|
|
|
|
|
|
gpucodec::VideoWriter::write
|
|
----------------------------
|
|
Writes the next video frame.
|
|
|
|
.. ocv:function:: void gpucodec::VideoWriter::write(InputArray frame, bool lastFrame = false) = 0
|
|
|
|
:param frame: The written frame.
|
|
|
|
:param lastFrame: Indicates that it is end of stream. The parameter can be ignored.
|
|
|
|
The method write the specified image to video file. The image must have the same size and the same surface format as has been specified when opening the video writer.
|
|
|
|
|
|
|
|
gpucodec::createVideoWriter
|
|
---------------------------
|
|
Creates video writer.
|
|
|
|
.. ocv:function:: Ptr<gpucodec::VideoWriter> gpucodec::createVideoWriter(const String& fileName, Size frameSize, double fps, SurfaceFormat format = SF_BGR)
|
|
.. ocv:function:: Ptr<gpucodec::VideoWriter> gpucodec::createVideoWriter(const String& fileName, Size frameSize, double fps, const EncoderParams& params, SurfaceFormat format = SF_BGR)
|
|
.. ocv:function:: Ptr<gpucodec::VideoWriter> gpucodec::createVideoWriter(const Ptr<EncoderCallBack>& encoderCallback, Size frameSize, double fps, SurfaceFormat format = SF_BGR)
|
|
.. ocv:function:: Ptr<gpucodec::VideoWriter> gpucodec::createVideoWriter(const Ptr<EncoderCallBack>& encoderCallback, Size frameSize, double fps, const EncoderParams& params, SurfaceFormat format = SF_BGR)
|
|
|
|
:param fileName: Name of the output video file. Only AVI file format is supported.
|
|
|
|
:param frameSize: Size of the input video frames.
|
|
|
|
:param fps: Framerate of the created video stream.
|
|
|
|
:param params: Encoder parameters. See :ocv:struct:`gpucodec::EncoderParams` .
|
|
|
|
:param format: Surface format of input frames ( ``SF_UYVY`` , ``SF_YUY2`` , ``SF_YV12`` , ``SF_NV12`` , ``SF_IYUV`` , ``SF_BGR`` or ``SF_GRAY``). BGR or gray frames will be converted to YV12 format before encoding, frames with other formats will be used as is.
|
|
|
|
:param encoderCallback: Callbacks for video encoder. See :ocv:class:`gpucodec::EncoderCallBack` . Use it if you want to work with raw video stream.
|
|
|
|
The constructors initialize video writer. FFMPEG is used to write videos. User can implement own multiplexing with :ocv:class:`gpucodec::EncoderCallBack` .
|
|
|
|
|
|
|
|
gpucodec::EncoderParams
|
|
-----------------------
|
|
.. ocv:struct:: gpucodec::EncoderParams
|
|
|
|
Different parameters for CUDA video encoder. ::
|
|
|
|
struct EncoderParams
|
|
{
|
|
int P_Interval; // NVVE_P_INTERVAL,
|
|
int IDR_Period; // NVVE_IDR_PERIOD,
|
|
int DynamicGOP; // NVVE_DYNAMIC_GOP,
|
|
int RCType; // NVVE_RC_TYPE,
|
|
int AvgBitrate; // NVVE_AVG_BITRATE,
|
|
int PeakBitrate; // NVVE_PEAK_BITRATE,
|
|
int QP_Level_Intra; // NVVE_QP_LEVEL_INTRA,
|
|
int QP_Level_InterP; // NVVE_QP_LEVEL_INTER_P,
|
|
int QP_Level_InterB; // NVVE_QP_LEVEL_INTER_B,
|
|
int DeblockMode; // NVVE_DEBLOCK_MODE,
|
|
int ProfileLevel; // NVVE_PROFILE_LEVEL,
|
|
int ForceIntra; // NVVE_FORCE_INTRA,
|
|
int ForceIDR; // NVVE_FORCE_IDR,
|
|
int ClearStat; // NVVE_CLEAR_STAT,
|
|
int DIMode; // NVVE_SET_DEINTERLACE,
|
|
int Presets; // NVVE_PRESETS,
|
|
int DisableCabac; // NVVE_DISABLE_CABAC,
|
|
int NaluFramingType; // NVVE_CONFIGURE_NALU_FRAMING_TYPE
|
|
int DisableSPSPPS; // NVVE_DISABLE_SPS_PPS
|
|
|
|
EncoderParams();
|
|
explicit EncoderParams(const String& configFile);
|
|
|
|
void load(const String& configFile);
|
|
void save(const String& configFile) const;
|
|
};
|
|
|
|
|
|
|
|
gpucodec::EncoderParams::EncoderParams
|
|
--------------------------------------
|
|
Constructors.
|
|
|
|
.. ocv:function:: gpucodec::EncoderParams::EncoderParams()
|
|
.. ocv:function:: gpucodec::EncoderParams::EncoderParams(const String& configFile)
|
|
|
|
:param configFile: Config file name.
|
|
|
|
Creates default parameters or reads parameters from config file.
|
|
|
|
|
|
|
|
gpucodec::EncoderParams::load
|
|
-----------------------------
|
|
Reads parameters from config file.
|
|
|
|
.. ocv:function:: void gpucodec::EncoderParams::load(const String& configFile)
|
|
|
|
:param configFile: Config file name.
|
|
|
|
|
|
|
|
gpucodec::EncoderParams::save
|
|
-----------------------------
|
|
Saves parameters to config file.
|
|
|
|
.. ocv:function:: void gpucodec::EncoderParams::save(const String& configFile) const
|
|
|
|
:param configFile: Config file name.
|
|
|
|
|
|
|
|
gpucodec::EncoderCallBack
|
|
-------------------------
|
|
.. ocv:class:: gpucodec::EncoderCallBack
|
|
|
|
Callbacks for CUDA video encoder. ::
|
|
|
|
class EncoderCallBack
|
|
{
|
|
public:
|
|
enum PicType
|
|
{
|
|
IFRAME = 1,
|
|
PFRAME = 2,
|
|
BFRAME = 3
|
|
};
|
|
|
|
virtual ~EncoderCallBack() {}
|
|
|
|
virtual unsigned char* acquireBitStream(int* bufferSize) = 0;
|
|
virtual void releaseBitStream(unsigned char* data, int size) = 0;
|
|
virtual void onBeginFrame(int frameNumber, PicType picType) = 0;
|
|
virtual void onEndFrame(int frameNumber, PicType picType) = 0;
|
|
};
|
|
|
|
|
|
|
|
gpucodec::EncoderCallBack::acquireBitStream
|
|
-------------------------------------------
|
|
Callback function to signal the start of bitstream that is to be encoded.
|
|
|
|
.. ocv:function:: virtual uchar* gpucodec::EncoderCallBack::acquireBitStream(int* bufferSize) = 0
|
|
|
|
Callback must allocate buffer for CUDA encoder and return pointer to it and it's size.
|
|
|
|
|
|
|
|
gpucodec::EncoderCallBack::releaseBitStream
|
|
-------------------------------------------
|
|
Callback function to signal that the encoded bitstream is ready to be written to file.
|
|
|
|
.. ocv:function:: virtual void gpucodec::EncoderCallBack::releaseBitStream(unsigned char* data, int size) = 0
|
|
|
|
|
|
|
|
gpucodec::EncoderCallBack::onBeginFrame
|
|
---------------------------------------
|
|
Callback function to signal that the encoding operation on the frame has started.
|
|
|
|
.. ocv:function:: virtual void gpucodec::EncoderCallBack::onBeginFrame(int frameNumber, PicType picType) = 0
|
|
|
|
:param picType: Specify frame type (I-Frame, P-Frame or B-Frame).
|
|
|
|
|
|
|
|
gpucodec::EncoderCallBack::onEndFrame
|
|
-------------------------------------
|
|
Callback function signals that the encoding operation on the frame has finished.
|
|
|
|
.. ocv:function:: virtual void gpucodec::EncoderCallBack::onEndFrame(int frameNumber, PicType picType) = 0
|
|
|
|
:param picType: Specify frame type (I-Frame, P-Frame or B-Frame).
|