Dev Center
Swift
Objective-C
Table of contents

Parameter and Runtime Settings Basic Methods

Method Description
getRuntimeSettings Get current runtime settings.
updateRuntimeSettings:(iPublicRuntimeSettings) Update runtime settings with a given struct.
updateRuntimeSettings:(EnumPresetTemplate) Update runtime settings from one of the preset templates.
resetRuntimeSettings Resets all parameters to default values.

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
    }
    

This page is compatible for:

Version 7.5.0

Is this page helpful?

YesYes NoNo

In this article:

latest version

  • Latest version (10.2.10)
  • Version 10.x
    • Version 10.0.21
    • Version 10.0.20
  • Version 9.x
    • Version 9.6.40
    • Version 9.6.20
    • Version 9.6.11
    • Version 9.6.10
    • Version 9.6.0
    • Version 9.4.0
    • Version 9.2.13
    • Version 9.2.11
    • Version 9.2.10
    • Version 9.0.2
    • Version 9.0.1
    • Version 9.0.0
  • Version 8.x
    • Version 8.9.3
    • Version 8.9.1
    • Version 8.9.0
    • Version 8.8.0
    • Version 8.6.0
    • Version 8.4.0
    • Version 8.2.1
    • Version 8.2.0
    • Version 8.1.2
    • Version 8.1.0
    • Version 8.0.0
  • Version 7.x
    • Version 7.6.0
    • Version 7.5.0
Change +