@succinctlabs/react-native-zcam1 0.3.0 → 0.4.0-alpha.2

package/android/src/main/java/com/succinctlabs/zcam1sdk/Zcam1SdkModule.kt

@@ -0,0 +1,43 @@
+// Generated by uniffi-bindgen-react-native
+package com.succinctlabs.zcam1sdk
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.annotations.ReactModule
+import com.facebook.react.turbomodule.core.interfaces.CallInvokerHolder
+
+@ReactModule(name = Zcam1SdkModule.NAME)
+class Zcam1SdkModule(reactContext: ReactApplicationContext) :
+  NativeZcam1SdkSpec(reactContext) {
+
+  override fun getName(): String {
+    return NAME
+  }
+
+  // Two native methods implemented in cpp-adapter.cpp, and ultimately
+  // zcam1-sdk.cpp
+
+  external fun nativeInstallRustCrate(runtimePointer: Long, callInvoker: CallInvokerHolder): Boolean
+  external fun nativeCleanupRustCrate(runtimePointer: Long): Boolean
+
+  override fun installRustCrate(): Boolean {
+    val context = this.reactApplicationContext
+    return nativeInstallRustCrate(
+      context.javaScriptContextHolder!!.get(),
+      context.jsCallInvokerHolder!!
+    )
+  }
+
+  override fun cleanupRustCrate(): Boolean {
+    return nativeCleanupRustCrate(
+      this.reactApplicationContext.javaScriptContextHolder!!.get()
+    )
+  }
+
+  companion object {
+    const val NAME = "Zcam1Sdk"
+
+    init {
+      System.loadLibrary("zcam1-sdk")
+    }
+  }
+}

package/android/src/main/java/com/succinctlabs/zcam1sdk/Zcam1SdkPackage.kt

@@ -0,0 +1,34 @@
+// Generated by uniffi-bindgen-react-native
+package com.succinctlabs.zcam1sdk
+
+import com.facebook.react.TurboReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class Zcam1SdkPackage : TurboReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return if (name == Zcam1SdkModule.NAME) {
+      Zcam1SdkModule(reactContext)
+    } else {
+      null
+    }
+  }
+
+  override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+    return ReactModuleInfoProvider {
+      val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+      moduleInfos[Zcam1SdkModule.NAME] = ReactModuleInfo(
+        Zcam1SdkModule.NAME,
+        Zcam1SdkModule.NAME,
+        false,  // canOverrideExistingModule
+        false,  // needsEagerInit
+        false,  // isCxxModule
+        true // isTurboModule
+      )
+      moduleInfos
+    }
+  }
+}

package/android/src/main/java/com/succinctlabs/zcam1sdk/camera/CameraUtils.kt

@@ -0,0 +1,80 @@
+package com.succinctlabs.zcam1sdk.camera
+
+/**
+ * Pure utility functions for camera operations.
+ * No Android framework dependencies — testable with plain JUnit.
+ *
+ * Flash and lens facing constants mirror CameraX values so they can be
+ * passed directly to ImageCapture.flashMode and CameraSelector.requireLensFacing.
+ */
+object CameraUtils {
+
+    // 0.75g threshold in m/s² (matching iOS CoreMotion ±0.75g)
+    // 0.75 * 9.80665 = 7.354987...
+    private const val GRAVITY_THRESHOLD = 7.355f
+
+    // ImageCapture flash mode constants
+    const val FLASH_AUTO = 0  // ImageCapture.FLASH_MODE_AUTO
+    const val FLASH_ON = 1    // ImageCapture.FLASH_MODE_ON
+    const val FLASH_OFF = 2   // ImageCapture.FLASH_MODE_OFF
+
+    // CameraSelector lens facing constants
+    const val LENS_FACING_FRONT = 0  // CameraSelector.LENS_FACING_FRONT
+    const val LENS_FACING_BACK = 1   // CameraSelector.LENS_FACING_BACK
+
+    /**
+     * Compute device orientation from accelerometer readings.
+     *
+     * Android accelerometer returns m/s² including gravity reaction force.
+     * Portrait upright: y ≈ +9.81, Upside down: y ≈ -9.81
+     * Landscape left (CCW): x ≈ +9.81, Landscape right (CW): x ≈ -9.81
+     *
+     * When no axis exceeds the threshold (device at ~45°), the current
+     * orientation is preserved (deadzone behavior matching iOS).
+     *
+     * @param x Accelerometer x-axis value in m/s²
+     * @param y Accelerometer y-axis value in m/s²
+     * @param current Current orientation to preserve in deadzone
+     * @return Orientation in degrees: 0, 90, 180, or 270
+     */
+    fun computeOrientation(x: Float, y: Float, current: Int): Int {
+        return when {
+            x > GRAVITY_THRESHOLD -> 90    // landscape left
+            x < -GRAVITY_THRESHOLD -> 270  // landscape right
+            y > GRAVITY_THRESHOLD -> 0     // portrait
+            y < -GRAVITY_THRESHOLD -> 180  // upside down
+            else -> current                // deadzone: keep current
+        }
+    }
+
+    /**
+     * Map flash mode string to CameraX integer constant.
+     * @param mode "on", "off", or "auto" (case-insensitive)
+     * @return Flash mode constant (FLASH_ON, FLASH_OFF, or FLASH_AUTO)
+     */
+    fun mapFlashMode(mode: String): Int = when (mode.lowercase()) {
+        "on" -> FLASH_ON
+        "auto" -> FLASH_AUTO
+        else -> FLASH_OFF
+    }
+
+    /**
+     * Clamp zoom ratio to valid range [1.0, maxZoom].
+     * @param requested Desired zoom ratio
+     * @param maxZoom Maximum zoom ratio from camera info
+     * @return Clamped zoom ratio
+     */
+    fun clampZoom(requested: Float, maxZoom: Float): Float {
+        return requested.coerceIn(1.0f, maxZoom)
+    }
+
+    /**
+     * Map lens facing string to CameraX integer constant.
+     * @param facing "front" or "back" (case-insensitive)
+     * @return Lens facing constant (LENS_FACING_FRONT or LENS_FACING_BACK)
+     */
+    fun mapLensFacing(facing: String): Int = when (facing.lowercase()) {
+        "front" -> LENS_FACING_FRONT
+        else -> LENS_FACING_BACK
+    }
+}