iOS API Reference - Focus & Zoom Methods

setAutoFocusPosition

Set the position you want to auto focus at. This setting will replace the default focus value and always focus on the set point.

Objective-C:

    [dce setAutoFocusPosition:CGPointMake(0.5, 0.5)];

Swift:

    dce.setAutoFocusPosition(CGPoint(x: 0.5, y: 0.5))

setManualFocusPosition

Set the position you want to manually focus at. This focus position only takes effect once each time this code is called.

Objective-C:

    [dce setManualFocusPosition:CGPointMake(0.5, 0.5)];

Swift:

    dce.setManualFocusPosition(CGPoint(x: 0.5, y: 0.5))

setFocalLength

Set focal length (float). The range of focal length is from 0 to 1. The value is a precentage. If user sets setFocalLength(0.5); it means the focal length will be 50% of the maxium focal length of the camera. Please note, If this API is called to set a focal length, the focal length will be fixed and all other auto focus mode will be disabled. To quit this fixed focal length mode, please set the focal length into -1.

Objective-C:

    [dce setFocalLength:0.8];

Swift:

    dce.setFocalLength = 0.8

enableDCEAutoFocus

This API is designed to turn on DCE autofocus mode which is specially designed and is separate from the systems default autofocus mode. DCE autofocus and the default autofocus can work together at the same time without any conflict. The above focus settings are also available for controlling system default autofocus. To turn on DCE autofocus mode:

Objective-C:

    [dce enableDCEAutoFocus:true];
    //To check the status of DCE autofocus.
    bool res = [dce enableDCEAutoFocus];

Swift:

    dce.enableDCEAutoFocus = true
    //To check the status of DCE autofocus.
    let res = dce.enableDCEAutoFocus

enableDefaultAutoFocus

This API is designed for controlling the system default autofocus. To turn off default autofocus mode:

Objective-C:

    [dce enableDefaultAutoFocus:false];
    //To check the status of system default autofocus.
    bool res = [dce enableDefaultAutoFocus];

Swift:

    dce.enableDefaultAutoFocus = false
    //To check the status of system default autofocus.
    let res = dce.enableDefaultAutoFocus

enableRegularAutoFocus

Regular autofocus is an advanced setting that enables the camera to autofocus for every 3 seconds. It is contained in DCE autofocus. When DCE autofocus is enabled, regular autofocus is enabled as well. To turn off regular autofocus mode:

Objective-C:

    [dce enableRegularAutoFocus:false];
    //To check the status of DCE autofocus.
    bool res = [dce enableRegularAutoFocus];

Swift:

    dce.enableRegularAutoFocus = false
    //To check the status of DCE regular autofocus.
    let res = dce.enableRegularAutoFocus

setRegularAutoFocusParam

Set the focus interval and termination time for the regular autofocus.

    //The camera will autofocus for every 3s. It won't focus for a second time within 500ms.
    [_dce setRegularAutoFocusParam:3000 terminateFocusByTime:500];

Swift:

    dce.setRegularAutoFocusParam(3000, terminateFocusByTime: 500)

enableAutoFocusOnSharpnessChange

This API is another advanced setting that enables the camera to autofocus when a change in sharpness is detected between contiguous frames. The same happens with regular autofocus, this focus mode is also enabled by default when DCE auto focus is enabled. To turn off camera autofocus when sharpness changes:

Objective-C:

    [dce enableAutoFocusOnSharpnessChange:false];
    //To check the status of DCE sharpness focus.
    bool res = [dce enableAutoFocusOnSharpnessChange];

Swift:

    dce.enableAutoFocusOnSharpnessChange = false
    //To check the status of DCE sharpness focus.
    let res = dce.enableAutoFocusOnSharpnessChange

enableAutoZoom

DCE auto zoom mode can be enabled if user is using DCE to enhance decode performance. The auto zoom mode is based on decode region predicted algorithm. In DCE auto zoom mode, If the lastest decoded frame is predicted to contain a barcode but failing to decode, DCE will control the camera to zoom in to approach the barcode region. To enable auto zoom mode:

Objective-C:

    [dce enableAutoZoom:true];
    //To check the status of DCE autozoom.
    bool res = [dce enableAutoZoom];

Swift:

    dce.enableAutoZoom = true
    //To check the status of DCE autozoom.
    let res = dce.enableAutoZoom

setZoomFactor

To set the zoom factor (float).

Objective-C:

    [dce setZoomFactor:1.5];

Swift:

    dce.setZoomFactor = 1.5