Camera

Show a live viewfinder and capture JPEG photos for attachments, scanning, or a profile image. day-piece-camera exposes a Piece for the preview and observable state for the capture controls. It does not save to the system photo library or record video.

Add to your app

Add day-piece-camera to your app’s Cargo dependencies:

[dependencies]
day-piece-camera = "0.1"

Crate · API reference · Source. The Day CLI enables the selected toolkit’s integration and packages its native camera code. Declare the permission in Day.toml:

[permissions]
camera = true

Provide its rationale and the button label in the app’s translation catalogs:

permission_camera = Take photos to attach to your notes.
take_photo = Take photo

See permissions for generated platform declarations and denial handling.

Preview and capture

This component belongs in an app with day::resources!() and the messages above. The shutter is enabled only while the session is running.

use day::prelude::*;
use day_piece_camera::{CameraState, Photo, camera};

pub fn camera_panel() -> impl Piece {
    let shutter = Trigger::new();
    let state = Signal::new(CameraState::Idle);
    let photo: Signal<Option<Photo>> = Signal::new(None);
    column((
        camera()
            .auto_request()
            .capture(shutter)
            .state(state)
            .photo(photo)
            .frame(320.0, 240.0),
        button(res::str::take_photo())
            .enabled(move || state.get() == CameraState::Running)
            .action(move || shutter.notify()),
    ))
}

auto_request() opts into the system permission prompt when the session is wanted. Otherwise the app requests access itself; an undecided permission leaves the session idle. The active() binding starts or stops the session, and facing() selects the front or back camera. Removing the piece releases its session.

Results and errors

CameraState distinguishes idle, starting, running, unavailable hardware, denied permission, and a native error. A compiled renderer is not evidence of a usable camera: check both support() and runtime state. Translate app-facing error messages through the catalog; retain native error details for diagnostics.

A Photo contains a cache-file path and its width and height. bytes() reads the file synchronously; perform larger reads away from the UI thread. Move or copy photos to persistent storage before treating them as saved attachments. Cache files can be removed by the OS, and the piece does not manage a photo-library permission or save operation.

Platform support

Torch, zoom, and video recording are not exposed by this release. Use media playback to display an existing recording, and files and directories to retain captured photos.