LEADTOOLS Multimedia (Leadtools.Multimedia assembly) Send comments on this topic. | Back to Introduction | Help Version 17.0.3.22
LoadSettingsFromFile Method
See Also 
Leadtools.Multimedia Namespace > ConvertCtrl Class : LoadSettingsFromFile Method



sourceFile
The file from which settings will be loaded.
flags
The setting flags specifying which settings to load. See the ConvertSettings enumeration for the setting options.
sourceFile
The file from which settings will be loaded.
flags
The setting flags specifying which settings to load. See the ConvertSettings enumeration for the setting options.
Loads some or all of the convert object settings from a file.

Syntax

Visual Basic (Declaration) 
Public Overridable Sub LoadSettingsFromFile( _
   ByVal sourceFile As String, _
   ByVal flags As ConvertSettings _
) 
Visual Basic (Usage)Copy Code
Dim instance As ConvertCtrl
Dim sourceFile As String
Dim flags As ConvertSettings
 
instance.LoadSettingsFromFile(sourceFile, flags)
C# 
public virtual void LoadSettingsFromFile( 
   string sourceFile,
   ConvertSettings flags
)
C++/CLI 
public:
virtual void LoadSettingsFromFile( 
   String^ sourceFile,
   ConvertSettings flags
) 

Parameters

sourceFile
The file from which settings will be loaded.
flags
The setting flags specifying which settings to load. See the ConvertSettings enumeration for the setting options.

Example

Visual BasicCopy Code
Public _result As Boolean = False
      Public _form As ConvertCtrlForm = New ConvertCtrlForm()
      Public _convertctrl As ConvertCtrl
      Public _streamSettings As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_ObjectSettingsExample_Stream.xml")
      Public _fileSettings As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_ObjectSettingsExample.xml")

      Public Sub ObjectSettingsExample()
         ' reference the play control
         _convertctrl = _form.ConvertCtrl

         ' input and output files
         Dim inFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_Source.avi")
         Dim outFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_ObjectSettingsExample.avi")

         Try
            Dim pVideoDizzy As Processor = _convertctrl.VideoProcessors.EFXDizzy
            ' set a video processor
            _convertctrl.SelectedVideoProcessors.Add(pVideoDizzy)

            ' save the settings to a file
            If SaveFileSettings() Then
               ' now clear the selected processors again
               _convertctrl.SelectedVideoProcessors.Clear()

               ' check if stream file exists
               If File.Exists(_fileSettings) Then
                  ' load the saved settings from a file
                  ' and check if the processor is selected again
                  LoadFileSettings()

                  ' set the result 
                  _result = _convertctrl.SelectedVideoProcessors.Contains(pVideoDizzy)
               End If
            End If

            ' save the settings to a stream
            If SaveStreamSettings() Then
               ' now clear the selected processors again
               _convertctrl.SelectedVideoProcessors.Clear()

               ' check if stream file exists
               If File.Exists(_streamSettings) Then
                  ' load the saved settings from a stream 
                  ' and check if the processor is selected again
                  LoadStreamSettings()

                  ' set the result 
                  _result = _result And _convertctrl.SelectedVideoProcessors.Contains(pVideoDizzy)
               End If
            End If
         Catch e1 As Exception
            _result = False
         End Try
      End Sub

      Private Sub LoadFileSettings()
         _convertctrl.LoadSettingsFromFile(_fileSettings, ConvertSettings.Processors)
      End Sub

      Private Function SaveFileSettings() As Boolean
         '  check if we can save the processors settings
         If _convertctrl.CanSaveObjectSettings(ConvertSettings.Processors) Then
            _convertctrl.SaveSettingsToFile(_fileSettings, ConvertSettings.Processors)
            Return True
         End If
         Return False
      End Function

      Private Sub LoadStreamSettings()
         Dim settings As Stream = New StreamReader(_streamSettings).BaseStream
         _convertctrl.LoadSettingsFromStream(settings, ConvertSettings.Processors)
         settings.Close()
      End Sub

      Private Function SaveStreamSettings() As Boolean
         '  check if we can save the processors settings
         If _convertctrl.CanSaveObjectSettings(ConvertSettings.Processors) Then
            Dim settings As Stream = New StreamWriter(_streamSettings, False).BaseStream
            _convertctrl.SaveSettingsToStream(settings, ConvertSettings.Processors)
            settings.Close()
            Return True
         End If
         Return False
      End Function

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;
      public string _streamSettings = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_ObjectSettingsExample_Stream.xml");
      public string _fileSettings = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_ObjectSettingsExample.xml");

      public void ObjectSettingsExample()
      {
         // reference the play control
         _convertctrl = _form.ConvertCtrl;

         // input and output files
         string inFile = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_Source.avi");
         string outFile = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_ObjectSettingsExample.avi");

         try
         {
            Processor pVideoDizzy = _convertctrl.VideoProcessors.EFXDizzy;
            // set a video processor
            _convertctrl.SelectedVideoProcessors.Add(pVideoDizzy);

            // save the settings to a file
            if (SaveFileSettings())
            {
               // now clear the selected processors again
               _convertctrl.SelectedVideoProcessors.Clear();

               // check if stream file exists
               if (File.Exists(_fileSettings))
               {
                  // load the saved settings from a file
                  // and check if the processor is selected again
                  LoadFileSettings();

                  // set the result 
                  _result = _convertctrl.SelectedVideoProcessors.Contains(pVideoDizzy);
               }
            }

            // save the settings to a stream
            if (SaveStreamSettings())
            {
               // now clear the selected processors again
               _convertctrl.SelectedVideoProcessors.Clear();

               // check if stream file exists
               if (File.Exists(_streamSettings))
               {
                  // load the saved settings from a stream 
                  // and check if the processor is selected again
                  LoadStreamSettings();

                  // set the result 
                  _result &= _convertctrl.SelectedVideoProcessors.Contains(pVideoDizzy);
               }
            }
         }
         catch (Exception)
         {
            _result = false;
         }
      }

      private void LoadFileSettings()
      {
         _convertctrl.LoadSettingsFromFile(_fileSettings, ConvertSettings.Processors);
      }

      private bool SaveFileSettings()
      {
         //  check if we can save the processors settings
         if (_convertctrl.CanSaveObjectSettings(ConvertSettings.Processors))
         {
            _convertctrl.SaveSettingsToFile(_fileSettings, ConvertSettings.Processors);
            return true;
         }
         return false;
      }

      private void LoadStreamSettings()
      {
         Stream settings = new StreamReader(_streamSettings).BaseStream;
         _convertctrl.LoadSettingsFromStream(settings, ConvertSettings.Processors);
         settings.Close();
      }

      private bool SaveStreamSettings()
      {
         //  check if we can save the processors settings
         if (_convertctrl.CanSaveObjectSettings(ConvertSettings.Processors))
         {
            Stream settings = new StreamWriter(_streamSettings, false).BaseStream;
            _convertctrl.SaveSettingsToStream(settings, ConvertSettings.Processors);
            settings.Close();
            return true;
         }
         return false;
      }

static class LEAD_VARS
{
   public const string MediaDir = @"C:\Program Files (x86)\LEAD Technologies\LEADTOOLS 17\Media";
}

Remarks

Loads some or all of the convert object settings from a file. This reconstructs the conversion configuration using the settings found in the file. The convert object settings can be saved to a file by calling SaveSettingsToFile. Settings can be saved to a stream by calling ConvertCtrl.SaveSettingsToStream. Settings saved to a stream can be loaded using the ConvertCtrl.LoadSettingsFromStream method. It may be helpful to call CanSaveObjectSettings before calling the save methods. This will ensure the settings can be saved. If either SaveSettingsToFile or ConvertCtrl.SaveSettingsToStream is called for settings that cannot be saved, the save method will fail.

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