Update Program.cs

Author: yebuyebu

samples/Performance/AccuracyFirstSettings/Program.cs

@@ -8,16 +8,32 @@ class Program
     {
         static public void configAccuracyFirst(ref BarcodeReader dbr)
         {
+            // Obtain current runtime settings of instance.
             PublicRuntimeSettings settings = dbr.GetRuntimeSettings();
+            
+            // 1. Set expected barcode format
+            // The more precise the barcode format is set, the higher the accuracy.
+            // Mostly, misreading only occurs on reading oneD barcode. So here we use OneD barcode format to demonstrate.
             settings.BarcodeFormatIds = (int)EnumBarcodeFormat.BF_ONED;
             settings.BarcodeFormatIds_2 = (int)EnumBarcodeFormat.BF_NULL;
+            
+            // 2. Set the minimal result confidence.
+            // The greater the confidence, the higher the accuracy.
+            // Filter by minimal confidence of the decoded barcode. We recommend using 30 as the default minimal confidence value
             settings.MinResultConfidence = 30;
+            
+            // 3. Sets the minimum length of barcode text for filtering.
+            // The more precise the barcode text length is set, the higher the accuracy.
             settings.MinBarcodeTextLength = 6;
+            
+            // Apply the new settings to the instance
             dbr.UpdateRuntimeSettings(settings);
 
         }
         static public void configAccuracyFirstByTemplate(ref BarcodeReader mBarcodeReader)
         {
+            // Compared with PublicRuntimeSettings, parameter templates have a richer ability to control parameter details.
+		    // Please refer to the parameter explanation in "AccuracyFirstTemplate.json" to understand how to control accuracy first.
             string strErrorMessage;
             EnumErrorCode ret = mBarcodeReader.InitRuntimeSettingsWithFile("AccuracyFirstTemplate.json", EnumConflictMode.CM_OVERWRITE, out strErrorMessage);
         }
@@ -44,31 +60,54 @@ static void Main(string[] args)
         {
             try
             {
+                // Initialize license
+                /*
+                // By setting organizaion ID as "200001", a 7-day trial license will be used for license verification.
+                // Note that network connection is required for this license to work.
+                //
+                // When using your own license, locate the following line and specify your Organization ID.
+                // organizationID = "200001";
+                //
+                // If you don't have a license yet, you can request a trial from https://www.dynamsoft.com/customer/license/trialLicense?product=dbr&utm_source=samples&package=dotnet
+                */
                 DMDLSConnectionParameters connectionInfo = BarcodeReader.InitDLSConnectionParameters();
                 connectionInfo.OrganizationID = "200001";
                 EnumErrorCode errorCode = BarcodeReader.InitLicenseFromDLS(connectionInfo, out string errorMsg);
                 if (errorCode != EnumErrorCode.DBR_SUCCESS)
                 {
                     Console.WriteLine(errorMsg);
                 }
-
+                
+                // Create an instance of Barcode Reader
                 BarcodeReader dbr = new BarcodeReader();
                 TextResult[] results = null;
                 string fileName = "../../../../../images/AllSupportedBarcodeTypes.png";
 
+                // Accuracy = The number of correctly decoded barcodes/the number of all decoded barcodes
+		        // There are two ways to configure runtime parameters. One is through PublicRuntimeSettings, the other is through parameters template.
                 Console.WriteLine("Decode through PublicRuntimeSettings:");
                 {
+                    // config through PublicRuntimeSettings
                     configAccuracyFirst(ref dbr);
+                    
+                    // Decode barcodes from an image file by current runtime settings. The second parameter value "" means to decode through the current PublicRuntimeSettings.
                     results = dbr.DecodeFile(fileName, "");
+                    
+                    // Output the barcode format and barcode text.
                     outputResults(results);
                 }
 
                 Console.WriteLine("\r\n");
 
                 Console.WriteLine("Decode through parameters template:");
                 {
+                    // config through parameters template
                     configAccuracyFirstByTemplate(ref dbr);
+                    
+                    // Decode barcodes from an image file by template.
                     results = dbr.DecodeFile(fileName,"");
+                    
+                    // Output the barcode format and barcode text.
                     outputResults(results);
                 }
             }