ffi-gphoto2 0.5.1 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 83f9c14b8b7006440420e875c32d4a93b809ce28
-  data.tar.gz: 9e3ccef87bc4565c88c4750e64d09ccde23f3330
+SHA256:
+  metadata.gz: 705f84af5e6252107a78d9f76cefe51f3d1f9933c6e48b07ce21b7d507db2841
+  data.tar.gz: 3691c97cfc7551b30d3d4aff35cb7c33b5c09d28d81bb073a86210923814fa32
 SHA512:
-  metadata.gz: 9d90104862dfccd44685aefa3870d83cde93e23a0aab57df6a7eb5a7feb2d9e712ca8c3125260b36f18b090df6ea8fce60726e913b667617f551180058c12397
-  data.tar.gz: f8536cef9cf2d3d7c9cfedb71fa0e7079280a7a7a0e7f579e1b886c4cba8e37e9316504e2298f1aabc0358638a3cd7f0ef5d20e5c87eee95ea4e15d82acef454
+  metadata.gz: 792e487489753ac550cdbe27330c67aa2b522263ed8632a18fbfa44076e0dddadc44c201ef8c9cfdd1524c2338705760b11d576856d2fd4d266f9f02606a2f32
+  data.tar.gz: 276768da7221b07894b389081af32849cb36b926df2e2961a41381391a6fc4311df4d0842b0a4045e56ad7defff4c8366a551e7b65d95d3f9b1567e62780994a

data/.travis.yml

@@ -0,0 +1,11 @@
+sudo: required
+dist: trusty
+language: ruby
+rvm:
+  - 2.3.1
+before_install:
+  - gem install bundler -v 1.12.5
+  - sudo apt-get -qq update
+  - sudo apt-get install libgphoto2-6 libgphoto2-port10
+  - sudo ln -s /usr/lib/x86_64-linux-gnu/libgphoto2.so{.6,}
+  - sudo ln -s /usr/lib/x86_64-linux-gnu/libgphoto2_port.so{.10,}

data/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+
+## HEAD
+
+## 0.8.0 (2020-06-29)
+
+* [FIX] Fix deprecation warning (`warning: rb_safe_level will be removed in
+  Ruby 3.0`) by updating to ffi 1.12.0.
+* [CHANGE] Raise minimum Ruby version to 2.0.0, which comes from the dependency
+  on ffi 1.12.0 (specifically 1.11.1).
+
+## 0.7.1 (2017-01-02)
+
+* [FIX] Load `ffi` before any usage of the bindings.
+
+## 0.7.0 (2016-09-19)
+
+* [CHANGE] Raise minimum `libgphoto2` version to 2.5.2. This version introduced
+  `gp_port_reset`.
+* [ADD] Add `FFI::GPhoto2Port::GPPort` struct and related functions to do a
+  port reset.
+
+## 0.6.1 (2016-08-21)
+
+* [FIX] `ManagedStruct.release` actually calls `*_free` functions. Autorelease
+  invocations were silently failing with a `TypeError` because the functions
+  expected structs, not pointers.
+
+## 0.6.0 (2016-07-11)
+
+* [FIX] Use the correct default filename when a `CameraFile` is a preview.
+* [ADD] Add `CameraFileInfo` and related operations. `CameraFile#info` only
+  supports files.
+* [FIX] `CameraWidget#label` calls the correct widget label function.
+* [FIX] `Camera#[]=` raises an `ArgumentError` when passed an invalid key
+  instead of failing on `nil`.
+* [ADD] Add `CameraAbilities#operations` to always return an `Integer`.
+  libgphoto2 does not stay in the defined enum set of `CameraOperations`;
+  therefore, it is treated as an integer bit field instead.
+* [CHANGE] Errors are thrown as `GPhoto2::Error` rather than `RuntimeError`.
+  Use `#message` and `#code` to extract the the GPhoto2 error message and
+  return code, respectively.
+* [ADD] `Camera#trigger` for trigger capture.
+* [FIX] `TextCameraWidget` values can by any object that implements `#to_s`.

data/README.md

@@ -1,6 +1,10 @@
 # ffi-gphoto2
 
-**ffi-gphoto2** provides an FFI for common functions in [libgphoto2][1].
+
+[![Gem Version](https://badge.fury.io/rb/ffi-gphoto2.svg)](https://badge.fury.io/rb/ffi-gphoto2)
+[![Build Status](https://travis-ci.org/zaeleus/ffi-gphoto2.svg?branch=master)](https://travis-ci.org/zaeleus/ffi-gphoto2)
+
+**ffi-gphoto2** provides an FFI for common functions in [libgphoto2][gphoto].
 It also includes a facade to interact with the library in a more
 idiomatic Ruby way.
 
@@ -8,8 +12,9 @@ idiomatic Ruby way.
 
 ### Prerequisites
 
-  * Ruby >= 1.9
-  * libgphoto2 >= 2.5.0
+  * Ruby >= 2.0
+  * libgphoto2 >= 2.5.2
+  * libgphoto2_port >= 0.10.1
 
 ### Gem
 
@@ -34,9 +39,17 @@ camera = cameras.first
 # ...or more conveniently
 camera = GPhoto2::Camera.first
 
-# ...or even search by model name
+# 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
+
 # check camera abilities (see `FFI::GPhoto2::CameraOperation.symbols`)
 camera.can? :capture_image
 # => true
@@ -97,14 +110,11 @@ file.save
 
 # ...and then delete it from the camera
 file.delete
-
-# close the camera
-camera.finalize
 ```
 
-More examples can be found in [`examples/`][2]. YARD documentation can be
-generated using the `rake yard` task or [browsed online][3].
+More examples can be found in [`examples/`][examples]. YARD documentation can be
+generated using the `rake yard` task or [browsed online][rubydoc].
 
-[1]: http://www.gphoto.org/
-[2]: https://github.com/zaeleus/ffi-gphoto2/tree/master/examples
-[3]: http://www.rubydoc.info/gems/ffi-gphoto2/frames
+[gphoto]: http://www.gphoto.org/
+[examples]: https://github.com/zaeleus/ffi-gphoto2/tree/master/examples
+[rubydoc]: http://www.rubydoc.info/gems/ffi-gphoto2/frames

data/examples/autofocus.rb

@@ -0,0 +1,21 @@
+require 'gphoto2'
+
+# Capture an image only after successfully autofocusing.
+#
+# Typically, if the camera fails to autofocus, updating the `autofocusdrive`
+# key will throw an "Unspecified error (-1)". This catches the exception and
+# continues to autofocus until it is successful.
+
+GPhoto2::Camera.first do |camera|
+  begin
+    camera.update(autofocusdrive: true)
+  rescue GPhoto2::Error
+    puts "autofocus failed... retrying"
+    camera.reload
+    retry
+  ensure
+    camera.update(autofocusdrive: false)
+  end
+
+  camera.capture
+end

data/examples/capture.rb

@@ -0,0 +1,8 @@
+require 'gphoto2'
+
+# Captures a single photo and saves it to the current working directory.
+
+GPhoto2::Camera.first do |camera|
+  file = camera.capture
+  file.save
+end

data/examples/continuous_burst.rb

@@ -0,0 +1,27 @@
+require 'gphoto2'
+
+# This example is limited to Nikon cameras with a continuous burst mode.
+
+# The number of frames to capture.
+N = 3
+
+GPhoto2::Camera.first do |camera|
+  # Set the camera to continuous burst mode.
+  camera.update(capturemode: 'Burst', burstnumber: N)
+
+  # Use `#trigger` instead of `#capture` so the data remains in the camera
+  # buffer.
+  camera.trigger
+
+  # Wait for the camera to process all the images.
+  queue = N.times.map do
+    event = camera.wait_for(:file_added)
+
+    # The event data contains a `CameraFile` when the `:file_added` event is
+    # triggered.
+    event.data
+  end
+
+  # Save all the images to the current working directory.
+  queue.each(&:save)
+end

data/examples/list_config.rb

@@ -14,6 +14,7 @@ def visit(widget, level = 0)
 
   indent << '  '
 
+  puts "#{indent}label: #{widget.label}"
   puts "#{indent}type: #{widget.type}"
   puts "#{indent}value: #{widget.value}"
 

data/examples/list_files.rb

@@ -0,0 +1,52 @@
+require 'gphoto2'
+
+# Recursively list folder contents with extended metadata.
+
+MAGNITUDES = %w[bytes KiB MiB GiB].freeze
+
+# @param [Integer] size filesize in bytes
+# @param [Integer[ precision
+# @return [String]
+def format_filesize(size, precision = 1)
+  n = 0
+
+  while size >= 1024.0 && n < MAGNITUDES.size
+    size /= 1024.0
+    n += 1
+  end
+
+  "%.#{precision}f %s" % [size, MAGNITUDES[n]]
+end
+
+# @param [CameraFolder] folder a root directory
+def visit(folder)
+  files = folder.files
+
+  puts "#{folder.path} (#{files.size} files)"
+
+  files.each do |file|
+    info = file.info
+
+    name = file.name
+    # Avoid using `File#size` here to prevent having to load the data along
+    # with it.
+    size = format_filesize(info.size)
+    mtime = info.mtime.utc.iso8601
+
+    if info.has_field?(:width) && info.has_field?(:height)
+      dimensions = "#{info.width}x#{info.height}"
+    else
+      dimensions = '-'
+    end
+
+    puts "#{name.ljust(30)}  #{size.rjust(12)}  #{dimensions.rjust(12)}  #{mtime}"
+  end
+
+  puts
+
+  folder.folders.each { |child| visit(child) }
+end
+
+GPhoto2::Camera.first do |camera|
+  visit(camera.filesystem)
+end

data/ffi-gphoto2.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://github.com/zaeleus/ffi-gphoto2'
 
   spec.authors       = ['Michael Macias']
-  spec.email         = ['mamacias@go.olemiss.edu']
+  spec.email         = ['zaeleus@gmail.com']
 
   spec.version       = GPhoto2::VERSION
   spec.license       = 'MIT'
@@ -19,13 +19,14 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
 
-  spec.requirements << 'libgphoto2 >= 2.5.0'
-  spec.required_ruby_version = '>= 1.9'
+  spec.requirements << 'libgphoto2 >= 2.5.2'
+  spec.requirements << 'libgphoto2_port >= 0.10.1'
+  spec.required_ruby_version = '>= 2.0'
 
-  spec.add_development_dependency 'bundler', '~> 1.3'
-  spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rspec', '~> 3.2.0'
-  spec.add_development_dependency 'yard', '~> 0.8.7'
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.9.0'
+  spec.add_development_dependency 'yard', '~> 0.9.0'
 
-  spec.add_dependency 'ffi', '~> 1.9.0'
+  spec.add_dependency 'ffi', '~> 1.12.0'
 end

data/lib/ffi/gphoto2.rb

@@ -1,3 +1,4 @@
+require 'ffi'
 require 'ffi/gphoto2_port'
 
 module FFI
@@ -11,7 +12,10 @@ module FFI
     require 'ffi/gphoto2/camera_driver_status'
     require 'ffi/gphoto2/camera_event_type'
     require 'ffi/gphoto2/camera_file_access_type'
+    require 'ffi/gphoto2/camera_file_info_fields'
     require 'ffi/gphoto2/camera_file_operation'
+    require 'ffi/gphoto2/camera_file_permissions'
+    require 'ffi/gphoto2/camera_file_status'
     require 'ffi/gphoto2/camera_file_type'
     require 'ffi/gphoto2/camera_folder_operation'
     require 'ffi/gphoto2/camera_operation'
@@ -23,15 +27,19 @@ module FFI
     require 'ffi/gphoto2/camera_abilities'
     require 'ffi/gphoto2/camera_abilities_list'
     require 'ffi/gphoto2/camera_file'
+    require 'ffi/gphoto2/camera_file_info_audio'
+    require 'ffi/gphoto2/camera_file_info_file'
+    require 'ffi/gphoto2/camera_file_info_preview'
+    require 'ffi/gphoto2/camera_file_info'
     require 'ffi/gphoto2/camera_file_path'
+    require 'ffi/gphoto2/entry'
     require 'ffi/gphoto2/camera_list'
     require 'ffi/gphoto2/camera_widget'
-    require 'ffi/gphoto2/entry'
     require 'ffi/gphoto2/gp_context'
 
     # gphoto2/gphoto2-abilities-list.h
     attach_function :gp_abilities_list_new, [:pointer], :int
-    attach_function :gp_abilities_list_free, [CameraAbilitiesList.by_ref], :int
+    attach_function :gp_abilities_list_free, [:pointer], :int
     attach_function :gp_abilities_list_load, [CameraAbilitiesList.by_ref, GPContext.by_ref], :int
     attach_function :gp_abilities_list_detect, [CameraAbilitiesList.by_ref, GPhoto2Port::GPPortInfoList.by_ref, CameraList.by_ref, GPContext.by_ref], :int
     attach_function :gp_abilities_list_lookup_model, [CameraAbilitiesList.by_ref, :string], :int
@@ -47,10 +55,12 @@ module FFI
     attach_function :gp_camera_get_config, [Camera.by_ref, :pointer, GPContext.by_ref], :int
     attach_function :gp_camera_set_config, [Camera.by_ref, CameraWidget.by_ref, GPContext.by_ref], :int
     attach_function :gp_camera_capture, [Camera.by_ref, CameraCaptureType, CameraFilePath.by_ref, GPContext.by_ref], :int, blocking: true
+    attach_function :gp_camera_trigger_capture, [Camera.by_ref, GPContext.by_ref], :int, blocking: true
     attach_function :gp_camera_capture_preview, [Camera.by_ref, CameraFile.by_ref, GPContext.by_ref], :int, blocking: true
     attach_function :gp_camera_wait_for_event, [Camera.by_ref, :int, :pointer, :pointer, GPContext.by_ref], :int
     attach_function :gp_camera_folder_list_files, [Camera.by_ref, :string, CameraList.by_ref, GPContext.by_ref], :int
     attach_function :gp_camera_folder_list_folders, [Camera.by_ref, :string, CameraList.by_ref, GPContext.by_ref], :int
+    attach_function :gp_camera_file_get_info, [Camera.by_ref, :string, :string, CameraFileInfo.by_ref, GPContext.by_ref], :int
     attach_function :gp_camera_file_get, [Camera.by_ref, :string, :string, CameraFileType, CameraFile.by_ref, GPContext.by_ref], :int, blocking: true
     attach_function :gp_camera_file_delete, [Camera.by_ref, :string, :string, GPContext.by_ref], :int
 
@@ -61,12 +71,12 @@ module FFI
 
     # gphoto2/gphoto2-file.h
     attach_function :gp_file_new, [:pointer], :int
-    attach_function :gp_file_free, [CameraFile.by_ref], :int
+    attach_function :gp_file_free, [:pointer], :int
     attach_function :gp_file_get_data_and_size, [CameraFile.by_ref, :pointer, :pointer], :int
 
     # gphoto2/gphoto2-list.h
     attach_function :gp_list_new, [:pointer], :int
-    attach_function :gp_list_free, [CameraList.by_ref], :int
+    attach_function :gp_list_free, [:pointer], :int
     attach_function :gp_list_count, [CameraList.by_ref], :int
     attach_function :gp_list_get_name, [CameraList.by_ref, :int, :pointer], :int
     attach_function :gp_list_get_value, [CameraList.by_ref, :int, :pointer], :int

data/lib/ffi/gphoto2/camera_abilities_list.rb

@@ -5,7 +5,7 @@ module FFI
     class CameraAbilitiesList < FFI::ManagedStruct
       # libgphoto2/gphoto2-abilities-list.c
       layout :count, :int,
-             :abilities, :pointer # CameraAbilities*
+             :abilities, CameraAbilities.by_ref
 
       def self.release(ptr)
         FFI::GPhoto2.gp_abilities_list_free(ptr)

data/lib/ffi/gphoto2/camera_file_info.rb

@@ -0,0 +1,10 @@
+module FFI
+  module GPhoto2
+    class CameraFileInfo < FFI::Struct
+      # libgphoto2/gphoto2-filesys.h
+      layout :preview, CameraFileInfoPreview,
+             :file, CameraFileInfoFile,
+             :audio, CameraFileInfoAudio
+    end
+  end
+end

data/lib/ffi/gphoto2/camera_file_info_audio.rb

@@ -0,0 +1,11 @@
+module FFI
+  module GPhoto2
+    class CameraFileInfoAudio < FFI::Struct
+      # gphoto2/gphoto2-filesys.h
+      layout :fields, CameraFileInfoFields,
+             :status, CameraFileStatus,
+             :size, :uint64,
+             :type, [:char, 64]
+    end
+  end
+end

data/lib/ffi/gphoto2/camera_file_info_fields.rb

@@ -0,0 +1,14 @@
+module FFI
+  module GPhoto2
+    # gphoto2/gphoto2-filesys.h
+    CameraFileInfoFields = enum :none, 0,
+                                :type, 1 << 0,
+                                :size, 1 << 2,
+                                :width, 1 << 3,
+                                :height, 1 << 4,
+                                :permissions, 1 << 5,
+                                :status, 1 << 6,
+                                :mtime, 1 << 7,
+                                :all, 0xff
+  end
+end

data/lib/ffi/gphoto2/camera_file_info_file.rb

@@ -0,0 +1,15 @@
+module FFI
+  module GPhoto2
+    class CameraFileInfoFile < FFI::Struct
+      # gphoto2/gphoto2-filesys.h
+      layout :fields, CameraFileInfoFields,
+             :status, CameraFileStatus,
+             :size, :uint64,
+             :type, [:char, 64],
+             :width, :uint32,
+             :height, :uint32,
+             :permissions, CameraFilePermissions,
+             :mtime, :time_t
+    end
+  end
+end

data/lib/ffi/gphoto2/camera_file_info_preview.rb

@@ -0,0 +1,13 @@
+module FFI
+  module GPhoto2
+    class CameraFileInfoPreview < FFI::Struct
+      # gphoto2/gphoto2-filesys.h
+      layout :fields, CameraFileInfoFields,
+             :status, CameraFileStatus,
+             :size, :uint64,
+             :type, [:char, 64],
+             :width, :uint32,
+             :height, :uint32
+    end
+  end
+end

data/lib/ffi/gphoto2/camera_file_permissions.rb

@@ -0,0 +1,9 @@
+module FFI
+  module GPhoto2
+    # gphoto2/gphoto2-filesys.h
+    CameraFilePermissions = enum :none, 0,
+                                 :read, 1 << 0,
+                                 :delete, 1 << 1,
+                                 :all, 0xff
+  end
+end

data/lib/ffi/gphoto2/camera_file_status.rb

@@ -0,0 +1,7 @@
+module FFI
+  module GPhoto2
+    # gphoto2/gphoto2-filesys.h
+    CameraFileStatus = enum :not_downloaded,
+                            :downloaded
+  end
+end