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
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="gphoto2_cl_binding" Version="0.1.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add gphoto2_cl_binding --version 0.1.3
#r "nuget: gphoto2_cl_binding, 0.1.3"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// 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.

  1. Install MSYS2

    Can be downloaded from msys2.org

  2. Once installed update the core packages using MSYS2 MINGW64 Shell (Make sure to use mingw64!)

    pacman -Syu

  3. Restart the shell after updating and update the rest

    pacman -Su

  4. Install gphoto2

    pacman -S mingw-w64-x86_64-gphoto2

  5. Add the folder containing mintty.exe to your environment path

    Tutorial from heldeskgeek.com

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .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