day-piece-camera 0.1.0

A camera viewfinder with photo capture for Day apps on iOS, Android and HarmonyOS
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

// Copyright © The Daybrite Project
// SPDX-License-Identifier: MPL-2.0

// ---------------------------------------------------------------------------
// Android: a CameraX PreviewView with an ImageCapture use case, created by this crate's Java
// (src/DayCamera.java) and folded into the app's Gradle build via
// [package.metadata.day.android] (which also declares the CameraX dependencies), without
// touching day-toolkit-material. Reports come back through DayBridge.nativeOnEvent's Custom kind, carrying
// the node id the view was made with.
// ---------------------------------------------------------------------------

use super::*;
use day_toolkit_material::{AHandle, Material, java};
use day_spec::NodeId;

// This piece's Java class (src/DayCamera.java, on the app classpath at build).
day_toolkit_material::java_class! {
    DayCamera => dev.daybrite.day.piece.camera.DayCamera,
    methods {
        static fn makeCamera(id: jlong, facing: jint, active: jboolean) -> android.view.View,
        static fn cameraCommand(view: android.view.View, cmd: jint, arg: jint),
        static fn releaseCamera(view: android.view.View),
    },
}

/// Commands, as the Java side numbers them.
const CMD_START: i32 = 0;
const CMD_STOP: i32 = 1;
const CMD_CAPTURE: i32 = 2;
const CMD_FACING: i32 = 3;

fn make(_backend: &mut Material, p: &CameraProps, id: NodeId) -> AHandle {
    // A Java throw (the CameraX dependency missing from the app build, say) must not panic
    // inside realize: the panic unwinds the JNI up-call and aborts. Placeholder instead.
    let (facing, active) = (p.facing.code(), p.active);
    day_toolkit_material::realize("camera", |env| {
        DayCamera::makeCamera(env, id.0 as i64, facing, active)
    })
}

fn update(_backend: &mut Material, h: &AHandle, patch: &CameraPatch) {
    let (cmd, arg) = match patch {
        CameraPatch::Start => (CMD_START, 0),
        CameraPatch::Stop => (CMD_STOP, 0),
        CameraPatch::Capture => (CMD_CAPTURE, 0),
        CameraPatch::Facing(f) => (CMD_FACING, f.code()),
        // The ArkTS surface handshake is HarmonyOS's alone.
        CameraPatch::Surface(_) => return,
    };
    java(|env| DayCamera::cameraCommand(env, h.0.as_obj(), cmd, arg));
}

/// The renderer's release: unbind the use cases so the camera is freed the moment the page goes
/// away, not when the activity does.
fn release(_backend: &mut Material, h: &AHandle) {
    java(|env| DayCamera::releaseCamera(env, h.0.as_obj()));
}

day_pieces::renderer!(day_toolkit_material::RENDERERS, Material,
    kind: KIND, props: CameraProps, patch: CameraPatch, make: make, update: update,
    measure: day_pieces::fill_measure, release: release);