@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.

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

Usage

1import {
2    Camera, CameraProperty, FileChangeEvent, ImageQuality,
3    Option,
4    watchCameras
5} from '../';
6
7process.on('SIGINT', () => process.exit());
8
9// catch download request events
10cameraBrowser.setEventHandler(
11    (eventName, event) => {
12        if (eventName === CameraBrowser.Events.DownloadRequest) {
13            const file = (event as DownloadRequestEvent).file;
14            console.log(file);
15            const localFile = file.downloadToPath(__dirname + '/images');
16            console.log(`Downloaded ${file.name}.`);
17
18            process.exit();
19        }
20    }
21);
22
23// get first camera
24const camera = cameraBrowser.getCamera();
25if (camera) {
26    console.log(camera);
27    camera.connect();
28    // configure
29    camera.setProperties(
30        {
31            [CameraProperty.ID.SaveTo]: Option.SaveTo.Host,
32            [CameraProperty.ID.ImageQuality]: ImageQuality.ID.LargeJPEGFine,
33            [CameraProperty.ID.WhiteBalance]: Option.WhiteBalance.Fluorescent
34        }
35    );
36    // trigger picture
37    camera.takePicture();
38} else {
39    console.log('No camera found.');
40}
41
42// watch for camera events
43watchCameras();

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.
   • EDSDKv131800W.zip → third_party/EDSDKv131800W
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

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.