Add README.md

Author: yushulx

examples/barcode-scanner/README.md

@@ -0,0 +1,75 @@
+# LiteCam: Java Camera SDK + Barcode Scanner
+
+This project provides two main components: a lightweight **Java Camera SDK** for cross-platform video capture and a complete **Java Barcode Scanner** application demonstrating real-time barcode detection.
+
+## Prerequisites
+- **Java JDK 8+** and **Maven 3.6+**
+- **Camera device** (for scanner application)
+- Platform dependencies: Windows (Visual Studio), Linux (`libx11-dev libv4l-dev`), macOS (Xcode)
+
+
+## Components
+
+### 1. LiteCam Java Camera SDK
+Lightweight cross-platform camera capture library with JNI bridge.
+
+```bash
+# 1. Build Camera SDK
+.\build-jar.ps1          # Windows
+./build-jar.sh           # Linux/macOS
+
+# 2. Run Tests
+.\run-litecam.ps1 # Windows
+./run-litecam.sh  # Linux/macOS
+```
+
+**Features:**
+- Cross-platform video capture (Windows/Linux/macOS)
+- Direct RGB frame access via ByteBuffer
+- Multiple resolution support
+- Minimal overhead JNI implementation
+
+### 2. Java Barcode Scanner Application  
+Complete barcode scanning application built with the Camera SDK, Dynamsoft Barcode Reader and ZXing.
+
+```bash
+# 1. Build Barcode Scanner
+.\build.ps1       # Windows
+./build.sh           # Linux/macOS
+
+# 2. Run the app
+.\run.ps1 # Windows
+./run.sh  # Linux/macOS
+```
+
+**Features:**
+- Real-time camera scanning with visual overlays
+- Dual engines: ZXing (open-source) + Dynamsoft Barcode Reader (enterprise)
+- File processing mode with drag-and-drop
+- 25+ barcode formats (1D/2D/Postal)
+
+
+## Quick Start
+
+```java
+// List cameras
+String[] devices = LiteCam.listDevices();
+
+// Open camera
+LiteCam cam = new LiteCam();
+cam.openDevice(0);
+cam.setResolution(640, 480);
+
+// Capture frames
+ByteBuffer buffer = ByteBuffer.allocateDirect(640 * 480 * 3);
+if (cam.grabFrame(buffer)) {
+    // Process RGB data
+    byte[] frameData = new byte[buffer.remaining()];
+    buffer.get(frameData);
+}
+
+cam.close();
+```
+
+
+

examples/barcode-scanner/maven-example/run.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+# Run LiteCam Barcode Scanner
+# Shell script to run the Maven-built application
+
+set -e
+
+JAR_PATH="target/litecam-barcode-scanner-1.0.0.jar"
+
+echo "Starting LiteCam Barcode Scanner..."
+
+# Check if JAR exists
+if [ ! -f "$JAR_PATH" ]; then
+    echo "Error: JAR file not found at $JAR_PATH" >&2
+    echo "Please build the project first:" >&2
+    echo "  ./build.sh" >&2
+    echo "  OR" >&2
+    echo "  mvn package" >&2
+    exit 1
+fi
+
+# Check Java
+if ! command -v java &> /dev/null; then
+    echo "Error: Java is not installed or not found in PATH" >&2
+    echo "Please install Java and make sure it's accessible from PATH." >&2
+    exit 1
+fi
+
+# Get JAR size for info
+if command -v stat &> /dev/null; then
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        # macOS stat command
+        jar_size=$(stat -f%z "$JAR_PATH" 2>/dev/null || echo "0")
+    else
+        # Linux stat command
+        jar_size=$(stat -c%s "$JAR_PATH" 2>/dev/null || echo "0")
+    fi
+    jar_size_mb=$(echo "scale=2; $jar_size / 1048576" | bc 2>/dev/null || echo "unknown")
+    echo "JAR file: $JAR_PATH (${jar_size_mb} MB)"
+else
+    echo "JAR file: $JAR_PATH"
+fi
+
+echo "Starting application..."
+
+# Run the application
+java -jar "$JAR_PATH" "$@"

examples/barcode-scanner/run-litecam.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+# Shell script to run LiteCam Java Viewer
+
+set -e
+
+# Get the directory of this script
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+JAR_PATH="$SCRIPT_DIR/litecam.jar"
+
+# Check if JAR file exists
+if [ ! -f "$JAR_PATH" ]; then
+    echo "Error: litecam.jar not found in $SCRIPT_DIR" >&2
+    echo "Please run build-jar.sh first to build the JAR file." >&2
+    exit 1
+fi
+
+# Check if Java is available
+if ! command -v java &> /dev/null; then
+    echo "Error: Java is not installed or not found in PATH" >&2
+    echo "Please install Java and make sure it's accessible from PATH." >&2
+    exit 1
+fi
+
+echo "Starting LiteCam Java Viewer..."
+
+# Run the application
+java -cp "$JAR_PATH" com.example.litecam.LiteCamViewer "$@"