Parameter and Runtime Settings Basic Methods

getRuntimeSettings

Get current settings and save them into a iPublicRuntimeSettings struct.

• Objective-C
• Swift

1. - (iPublicRuntimeSettings* _Nullable)getRuntimeSettings:(NSError* _Nullable * _Nullable)error;
   

2. func getRuntimeSettings() throws -> iPublicRuntimeSettings
   

Parameters

[in,out] error: A pointer to an error object.

An error occurs when:

• The library failed to get the runtime settings.

Return Value

A DBRPublicRuntimeSettings storing current runtime settings.

Code Snippet

• Objective-C
• Swift

1. NSError __autoreleasing * _Nullable error;
   [barcodeReader getRuntimeSettings:&error];
   

2. do{
      let settings = try barcodeReader.getRuntimeSettings()
   }catch{
      // Add your code to deal with exceptions
   }
   

updateRuntimeSettings:(iPublicRuntimeSettings*)

Update runtime settings with a given iPublicRuntimeSettings struct.

• Objective-C
• Swift

1. - (BOOL)updateRuntimeSettings:(iPublicRuntimeSettings* _Nonnull)settings
                       error:(NSError* _Nullable * _Nullable)error
                       NS_SWIFT_NAME(updateRuntimeSettings(_:));
   

2. func updateRuntimeSettings(_ settings: iPublicRuntimeSettings) throws
   

Parameters

[in] settings The struct of template settings.
[in,out] error: A pointer to an error object.

An error occurs when:

• There exists parameters that are invalid or out of range in the iPublicRuntimeSettings object.

Code Snippet

• Objective-C
• Swift

1. iPublicRuntimeSettings *settings = [barcodeReader getRuntimeSettings:nil];
   // After you have made some changes on the runtime settings.
   [barcodeReader updateRuntimeSettings:settings error:nil];
   

2. do{
      let settings = try barcodeReader.getRuntimeSettings()
      // After you have made some changes on the runtime settings.
      try barcodeReader.updateRuntimeSettings(settings!)
   }catch{
      // Add your code to deal with exceptions
   }
   

updateRuntimeSettings:(EnumPresetTemplate)

• Objective-C
• Swift

1. - (void)updateRuntimeSettings:(EnumPresetTemplate)presetTemplate;
   

2. func updateRuntimeSettings(_ tpl: EnumPresetTemplate)
   

Parameters

presetTemplate: One of the preset templates defined by EnumPresetTemplate

Code Snippet

• Objective-C
• Swift

1. [barcodeReader updateRuntimeSettings:EnumPresetTemplateVideoSingleBarcode];
   

2. barcodeReader.updateRuntimeSettings(EnumPresetTemplate.videoSingleBarcode)
   

resetRuntimeSettings

Reset all parameters to default values.

• Objective-C
• Swift

1. - (BOOL)resetRuntimeSettings:(NSError* _Nullable * _Nullable)error;
   

2. func resetRuntimeSettings() throws
   

Parameters

[in,out] error Input a pointer to an error object. If an error occurs, this pointer is set to an actual error object containing the error information. You may specify nil for this parameter if you do not want the error information.

Code Snippet

• Objective-C
• Swift

1. [barcodeReader resetRuntimeSettings:nil];
   

2. do{
      try barcodeReader.resetRuntimeSettings()
   }catch{
      // Add your code to deal with exceptions
   }