gphoto2.cr alternatives and similar shards
Based on the "Low level bindings" category.
Alternatively, view gphoto2.cr alternatives based on common mentions on social networks and blogs.
-
termbox-crystal
Bindings, wrapper, and utilities for termbox (terminal interface library) in Crystal -
serialport.cr
Crystal bindings for libserialport: cross-platform library for accessing serial ports.
CodeRabbit: AI Code Reviews for Developers
Do you think we are missing an alternative of gphoto2.cr or a related project?
README
gphoto2.cr
gphoto2.cr provides an FFI for common functions in libgphoto2. It also includes a facade to interact with the library in a more idiomatic Crystal way.
Installation
Prerequisites
- Crystal >= 0.35.1
- libgphoto2 >= 2.5.2
- libgphoto2_port >= 0.10.1
To install the latest libgphoto2, you can use homebrew
or apt-get
, depending on the platform:
Mac OS X
$ brew install libgphoto2
Debian/Ubuntu
$ apt-get install libgphoto2-6 libgphoto2-dev libgphoto2-port10
Shard
Add this to your application's shard.yml
:
dependencies:
gphoto2:
github: Sija/gphoto2.cr
Usage
require "gphoto2"
# list available cameras
cameras = GPhoto2::Camera.all
# => [#<GPhoto2::Camera>, ...]
# list found cameras by model and port path
cameras.map { |c| [c.model, c.port] }
# => [["Nikon DSC D5100 (PTP mode)", "usb:250,006"], ...]
# use the first camera
camera = cameras.first
# ...or more conveniently
camera = GPhoto2::Camera.first
# search by model name
camera = GPhoto2::Camera.where(model: /nikon/i).first
# the above examples require the camera be manually closed when done
camera.close
# pass a block to automatically close the camera
GPhoto2::Camera.first do |camera|
# ...
end
# ...or use `#autorelease` on any `Camera` instance
camera.autorelease do
# ...
end
# check camera abilities (see `LibGPhoto2::CameraOperation`)
camera.can? :capture_image
# => true
# list camera configuration names
camera.config.keys
# => ["autofocusdrive", "manualfocusdrive", "controlmode", ...]
# read the current configuration value of an option
camera[:expprogram].value
# => "M"
camera[:whitebalance].value
# => "Automatic"
# compare the current configuration value
camera[:whitebalance] == "Automatic"
camera[:whitebalance] == /Automatic/i
camera[:whitebalance] == :automatic
# => true
# list valid choices of a configuration option
camera[:whitebalance].as_radio.choices
# => ["Automatic", "Daylight", "Fluorescent", "Tungsten", ...]
# check if the configuration has changed
camera.dirty?
# => false
# change camera configuration
camera["iso"] = 800
camera["f-number"] = "f/4.5"
camera["shutterspeed2"] = "1/30"
# set radio widget value to first matching option
camera[:imageformat] = /Medium(.+?)JPEG/i
# check if the configuration has changed
camera.dirty?
# => true
# apply the new configuration to the device
camera.save
# alternatively, update the camera configuration in one go
camera.update({ iso: 200, shutterspeed2: "1/60", "f-number": "f/1.8" })
# ...do all of above while preserving camera original configuration
camera.preserving_config do
# ...
end
# take a photo
file = camera.capture
# ...and save it to the current working directory
file.save
# ...or to a specific pathname
file.save("/tmp/out.jpg")
# traverse the camera filesystem
folder = camera/"store_00010001/DCIM/100D5100"
# list files
files = folder.files
folder.files.map(&.name)
# => ["DSC_0001.JPG", "DSC_0002.JPG", ...]
# copy a file from the camera
file = files.first
file.save
# ...and then delete it from the camera
file.delete
More examples can be found in examples/
. Documentation can be generated using crystal doc
task or browsed online.
Development
Enable debug mode by passing DEBUG=1
env variable:
DEBUG=1 crystal examples/list_cameras.cr
Run specs with:
crystal spec
Contributing
- Fork it ( https://github.com/Sija/gphoto2.cr/fork )
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -am 'Add some feature')
- Push to the branch (git push origin my-new-feature)
- Create a new Pull Request
Acknowledgements
- The gphoto2 developers for building such an awesome tool
- @zaeleus for the ffi-gphoto2 gem, on which this library is heavily inspired
Contributors
- @Sija Sijawusz Pur Rahnama - creator, maintainer
*Note that all licence references and agreements mentioned in the gphoto2.cr README section above
are relevant to that project's source code only.