#camera-image #camera #pylon #bindings #image #api-bindings #basler

sys pylon-cxx

Rust wrapper of the Pylon libraries for Basler cameras

20 releases

0.4.2 Nov 18, 2024
0.4.1 Jun 25, 2024
0.4.0 May 29, 2024
0.3.8 Jan 31, 2024
0.1.4 Jun 26, 2021

#200 in Images

Download history 47/week @ 2024-08-13 31/week @ 2024-08-20 31/week @ 2024-08-27 34/week @ 2024-09-03 197/week @ 2024-09-10 414/week @ 2024-09-17 333/week @ 2024-09-24 436/week @ 2024-10-01 550/week @ 2024-10-08 537/week @ 2024-10-15 480/week @ 2024-10-22 291/week @ 2024-10-29 237/week @ 2024-11-05 447/week @ 2024-11-12 480/week @ 2024-11-19 759/week @ 2024-11-26

1,946 downloads per month

MIT/Apache

62KB
1.5K SLoC

Rust 1K SLoC // 0.0% comments C++ 365 SLoC // 0.1% comments

pylon-cxx-rs

Crates.io

Rust wrapper of the Pylon libraries for Basler cameras using CXX.

Platform support

Windows, linux, and macOS are all tested.

async stream with tokio

Enable async stream support using tokio with the cargo feature stream. This feature is currently not compatible with Windows (help wanted).

Building

This crate expects to find the Pylon developer kit at the usual install location. Build with normal rust commands. For example, to run the grab example:

cargo run --example grab

On macOS

On macOS, building should work, but it is required update your environment variables to run the produced binaries:

export DYLD_LIBRARY_PATH="/Library/Frameworks/pylon.framework/Versions/A/Libraries/"

I have seen articles like https://jorgen.tjer.no/post/2014/05/20/dt-rpath-ld-and-at-rpath-dyld/ which suggest a way to avoid this issue.

Camera emulation

See Basler's documentation. This can simulate different frame rates, failures, etc.

# on bash (e.g. linux)
export PYLON_CAMEMU=2
# in Windows Powershell
$Env:PYLON_CAMEMU=2

Code of conduct

Anyone who interacts with this software in any space, including but not limited to this GitHub repository, must follow our code of conduct.

License

This crate is Copyright (C) 2020 Andrew Straw strawman@astraw.com.

Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0> or the MIT license <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your option. This file may not be copied, modified, or distributed except according to those terms.

Note that this license only covers this Rust crate. The underlying Pylon library has different license terms.

Dependencies

~0.6–9.5MB
~88K SLoC