node-gphoto2

To interact with cameras, instantiate GPhoto2 from the gphoto2 module. You can manage logging, list available cameras, and perform actions like taking pictures or downloading files.

Logging

Use setLogLevel(level) to enable logging (levels 0-4). You can listen to the log event to capture output.

Camera Operations

After calling list(), you receive an array of camera objects. Common operations on a camera object include:

• getConfig(callback): Retrieves the configuration tree.
• setConfigValue(key, value, callback): Sets a specific configuration value.
• takePicture(options, callback): Captures an image. Options include download, keep, preview, and targetPath.
• downloadPicture(options, callback): Downloads an existing image from the camera using cameraPath and targetPath.

Note: The following example requires asynchronous control flow logic to be implemented in a real application.

var fs = require('fs');
var gphoto2 = require('gphoto2');
var GPhoto = new gphoto2.GPhoto2();

// Configure logging
GPhoto.setLogLevel(1);
GPhoto.on('log', function (level, domain, message) {
  console.log(domain, message);
});

// List cameras
GPhoto.list(function (list) {
  if (list.length === 0) return;
  var camera = list[0];
  console.log('Found', camera.model);

  // Get configuration
  camera.getConfig(function (er, settings) {
    console.log(settings);
  });

  // Set configuration
  camera.setConfigValue('capturetarget', 1, function (er) {
    // handle error/success
  });

  // Take picture and download to buffer
  camera.takePicture({download: true}, function (er, data) {
    fs.writeFileSync(__dirname + '/picture.jpg', data);
  });

  // Take picture and download to specific filesystem path
  camera.takePicture({
    targetPath: '/tmp/foo.XXXXXX'
  }, function (er, tmpname) {
    fs.renameSync(tmpname, __dirname + '/picture.jpg');
  });

  // Download an existing picture
  camera.downloadPicture({
    cameraPath: '/store_00020001/DCIM/100CANON/IMG_1231.JPG',
    targetPath: '/tmp/foo.XXXXXX'
  }, function (er, tmpname) {
    fs.renameSync(tmpname, __dirname + '/picture.jpg');
  });
});

The GPCamera class provides the primary interface for interacting with a camera via gphoto2. It exposes asynchronous methods for retrieving configuration, setting configuration values, taking pictures, and downloading pictures.

Note: Most operations are asynchronous and utilize callbacks to return results.

// Conceptual usage based on exported symbols

// Retrieve the full configuration tree
camera.getConfig((err, config) => {
  console.log(config);
});

// Get a specific configuration value by key
camera.getConfigValue('key_name', (err, value) => {
  console.log(value);
});

// Set a configuration value
camera.setConfigValue('key_name', value, (err) => {
  if (err) console.error(err);
});

// Capture a picture
camera.takePicture((err, result) => {
  console.log('Picture taken');
});

// Download a picture
camera.downloadPicture((err, filePath) => {
  console.log('Downloaded to:', filePath);
});

The GPhoto2 class is the primary interface for interacting with the gphoto2 library via Node.js. It provides methods for managing camera connections and inspecting available hardware.

Key methods available on the instance include:

• List(): Asynchronously retrieves a list of available camera ports/information.
• SetLogLevel(level): Configures the verbosity of the library's logging.
• openCamera(camera): Opens a connection to a specific camera instance.
• closeCamera(camera): Closes the connection to a camera.

Note: List() is an asynchronous operation that returns results via a callback.

// Example conceptual usage based on the GPhoto2 class definition
const gphoto2 = require('node-gphoto2');
const gphoto = new gphoto2.GPhoto2();

// List available cameras
gphoto.List((err, list) => {
  if (err) throw err;
  console.log('Available cameras:', list);
});

// Set log level
gphoto.SetLogLevel(1);