@brick-a-brack/napi-canon-cameras

EDSDK (Canon camera) wrapper module for Node.js

• Features
• Usage Example
• Build Package
  • NPM Tasks
• FAQ
• API Documentation

Features

The EDSDK provides a lot of features and not all of them are implemented in the module. Our use case was a photo booth application.

• [x] List Cameras
• [x] Camera Events
• [ ] Read Camera Properties
  • [x] Text
  • [x] Integer
    • [x] Flags (true/false)
    • [x] Options (named list values)
    • [x] Aperture
    • [x] Shutter Speed
    • [x] Exposure Compensation
  • [x] Integer Array
  • [x] Time
• [ ] Write Camera Properties
  • [ ] Text Properties
  • [x] Integer
  • [ ] Integer Array
  • [ ] Time
• [x] Take Picture
  • [x] Download To Directory
  • [x] Download To File
  • [x] Download To String (Base64)
• [ ] Live View
  • [x] Download Image To Data URL
  • [x] Properties
  • [x] Histogram
  • [ ] Rolling & Pitching
  • [ ] PowerZoom
• [ ] Storage
  • [x] List Volumes
  • [x] List Directories and Files
  • [x] Download Thumbnail
  • [x] Download Files

Usage

import {
    Camera, CameraProperty, FileChangeEvent, ImageQuality,
    Option,
    watchCameras
} from '../';

process.on('SIGINT', () => process.exit());

// catch download request events
cameraBrowser.setEventHandler(
    (eventName, event) => {
        if (eventName === CameraBrowser.Events.DownloadRequest) {
            const file = (event as DownloadRequestEvent).file;
            console.log(file);
            const localFile = file.downloadToPath(__dirname + '/images');
            console.log(`Downloaded ${file.name}.`);

            process.exit();
        }
    }
);

// get first camera
const camera = cameraBrowser.getCamera();
if (camera) {
    console.log(camera);
    camera.connect();
    // configure
    camera.setProperties(
        {
            [CameraProperty.ID.SaveTo]: Option.SaveTo.Host,
            [CameraProperty.ID.ImageQuality]: ImageQuality.ID.LargeJPEGFine,
            [CameraProperty.ID.WhiteBalance]: Option.WhiteBalance.Fluorescent
        }
    );
    // trigger picture
    camera.takePicture();
} else {
    console.log('No camera found.');
}

// watch for camera events
watchCameras();

Build Package

The package does not include the Canon EDSDK files. To install the package you will have to build a TGZ.

1. Unpack the Canon EDSDK into third_party. Keep the package name as subdirectory.
   • EDSDKv131520W.zip → third_party/EDSDKv131520W
2. Make sure the variable edsdk_version in binding.gyp matches the EDSDK version. (The numeric part of the package name)
3. Run npm run package
4. Look for ./dist/napi-canon-cameras.tgz
5. cd ../YourProject (Switch to your project directory)
6. npm i ../path/to/folder/napi-canon-cameras.tgz

The current EDSDK versions have a bug in EDSDKTypes.h. The keys are missing their prefixes. This will result in a conflict at compile time. You will need to fix the EdsObjectFormat enum.

/*-----------------------------------------------------------------------------
ObjectFormat Code
-----------------------------------------------------------------------------*/
typedef enum
{
    kEdsObjectFormat_Unknown   = 0x00000000,
    kEdsObjectFormat_Jpeg      = 0x3801,
    kEdsObjectFormat_CR2       = 0xB103,
    kEdsObjectFormat_MP4       = 0xB982,
    kEdsObjectFormat_CR3       = 0xB108,
    kEdsObjectFormat_HEIF_CODE = 0xB10B,
} EdsObjectFormat;

NPM Tasks

• package - Create TGZ package for AddOn
• prebuild - Build for 32 and 64bit Node.js
• prebuild:x64 - Build for 64bit Node.js
• prebuild:ia32 - Build for 32bit Node.js
• build:docs - Update API documentation in README.md
• build:stubs - Update and build stubs (needs prebuild AddOn)
• clean - Remove build artifacts

FAQ

Does the module work in Electron Applications?

Yes.