simple-dynamsoft-mcp 1.0.0

package/code-snippet/android/BarcodeScannerAPISamples/gradlew

@@ -0,0 +1,185 @@
+#!/usr/bin/env sh
+
+#
+# Copyright 2015 the original author or authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+##############################################################################
+##
+##  Gradle start up script for UN*X
+##
+##############################################################################
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ] ; do
+    ls=`ls -ld "$PRG"`
+    link=`expr "$ls" : '.*-> \(.*\)$'`
+    if expr "$link" : '/.*' > /dev/null; then
+        PRG="$link"
+    else
+        PRG=`dirname "$PRG"`"/$link"
+    fi
+done
+SAVED="`pwd`"
+cd "`dirname \"$PRG\"`/" >/dev/null
+APP_HOME="`pwd -P`"
+cd "$SAVED" >/dev/null
+
+APP_NAME="Gradle"
+APP_BASE_NAME=`basename "$0"`
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn () {
+    echo "$*"
+}
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "`uname`" in
+  CYGWIN* )
+    cygwin=true
+    ;;
+  Darwin* )
+    darwin=true
+    ;;
+  MINGW* )
+    msys=true
+    ;;
+  NONSTOP* )
+    nonstop=true
+    ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD="$JAVA_HOME/jre/sh/java"
+    else
+        JAVACMD="$JAVA_HOME/bin/java"
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD="java"
+    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
+    MAX_FD_LIMIT=`ulimit -H -n`
+    if [ $? -eq 0 ] ; then
+        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
+            MAX_FD="$MAX_FD_LIMIT"
+        fi
+        ulimit -n $MAX_FD
+        if [ $? -ne 0 ] ; then
+            warn "Could not set maximum file descriptor limit: $MAX_FD"
+        fi
+    else
+        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+    fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
+    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
+    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
+
+    JAVACMD=`cygpath --unix "$JAVACMD"`
+
+    # We build the pattern for arguments to be converted via cygpath
+    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
+    SEP=""
+    for dir in $ROOTDIRSRAW ; do
+        ROOTDIRS="$ROOTDIRS$SEP$dir"
+        SEP="|"
+    done
+    OURCYGPATTERN="(^($ROOTDIRS))"
+    # Add a user-defined pattern to the cygpath arguments
+    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
+        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+    fi
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    i=0
+    for arg in "$@" ; do
+        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
+        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
+
+        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
+            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
+        else
+            eval `echo args$i`="\"$arg\""
+        fi
+        i=`expr $i + 1`
+    done
+    case $i in
+        0) set -- ;;
+        1) set -- "$args0" ;;
+        2) set -- "$args0" "$args1" ;;
+        3) set -- "$args0" "$args1" "$args2" ;;
+        4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+        5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+        6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+        7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+        8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+        9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+    esac
+fi
+
+# Escape application args
+save () {
+    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
+    echo " "
+}
+APP_ARGS=`save "$@"`
+
+# Collect all arguments for the java command, following the shell quoting and substitution rules
+eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+
+exec "$JAVACMD" "$@"

package/code-snippet/android/BarcodeScannerAPISamples/gradlew.bat

@@ -0,0 +1,89 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

package/code-snippet/android/BarcodeScannerAPISamples/settings.gradle

@@ -0,0 +1,19 @@
+pluginManagement {
+    repositories {
+        google {
+            content {
+                includeGroupByRegex("com\\.android.*")
+                includeGroupByRegex("com\\.google.*")
+                includeGroupByRegex("androidx.*")
+            }
+        }
+        mavenCentral()
+        gradlePluginPortal()
+    }
+}
+
+rootProject.name = "BarcodeScannerAPISamples"
+include ':ScanSingleBarcode'
+include ':ScanSingleBarcodeKt'
+include ':ScanMultipleBarcodes'
+include ':ScenarioOrientedSamples'

package/code-snippet/android/FoundationalAPISamples/Debug/build.gradle

@@ -0,0 +1,38 @@
+plugins {
+    id 'com.android.application'
+}
+
+android {
+    namespace 'com.dynamsoft.debug'
+    compileSdk 35
+
+    defaultConfig {
+        applicationId "com.dynamsoft.debug"
+        minSdk 21
+        targetSdk 35
+        versionCode 1
+        versionName "1.0"
+
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_11
+        targetCompatibility JavaVersion.VERSION_11
+    }
+}
+
+dependencies {
+    implementation 'com.dynamsoft:barcodereaderbundle:11.2.5000'
+
+    implementation 'androidx.appcompat:appcompat:1.6.1'
+    implementation 'com.google.android.material:material:1.9.0'
+    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
+    implementation 'androidx.preference:preference:1.2.1'
+}

package/code-snippet/android/FoundationalAPISamples/Debug/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

package/code-snippet/android/FoundationalAPISamples/Debug/src/main/AndroidManifest.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application
+        android:allowBackup="true"
+        android:icon="@drawable/dbr_icon"
+        android:label="@string/app_name"
+        android:roundIcon="@drawable/dbr_icon"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.Debug"
+        tools:targetApi="31" >
+        <activity
+            android:name=".settings.SettingsActivity"
+            android:exported="false"
+            android:label="@string/title_activity_settings"/>
+        <activity
+            android:name=".CaptureActivity"
+            android:exported="false"
+            android:label="@string/title_activity_capture" />
+        <activity
+            android:name=".HomeActivity"
+            android:exported="true"
+            android:theme="@style/Theme.HomePage" >
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>

package/code-snippet/android/FoundationalAPISamples/Debug/src/main/java/com/dynamsoft/debug/CaptureActivity.java

@@ -0,0 +1,256 @@
+package com.dynamsoft.debug;
+
+import android.content.Intent;
+import android.content.SharedPreferences;
+import android.os.Bundle;
+import android.util.Log;
+import android.util.Size;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Button;
+import android.widget.TextView;
+
+import androidx.annotation.IntDef;
+import androidx.annotation.NonNull;
+import androidx.appcompat.app.AlertDialog;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.preference.PreferenceManager;
+
+import com.dynamsoft.core.basic_structures.CompletionListener;
+import com.dynamsoft.core.basic_structures.DSRect;
+import com.dynamsoft.core.basic_structures.EnumColourChannelUsageType;
+import com.dynamsoft.core.basic_structures.ImageData;
+import com.dynamsoft.core.intermediate_results.BinaryImageUnit;
+import com.dynamsoft.core.intermediate_results.ColourImageUnit;
+import com.dynamsoft.core.intermediate_results.GrayscaleImageUnit;
+import com.dynamsoft.core.intermediate_results.IntermediateResultExtraInfo;
+import com.dynamsoft.core.intermediate_results.IntermediateResultUnit;
+import com.dynamsoft.cvr.CaptureVisionRouter;
+import com.dynamsoft.cvr.CaptureVisionRouterException;
+import com.dynamsoft.cvr.EnumPresetTemplate;
+import com.dynamsoft.cvr.intermediate_results.IntermediateResultReceiver;
+import com.dynamsoft.dce.CameraEnhancer;
+import com.dynamsoft.dce.CameraEnhancerException;
+import com.dynamsoft.dce.CameraView;
+import com.dynamsoft.dce.utils.PermissionUtil;
+import com.dynamsoft.debug.settings.PreferencesConstants;
+import com.dynamsoft.debug.settings.SettingsActivity;
+import com.dynamsoft.utility.ImageIO;
+import com.dynamsoft.utility.UtilityException;
+import com.google.android.material.appbar.MaterialToolbar;
+
+import java.io.File;
+import java.text.SimpleDateFormat;
+import java.util.Locale;
+
+public class CaptureActivity extends AppCompatActivity {
+
+    @IntDef({ColorMode.COLOUR, ColorMode.GRAYSCALE, ColorMode.BINARY})
+    private @interface ColorMode {
+        int COLOUR = 0;
+        int GRAYSCALE = 1;
+        int BINARY = 2;
+    }
+
+    private static final String TAG = "CaptureActivity";
+
+    private int maxCapturedFramesCount;
+
+    @ColorMode
+    private int captureImageColourMode = ColorMode.COLOUR;
+    private String scanRegion;
+
+    private final ImageIO imageIO = new ImageIO();
+    private CaptureVisionRouter router;
+    private CameraEnhancer camera;
+
+    private String savedDir;
+
+    private int currentCapturedFramesCount = -1;
+    private Button btnCaptureVideoFrames;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_capture);
+
+        initActionBar();
+        initBtnCaptureVideoFrames();
+        initCamera();
+        initCaptureVisionRouter();
+
+        PermissionUtil.requestCameraPermission(this);
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        setupPreferences();
+        setupCameraScanRegion();
+
+        camera.open();
+        router.startCapturing(EnumPresetTemplate.PT_READ_BARCODES, new CompletionListener() {
+            @Override
+            public void onSuccess() {
+                Log.i(TAG, "onSuccess.");
+            }
+
+            @Override
+            public void onFailure(int errorCode, String errorString) {
+                Log.e(TAG, "onFailure: " + errorString + " " + errorCode);
+                runOnUiThread(() -> {
+                    TextView tvError = findViewById(R.id.tv_start_capturing_error);
+                    tvError.setText(String.format(Locale.getDefault(), "ErrorCode: %d %nErrorMessage: %s", errorCode, errorString));
+                    findViewById(R.id.btn_capture).setEnabled(false);
+                });
+            }
+        });
+    }
+
+    @Override
+    protected void onPause() {
+        super.onPause();
+        camera.close();
+        router.stopCapturing();
+    }
+
+    private void initCamera() {
+        CameraView cameraView = findViewById(R.id.camera_view);
+        camera = new CameraEnhancer(cameraView, this);
+        camera.setColourChannelUsageType(EnumColourChannelUsageType.CCUT_FULL_CHANNEL);
+    }
+
+    private void setupCameraScanRegion() {
+        try {
+            switch (scanRegion) {
+                case PreferencesConstants.SCAN_REGION_FULL_IMAGE:
+                    camera.setScanRegion(null);
+                    break;
+                case PreferencesConstants.SCAN_REGION_SQUARE:
+                    Size resolution = camera.getResolution();
+                    float side = Math.min(resolution.getWidth(), resolution.getHeight()) * 0.7f;
+                    Log.e(TAG, "setupCameraScanRegion: "+resolution+" "+side);
+                    camera.setScanRegion(new DSRect(
+                            (resolution.getWidth() - side) / 2,
+                            (resolution.getHeight() - side) / 2,
+                            (resolution.getWidth() + side) / 2,
+                            (resolution.getHeight() + side) / 2,
+                            false));
+                    break;
+                case PreferencesConstants.SCAN_REGION_RECTANGLE:
+                    camera.setScanRegion(new DSRect(.05f, .3f, .95f, .55f, true));
+                    break;
+            }
+        } catch (CameraEnhancerException e) {
+            throw new RuntimeException(e);
+        }
+    }
+
+    private void initCaptureVisionRouter() {
+        router = new CaptureVisionRouter();
+        try {
+            router.setInput(camera);
+        } catch (CaptureVisionRouterException e) {
+            throw new RuntimeException(e);
+        }
+        router.getIntermediateResultManager().addResultReceiver(new IntermediateResultReceiver() {
+            @Override
+            public void onColourImageUnitReceived(@NonNull ColourImageUnit unit, IntermediateResultExtraInfo info) {
+                saveIntermediateResult(unit);
+            }
+
+            @Override
+            public void onGrayscaleImageUnitReceived(@NonNull GrayscaleImageUnit unit, IntermediateResultExtraInfo info) {
+                saveIntermediateResult(unit);
+            }
+
+            @Override
+            public void onBinaryImageUnitReceived(@NonNull BinaryImageUnit unit, IntermediateResultExtraInfo info) {
+                saveIntermediateResult(unit);
+            }
+        });
+    }
+
+    private void saveIntermediateResult(IntermediateResultUnit unit) {
+        if (currentCapturedFramesCount >= 0 && currentCapturedFramesCount < maxCapturedFramesCount) {
+            ImageData imageData = null;
+            if (captureImageColourMode == ColorMode.COLOUR && unit instanceof ColourImageUnit) {
+                imageData = ((ColourImageUnit) unit).getImageData();
+            } else if (captureImageColourMode == ColorMode.GRAYSCALE && unit instanceof GrayscaleImageUnit) {
+                imageData = ((GrayscaleImageUnit) unit).getImageData();
+            } else if (captureImageColourMode == ColorMode.BINARY && unit instanceof BinaryImageUnit) {
+                imageData = ((BinaryImageUnit) unit).getImageData();
+            }
+            if (imageData != null) {
+                try {
+                    imageIO.saveToFile(imageData, savedDir + "/" + currentCapturedFramesCount + ".jpg", true);
+                } catch (UtilityException e) {
+                    e.printStackTrace();
+                }
+                currentCapturedFramesCount++;
+                if (currentCapturedFramesCount >= maxCapturedFramesCount) {
+                    finishCaptureVideoFrames();
+                }
+            }
+        }
+    }
+
+    private void finishCaptureVideoFrames() {
+        runOnUiThread(() -> {
+            btnCaptureVideoFrames.setEnabled(true);
+            currentCapturedFramesCount = -1;
+            findViewById(R.id.progress_bar).setVisibility(View.GONE);
+            new AlertDialog.Builder(CaptureActivity.this)
+                    .setPositiveButton("OK", null)
+                    .setTitle("Capture finished")
+                    .setMessage(String.format(Locale.getDefault(), "Capture finished!\nYou can find the captured images under: %s", savedDir))
+                    .show();
+        });
+    }
+
+    private void initActionBar() {
+        MaterialToolbar toolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(toolbar);
+        toolbar.setNavigationOnClickListener(v -> getOnBackPressedDispatcher().onBackPressed());
+    }
+
+    private void initBtnCaptureVideoFrames() {
+        btnCaptureVideoFrames = findViewById(R.id.btn_capture);
+        btnCaptureVideoFrames.setOnClickListener(v -> {
+            Log.e(TAG, "initBtnCaptureVideoFrames: "+camera.getResolution());
+            SimpleDateFormat format = new SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault());
+            savedDir = String.format(Locale.getDefault(), "%s/%s_%s_%s",
+                    getExternalCacheDir(),
+                    captureImageColourMode == ColorMode.COLOUR ? "colour" : captureImageColourMode == ColorMode.GRAYSCALE ? "grayscale" : "binary",
+                    scanRegion.replaceAll("\\s+", ""),
+                    format.format(System.currentTimeMillis()));
+            new File(savedDir).mkdirs();
+            btnCaptureVideoFrames.setEnabled(false);
+            currentCapturedFramesCount = 0;
+            findViewById(R.id.progress_bar).setVisibility(View.VISIBLE);
+        });
+    }
+
+    private void setupPreferences() {
+        SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(getApplicationContext());
+        maxCapturedFramesCount = Integer.parseInt(sharedPreferences.getString(PreferencesConstants.MAX_CAPTURED_FRAMES_COUNT, "10"));
+        captureImageColourMode = Integer.parseInt(sharedPreferences.getString(PreferencesConstants.CAPTURED_IMAGE_COLOUR, ColorMode.COLOUR + ""));
+        scanRegion = sharedPreferences.getString(PreferencesConstants.SCAN_REGION, PreferencesConstants.SCAN_REGION_FULL_IMAGE);
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.main_menu, menu);
+        return true;
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(@NonNull MenuItem item) {
+        if (item.getItemId() == R.id.menu_settings) {
+            startActivity(new Intent(this, SettingsActivity.class));
+            return true;
+        }
+        return super.onOptionsItemSelected(item);
+    }
+}

package/code-snippet/android/FoundationalAPISamples/Debug/src/main/java/com/dynamsoft/debug/HomeActivity.java

@@ -0,0 +1,28 @@
+package com.dynamsoft.debug;
+
+import android.content.Intent;
+import android.os.Bundle;
+
+import androidx.appcompat.app.AppCompatActivity;
+
+import com.dynamsoft.license.LicenseManager;
+
+public class HomeActivity extends AppCompatActivity {
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_home);
+
+        if(savedInstanceState == null) {
+            LicenseManager.initLicense("DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9", (isSuccess, error) -> {
+                if (!isSuccess) error.printStackTrace();
+            });
+        }
+
+        findViewById(R.id.btn_start_capturing).setOnClickListener(v->{
+            Intent intent = new Intent(this, CaptureActivity.class);
+            startActivity(intent);
+        });
+    }
+}

package/code-snippet/android/FoundationalAPISamples/Debug/src/main/java/com/dynamsoft/debug/settings/PreferencesConstants.java

@@ -0,0 +1,12 @@
+package com.dynamsoft.debug.settings;
+
+public class PreferencesConstants {
+    public static final String MAX_CAPTURED_FRAMES_COUNT = "max_captured_frames_count";
+    public static final String CAPTURED_IMAGE_COLOUR = "captured_image_colour";
+
+    public static final String SCAN_REGION = "scan_region";
+    public static final String SCAN_REGION_FULL_IMAGE = "Full image";
+    public static final String SCAN_REGION_SQUARE = "Square";
+    public static final String SCAN_REGION_RECTANGLE = "Rectangle";
+
+}