FriendlyName Property

Summary

Gets the target video format's descriptive name.

Syntax
C#
VB
C++
public string FriendlyName {get;} 
Public ReadOnly Property FriendlyName As String 
public: 
property String^ FriendlyName { 
   String^ get(); 
} 

Property Value

A string value of the target video format's friendly name.

Remarks

The returned name is not unique. However, it is ideal for presenting a descriptive name in user interfaces.

Example
C#
VB
using Leadtools; 
using Leadtools.MediaFoundation; 
using LeadtoolsMediaFoundationExamples.Fixtures; 
 
public bool _result = false; 
public CaptureCtrlForm _form = new CaptureCtrlForm(); 
 
public void IndexContainsExample() 
{ 
   // reference the capture control 
   CaptureCtrl capturectrl = _form.CaptureCtrl; 
 
   try 
   { 
      // set an video device first, you should use your video device name here 
      if (capturectrl.VideoDevices["USB"] == null) 
         throw new Exception("No USB video device available"); 
 
      capturectrl.VideoDevices["USB"].Selected = true; 
 
      // reference the target formats object 
      TargetFormats formats = capturectrl.TargetFormats; 
 
      // reference the target format object 
      TargetFormat tf = formats[TargetFormatType.MP4]; 
 
      // reference the target video formats object 
      TargetVideoFormats tvformats = tf.VideoFormats; 
 
      // check the index using a name string 
      int i = tvformats.IndexOf("{34363248-0000-0010-8000-00AA00389B71}");// H264 
 
      // get target video format object 
      TargetVideoFormat tvf = tvformats[i]; 
 
      // make sure the target video format object's name equals {34363248-0000-0010-8000-00AA00389B71} 
      if (tvf.Name == "{34363248-0000-0010-8000-00AA00389B71}") 
      { 
         // get target video format friendly name, use it for view propose. 
         string friendlyname = tvf.FriendlyName; 
      } 
      else 
         throw new Exception(); 
 
      // select it 
      tvf.Selected = true; 
 
      // check if the collection contains this format  
      // (it should we just got it with IndexOf above) 
      if (tvformats.Contains(tvf)) 
      { 
         // set the result to what we expect 
         _result = true; 
      } 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
} 
Imports Leadtools 
Imports Leadtools.MediaFoundation 
Imports LeadtoolsMediaFoundationExamples.Fixtures 
 
Public _result As Boolean = False 
Public _form As CaptureCtrlForm = New CaptureCtrlForm() 
 
Public Sub IndexContainsExample() 
   ' reference the capture control 
   Dim capturectrl As CaptureCtrl = _form.CaptureCtrl 
 
   Try 
      ' set an video device first, you should use your video device name here 
      If capturectrl.VideoDevices("USB") Is Nothing Then 
         Throw New Exception("No USB video device available") 
      End If 
 
      capturectrl.VideoDevices("USB").Selected = True 
 
      ' reference the target formats object 
      Dim formats As TargetFormats = capturectrl.TargetFormats 
 
      ' reference the target format object 
      Dim tf As TargetFormat = formats(TargetFormatType.MP4) 
 
      ' reference the target video formats object 
      Dim tvformats As TargetVideoFormats = tf.VideoFormats 
 
      ' check the index using a name string 
      Dim i As Integer = tvformats.IndexOf("{34363248-0000-0010-8000-00AA00389B71}") ' H264 
 
      ' get target video format object 
      Dim tvf As TargetVideoFormat = tvformats(i) 
 
      ' make sure the target video format object's name equals {00000161-0000-0010-8000-00AA00389B71} 
      If tvf.Name = "{34363248-0000-0010-8000-00AA00389B71}" Then 
         ' get target video format friendly name, use it for view propose. 
         Dim friendlyname As String = tvf.FriendlyName 
      Else 
         Throw New Exception() 
      End If 
 
      ' select it 
      tvf.Selected = True 
 
      ' check if the collection contains this format  
      ' (it should we just got it with IndexOf above) 
      If tvformats.Contains(tvf) Then 
         ' set the result to what we expect 
         _result = True 
      End If 
   Catch e1 As Exception 
      _result = False 
   End Try 
End Sub 

Requirements

Target Platforms

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.MediaFoundation Assembly