viva-genicam

High-level GenICam facade: camera discovery, feature control, image streaming, events, and action commands.

This is the main entry point for the viva-genicam workspace. It re-exports the lower-level crates and provides convenience wrappers so you can get started with a single dependency.

Disclaimer -- Independent open-source Rust implementation of GenICam-related standards. Not affiliated with, endorsed by, or the reference implementation of EMVA GenICam. GenICam is a trademark of EMVA.

Features

• Discovery -- find GigE Vision cameras on any network interface
• Connect & control -- connect_gige() one-liner for camera connection with automatic XML fetch
• Feature access -- typed get/set for Integer, Float, Enum, Boolean, Command, String features
• Streaming -- FrameStream async iterator with resend, reassembly, and backpressure
• Events & actions -- subscribe to camera events; trigger synchronized acquisition
• Chunks & timestamps -- parse chunk data; map device timestamps to host time
• USB3 Vision -- optional u3v feature for USB3 Vision cameras

Usage

[dependencies]
viva-genicam = "0.1"

use viva_genicam::{gige, Camera};
use std::time::Duration;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let devices = gige::discover(Duration::from_secs(1)).await?;
    let (mut camera, _xml) = viva_genicam::connect_gige(&devices[0]).await?;
    camera.set("ExposureTime", "5000")?;
    let val = camera.get("ExposureTime")?;
    println!("ExposureTime = {val}");
    Ok(())
}

Feature flags

Documentation

• API reference (docs.rs)
• Book & tutorials
• Examples

Part of the viva-genicam workspace.