Operates with file sources.
Methods
ReaderAbort
Aborts a reader process. For example to abort a process of getting a frame from file.
Syntax
void ReaderAbort()
ReaderClose
Closes a file source.
Syntax
void ReaderClose()
ReaderDurationGet
Gets duration of a source file
Syntax
void ReaderDurationGet( out double _pdblDuration )
Parameters
_pdblDuration - duration Example Here is an example of how to get a duration of a file: C# m_objMFReader = new MFReaderClass(); m_objMFReader.ReaderOpen(sourceFileName, ""); double dblDur; m_objMFReader.ReaderDurationGet(out dblDur);
ReaderNameGet
Gets a name of source file
Syntax
void ReaderNameGet( out string _pbsFileName )
Parameters
_pbsFileName - source file name
ReaderOpen
Opens a source file.
Syntax
void ReaderOpen( string _bsPath, string _bsPropsList )
Parameters
_bsPath - path to a file
_bsPropsList - additional parameters Example Here is an example of how to send a frame to a preview: C# m_objPreview = new MFPreviewClass(); //Configure preview m_objPreview.PreviewWindowSet("", panelPreview.Handle.ToInt32()); m_objPreview.PreviewEnable("", 1, 1); m_objMFReader = new MFReaderClass(); m_objMFReader.ReaderOpen(sourceFileName, ""); m_avProps = new M_AV_PROPS(); // set video format for conversion m_avProps.vidProps.eVideoFormat = eMVideoFormat.eMVF_HD1080_5994i; MFFrame pFrame = null; // Get next frame or frame by position if (m_objMFReader != null) m_objMFReader.SourceFrameConvertedGetByTime(ref m_avProps, -1, -1, out pFrame, ""); m_objPreview.ReceiverFramePut(pFrame, -1, ""); // show the frame on preview
SourceAVPropsGet
Gets media properties (audio and video) of a source object
Syntax
void SourceAVPropsGet( out M_AV_PROPS _pAVProps )
Parameters
_pAVProps - media properties Example Here is example of how to get media properties of a source: C# m_objPreview = new MFPreviewClass(); //Configure preview m_objPreview.PreviewWindowSet("", panelPreview.Handle.ToInt32()); m_objPreview.PreviewEnable("", 1, 1); m_objMFReader = new MFReaderClass(); m_objMFReader.ReaderOpen(sourceFileName, ""); m_avProps = new M_AV_PROPS(); // get media properties of a source file m_objMFReader.SourceAVPropsGet(out m_avProps); m_avProps.vidProps.eVideoFormat = eMVideoFormat.eMVF_HD1080_5994i; MFFrame pFrame = null; // Get next frame if (m_objMFReader != null) m_objMFReader.SourceFrameConvertedGetByTime(ref m_avProps, -1, -1, out pFrame, ""); m_objPreview.ReceiverFramePut(pFrame, -1, ""); // show the frame on preview
SourceFrameConvertedGet
Gets a next frame (that is converted to required format) from file or live source
Syntax
void SourceFrameConvertedGet( ref M_AV_PROPS _pAVPropsOut, long _rtMaxWait, out MFFrame _ppFrame, string _bsHints )
Parameters
_pAVPropsOut - media properties that specify required format for a frame
_rtMaxWait - maximal wait time in milliseconds. By default use "-1".
_ppFrame - converted frame object
_bsHints - additional parameters Example Here is an example of how to get a frame from a file: C# m_objPreview = new MFPreviewClass(); //Configure preview m_objPreview.PreviewWindowSet("", panelPreview.Handle.ToInt32()); m_objPreview.PreviewEnable("", 1, 1); m_objMFReader = new MFReaderClass(); m_objMFReader.ReaderOpen(sourceFileName, ""); m_avProps = new M_AV_PROPS(); // set video format for conversion m_avProps.vidProps.eVideoFormat = eMVideoFormat.eMVF_HD1080_5994i; MFFrame pFrame = null; // Get next frame if (m_objMFReader != null) m_objMFReader.SourceFrameConvertedGet(ref m_avProps, -1, out pFrame, ""); m_objPreview.ReceiverFramePut(pFrame, -1, ""); // show the frame on preview
SourceFrameConvertedGetByNumber
Gets a converted to required format frame by its number. For live sources number is ignored.
Syntax
void SourceFrameConvertedGetByNumber( ref M_AV_PROPS _pAVPropsOut, int _nFrameNo, long _rtMaxWait, out MFFrame _ppFrame, string _bsHints )
Parameters
_pAVPropsOut - required format's properties for a frame
_nFrameNo - number of a frame. It is possible to use negative values. For example, "-1" returns you a next frame and "-5" returns you the next 5th frame
_rtMaxWait - maximal wait time in milliseconds. By default use "-1".
_ppFrame - converted frame object
_bsHints - additional parameters Example Here is an example of how to get a frame from a file: C# m_objPreview = new MFPreviewClass(); //Configure preview m_objPreview.PreviewWindowSet("", panelPreview.Handle.ToInt32()); m_objPreview.PreviewEnable("", 1, 1); m_objMFReader = new MFReaderClass(); m_objMFReader.ReaderOpen(sourceFileName, ""); m_avProps = new M_AV_PROPS(); // set video format for conversion m_avProps.vidProps.eVideoFormat = eMVideoFormat.eMVF_HD1080_5994i; MFFrame pFrame = null; // Get next frame if (m_objMFReader != null) m_objMFReader.SourceFrameConvertedGetByNumber(ref m_avProps, -1, -1, out pFrame, ""); m_objPreview.ReceiverFramePut(pFrame, -1, ""); // show the frame on preview
SourceFrameConvertedGetByTime
Gets a converted to required format frame by its time. For live sources time is ignored.
Syntax
void SourceFrameConvertedGetByTime( ref M_AV_PROPS _pAVPropsOut, double _dblTimeSec, long _rtMaxWait, out MFFrame _ppFrame, string _bsHints )
Parameters
_pAVPropsOut - required format's properties for a frame
_dblTimeSec - position of a frame in time. To get a next frame use "-1"
_rtMaxWait - maximal wait time in milliseconds. By default use "-1".
_ppFrame - converted frame object
_bsHints - additional parameters Example Here is an example of how to send a frame to a preview: C# m_objPreview = new MFPreviewClass(); //Configure preview m_objPreview.PreviewWindowSet("", panelPreview.Handle.ToInt32()); m_objPreview.PreviewEnable("", 1, 1); m_objMFReader = new MFReaderClass(); m_objMFReader.ReaderOpen(sourceFileName, ""); m_avProps = new M_AV_PROPS(); // set video format for conversion m_avProps.vidProps.eVideoFormat = eMVideoFormat.eMVF_HD1080_5994i; MFFrame pFrame = null; // Get next frame if (m_objMFReader != null) m_objMFReader.SourceFrameConvertedGetByTime(ref m_avProps, -1, -1, out pFrame, ""); m_objPreview.ReceiverFramePut(pFrame, -1, ""); // show the frame on preview
SourceFrameGet
Gets an original next frame of a file or live source
Syntax
void SourceFrameGet( long _rtMaxWait, out MFFrame _ppFrame, string _bsHints )
Parameters
_rtMaxWait - maximal wait time in milliseconds. By default use "-1".
_ppFrame - converted frame object
_bsHints - additional parameters Example Here is an example of how to send a frame to a preview: C# m_objPreview = new MFPreviewClass(); //Configure preview m_objPreview.PreviewWindowSet("", panelPreview.Handle.ToInt32()); m_objPreview.PreviewEnable("", 1, 1); m_objMFReader = new MFReaderClass(); m_objMFReader.ReaderOpen(sourceFileName, ""); MFFrame pFrame = null; // Get next frame if (m_objMFReader != null) m_objMFReader.SourceFrameGet(-1, out pFrame, ""); m_objPreview.ReceiverFramePut(pFrame, -1, ""); // show the frame on preview
SourceFrameGetByNumber
Gets an original frame by its number. For live sources number is ignored.
Syntax
void SourceFrameGetByNumber( int _nFrameNo, long _rtMaxWait, out MFFrame _ppFrame, string _bsHints )
Parameters
_nFrameNo - frame's number
_rtMaxWait - maximal wait time in milliseconds. By default use "-1".
_ppFrame - converted frame object
_bsHints - additional parameters Example Here is an example of how to get a frame from a file: C# m_objPreview = new MFPreviewClass(); //Configure preview m_objPreview.PreviewWindowSet("", panelPreview.Handle.ToInt32()); m_objPreview.PreviewEnable("", 1, 1); m_objMFReader = new MFReaderClass(); m_objMFReader.ReaderOpen(sourceFileName, ""); MFFrame pFrame = null; // Get next frame if (m_objMFReader != null) m_objMFReader.SourceFrameGetByNumber(-1, -1, out pFrame, ""); m_objPreview.ReceiverFramePut(pFrame, -1, ""); // show the frame on preview
SourceFrameGetByTime
Gets an original frame by its time. For live sources time is ignored.
Syntax
void SourceFrameGetByTime( double _dblTimeSec, long _rtMaxWait, out MFFrame _ppFrame, string _bsHints )
Parameters
_dblTimeSec - position of a frame in time. To get a next frame use "-1".
_rtMaxWait - maximal wait time in milliseconds. By default use "-1".
_ppFrame - converted frame object
_bsHints - additional parameters Example Here is an example of how to send a frame to a preview: C# m_objPreview = new MFPreviewClass(); //Configure preview m_objPreview.PreviewWindowSet("", panelPreview.Handle.ToInt32()); m_objPreview.PreviewEnable("", 1, 1); m_objMFReader = new MFReaderClass(); m_objMFReader.ReaderOpen(sourceFileName, ""); MFFrame pFrame = null; // Get next frame if (m_objMFReader != null) m_objMFReader.SourceFrameGetByTime(-1, -1, out pFrame, ""); m_objPreview.ReceiverFramePut(pFrame, -1, ""); // show the frame on preview