Gets the value indicating whether still images can be captured during conversion.
Syntax
Visual Basic (Declaration) | |
---|
Public Overridable Property EnableStillCapture As Boolean |
Visual Basic (Usage) | Copy Code |
---|
Dim instance As ConvertCtrl
Dim value As Boolean
instance.EnableStillCapture = value
value = instance.EnableStillCapture |
C# | |
---|
public virtual bool EnableStillCapture {get; set;} |
C++/CLI | |
---|
public:
virtual property bool EnableStillCapture {
bool get();
void set ( bool value);
} |
Property Value
true if still images can be captured during conversion; false, otherwise.
Example
Visual Basic | Copy Code |
---|
Public _result As Boolean = False
Public _form As ConvertCtrlForm = New ConvertCtrlForm()
Public _convertctrl As ConvertCtrl = Nothing
Public _bmpFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_SaveStillBitmap.bmp")
Public Sub SaveStillBitmapExample()
' input and output file names
Dim inFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_Source.avi")
Dim outFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_SaveStillBitmapExample.mpg")
Try
' reference the convert control
_convertctrl = _form.ConvertCtrl
' set a timer on the form to make the still bitmap
_form.TestTimer.Interval = 5000
AddHandler _form.TestTimer.Tick, AddressOf SaveStillBitmap_Helper
' enable still capture
_convertctrl.EnableStillCapture = True
' set the time window limit for capture of stills (ms)
_convertctrl.StillCaptureLimit = 100000
' set the compressor to DVVideo
_convertctrl.VideoCompressors.DVVideo.Selected = True
' set the source and target files
_convertctrl.SourceFile = inFile
_convertctrl.TargetFile = outFile
' convert it now!
_convertctrl.StartConvert()
' now start the test timer for the still capture
_form.TestTimer.Start()
Catch e1 As Exception
_result = False
End Try
' we'll loop on the state and pump messages for this example.
' but you should not need to if running from a Windows Forms application.
Do While _convertctrl.State = ConvertState.Running
Application.DoEvents()
Loop
End Sub
Public Sub SaveStillBitmap_Helper(ByVal sender As Object, ByVal e As EventArgs)
' cancel the timer
_form.TestTimer.Stop()
' try to simulate an error condition
_convertctrl.SaveStillBitmap(_bmpFile, StillFormatType.BMP, 0, 0, -1)
' check for the capture file and set the result
If File.Exists(Path.Combine(Directory.GetCurrentDirectory(), _bmpFile)) Then
_result = True
End If
End Sub
Public NotInheritable Class LEAD_VARS
Public Const MediaDir As String = "C:\Program Files (x86)\LEAD Technologies\LEADTOOLS 17\Media"
End Class |
C# | Copy Code |
---|
public bool _result = false;
public ConvertCtrlForm _form = new ConvertCtrlForm();
public ConvertCtrl _convertctrl = null;
public string _bmpFile = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_SaveStillBitmap.bmp");
public void SaveStillBitmapExample()
{
// input and output file names
string inFile = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_Source.avi");
string outFile = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_SaveStillBitmapExample.mpg");
try
{
// reference the convert control
_convertctrl = _form.ConvertCtrl;
// set a timer on the form to make the still bitmap
_form.TestTimer.Interval = 5000;
_form.TestTimer.Tick += new EventHandler(SaveStillBitmap_Helper);
// enable still capture
_convertctrl.EnableStillCapture = true;
// set the time window limit for capture of stills (ms)
_convertctrl.StillCaptureLimit = 100000;
// set the compressor to DVVideo
_convertctrl.VideoCompressors.DVVideo.Selected = true;
// set the source and target files
_convertctrl.SourceFile = inFile;
_convertctrl.TargetFile = outFile;
// convert it now!
_convertctrl.StartConvert();
// now start the test timer for the still capture
_form.TestTimer.Start();
}
catch (Exception)
{
_result = false;
}
// we'll loop on the state and pump messages for this example.
// but you should not need to if running from a Windows Forms application.
while (_convertctrl.State == ConvertState.Running)
Application.DoEvents();
}
public void SaveStillBitmap_Helper(object sender, EventArgs e)
{
// cancel the timer
_form.TestTimer.Stop();
// try to simulate an error condition
_convertctrl.SaveStillBitmap(_bmpFile, StillFormatType.BMP, 0, 0, -1);
// check for the capture file and set the result
if (File.Exists(Path.Combine(Directory.GetCurrentDirectory(), _bmpFile)))
_result = true;
}
static class LEAD_VARS
{
public const string MediaDir = @"C:\Program Files (x86)\LEAD Technologies\LEADTOOLS 17\Media";
} |
Remarks
Requirements
Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7
See Also