gphoto2_cl_binding 0.1.3
dotnet add package gphoto2_cl_binding --version 0.1.3
NuGet\Install-Package gphoto2_cl_binding -Version 0.1.3
<PackageReference Include="gphoto2_cl_binding" Version="0.1.3" />
paket add gphoto2_cl_binding --version 0.1.3
#r "nuget: gphoto2_cl_binding, 0.1.3"
// Install gphoto2_cl_binding as a Cake Addin
#addin nuget:?package=gphoto2_cl_binding&version=0.1.3
// Install gphoto2_cl_binding as a Cake Tool
#tool nuget:?package=gphoto2_cl_binding&version=0.1.3
Command line bindings of GPhoto2 for C#
This is a binding for gphoto2 command line tool. (WARNING This classlib depends on gphoto2 command!)
Currently it has been tested to work on the following platforms:
- Ubuntu 20.04 (Any Linux based system should work though)
- Windows 10 1909> (Using MSYS2 for gphoto2)
- MacOS 10.15 Catalina (Mojave and High Sierra might work too but can't test that)
Platforms that are planned to be supported:
- Windows 10 2004> using WSL2 (Waiting for proper USB support in WSL2)
Camera's used to test this binder:
- Canon EOS 760D
I currently only own this camera, I will try to test more when I get my hands on more equipment.
Dependencies
This project solely depends on the gphoto2 command which can be installed as follows:
Windows
Windows does not natively support gphoto2 so to get around this you can use MSYS2 and soon hopefully Windows Subsystem for Linux 2 (WSL2) but we need to wait for USB support to be added on WSL2.
Until that time MSYS2 seems to be the best option to install gphoto2 please follow these steps to install gphoto2.
Install MSYS2
Can be downloaded from msys2.org
Once installed update the core packages using MSYS2 MINGW64 Shell (Make sure to use mingw64!)
pacman -Syu
Restart the shell after updating and update the rest
pacman -Su
Install gphoto2
pacman -S mingw-w64-x86_64-gphoto2
Add the folder containing mintty.exe to your environment path
MacOS
Make sure you have brew installed (Installing brew)
brew install gphoto2
Ubuntu/Debian
sudo apt install gphoto2
Other linux based distros
Find out if your package manager has a source which can install gphoto2
What is currently implemented
- List connected cameras (Returns model no. and usb port info)
- Get/set config for any supported config string
- Basic camera settings such as ISO, aperture, shutter speed, aspect ratio, image format and capture target.
- Capturing images which returns a list of files created
- Capturing images in bulb mode (Also returns a list of files created)
- Checking if device is locked or is connected
- Read storage information (Capacity, storage type and free space left)
- Listing files/folders
- Checking if file/folder exists
- Deleting files (Single file/entire folder)
- Downloading of files with specific methods (single file, range of files or entire folders)
- More efficient multi-get/set so we have to queury commands less often
- Maybe more if you are in need of a feature please request it by making a new issue in the issue tracker
Examples
In test/
contains some performance tests and functionality tests, here you can see how to use this library. Proper examples will be added later.
But a bare-bones example is as follows:
- Reference this library
Camera cam = Cli.AutoDetect()[0];
cam.captureTarget = CaptureTarget.MemoryCard;
cam.iso = 800;
cam.shutterSpeed = "1/10";
cam.aspectRatio = "3:2";
cam.aperture = 5.6;
cam.imageFormat = ImageFormat.RAWAndLargeFineJPEG;
cam.captureImage();
Known issues
Windows related: Currently windows does not allow WSL to talk directly to USB hardware (I am aware of some developments so I hope soon it can) to make it work on Windows at the moment we are using mintty from MSYS2 with gphoto2 installed in mingw64. This introduces a bug whenever executing a command it will unfocus the currently focused window due to mintty hiding it's own window but still stealing focus.
I will try to get WSL2 to work whenever that is ready.
Contributing
Make a PR and explain clearly what it fixes, enhances, adds or whatever you have done. I will review it and if I think it's sufficient then I will merge it.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
0.1.3 | 543 | 5/3/2020 |