佳能相机操作 EDSDK 教程 C# 版本

http://blog.csdn.net/zajin/article/details/17021339 

 

介绍 佳能EOS数码SDK是一个 可以用来远程控制其数码单反相机相当强大的SDK。不幸的是，想在互联网上找些很好的例子相当难，而且提供的文档也不是很齐全。因为我已经找到了很多能让其他人更容易掌握它的东西，我就想可以把我认为最重要的东西组织在一起，做成一个教程。  本教程包括：  初始化和终止的SDK 打开和关闭摄像头会话 获取连接的像机列表 set和get相机设置 获取可用的设置列表 正常拍照和使用闪光灯模式 处理相机事件 将拍摄的照片下载到电脑上 启动和实时查看 记录实时查看 锁定/解锁相机的用户界面 另外：其实我不从属于佳能公司,也不受其自助。  还有：我不对这个软件做任何方式担保。使用时请您自己注意风险！ （你可以在GPL许可证中找到有关此主题的更多信息。）

背景 你必须有佳能EDSDK副本才能让这个运行起来。 （我认为）我不会被允许包含那些官方的DLL的到项目中，所以你必须自己通过申请去获取，它们在这里： 欧洲、非洲及中东 北美、中美和南美洲 澳大利亚和新西兰 印度、印度尼西亚、马来西亚、巴基斯坦、菲律宾和泰国 一旦你得到了那些DLL，就把它们放到项目中的 EDSDK文件夹里面，并确保再调试/发行目录中也要有相同的文件夹。 （或你认为的任何地方，同时据此调整 EDSDK.cs文件中的DLLPath变量（在右上部）。

使用代码 我使用了三个简单的类，SDKHandler，Camera和CameraValues，还有来自 佳能SDK的EDSDK。  在SDKHandler中有几个变量：

[csharp]  view plain copy

 

1. /// <summary>  
2. /// The used camera  
3. /// </summary>  
4. public Camera MainCamera { get; private set; }  
5.   
6. /// <summary>  
7. /// States if a session with the MainCamera is opened  
8. /// </summary>  
9. public bool CameraSessionOpen { get; private set; }  
10.   
11. /// <summary>  
12. /// States if the LiveView is on or not  
13. /// </summary>  
14. public bool IsLiveViewOn { get; private set; }  
15.   
16. /// <summary>  
17. /// States if LiveView is recorded or not  
18. /// </summary>  
19. public bool IsEvfFilming { get; private set; }  
20.   
21. /// <summary>  
22. /// Directory to where photos will be saved  
23. /// </summary>  
24. public string ImageSaveDirectory { get; set; }  
25.   
26. /// <summary>  
27. /// Handles errors that happen with the SDK  
28. /// </summary>  
29. public uint Error  
30. {  
31.     get { return EDSDK.EDS_ERR_OK; }  
32.     set { if (value != EDSDK.EDS_ERR_OK) throw new Exception("SDK Error: " + value); }  
33. }  
34.   
35. /// <summary>  
36. /// Frame buffer for LiveView recording  
37. /// </summary>  
38. private Queue<byte[]> FrameBuffer = new Queue<byte[]>(1000);  

还有一些来自SDK的以及我自己添加的一些事件：

[csharp]  view plain copy

 

1. #region SDK Events  
2.   
3. public event EDSDK.EdsCameraAddedHandler SDKCameraAddedEvent;  
4. public event EDSDK.EdsObjectEventHandler SDKObjectEvent;  
5. public event EDSDK.EdsProgressCallback SDKProgressCallbackEvent;  
6. public event EDSDK.EdsPropertyEventHandler SDKPropertyEvent;  
7. public event EDSDK.EdsStateEventHandler SDKStateEvent;  
8.  
9. #endregion  
10.  
11. #region Custom Events  
12.   
13. public delegate void CameraAddedHandler();  
14. public delegate void ProgressHandler(int Progress);  
15. public delegate void ImageUpdate(Image img);  
16. public delegate void FloatUpdate(float Value);  
17.   
18. /// <summary>  
19. /// Fires if a camera is added  
20. /// </summary>  
21. public event CameraAddedHandler CameraAdded;  
22.   
23. /// <summary>  
24. /// Fires if any process reports progress  
25. /// </summary>  
26. public event ProgressHandler ProgressChanged;  
27.   
28. /// <summary>  
29. /// Fires if the LiveView image is updated  
30. /// </summary>  
31. public event ImageUpdate LiveViewUpdated;  
32.   
33. /// <summary>  
34. /// Fires if a new framerate is calculated  
35. /// </summary>  
36. public event FloatUpdate FrameRateUpdated;  
37.  
38. #endregion    

这个类的方法将在稍后讨论。

 

Camera类相当简单，工作起来就像一个相机指针和有关相机的一些信息的容器：

[csharp]  view plain copy

 

1. public class Camera  
2. {  
3.     internal IntPtr Ref;  
4.     public EDSDK.EdsDeviceInfo Info { get; private set; }  
5.     public uint Error  
6.     {  
7.         get { return EDSDK.EDS_ERR_OK; }  
8.         set { if (value != EDSDK.EDS_ERR_OK) throw new Exception("SDK Error: " + value); }  
9.     }  
10.   
11.     public Camera(IntPtr Reference)  
12.     {  
13.         this.Ref = Reference;          
14.         EDSDK.EdsDeviceInfo dinfo;  
15.         Error = EDSDK.EdsGetDeviceInfo(Reference, out dinfo);  
16.         this.Info = dinfo;  
17.     }  
18. }   

CameraValues是一个拥有所有单元ID值以及存储从Av、Tv到ISO字符串值的静态类。

初始化和终止SDK 初始化和终止是最容易做的事情。当您一启动程序，就创建了一个SDKHandler的新实例。

[csharp]  view plain copy

 

1. /// <summary>  
2. /// Initialises the SDK and adds events  
3. /// </summary>  
4. public SDKHandler()  
5. {  
6.     //this is the important part of initialisation  
7.     Error = EDSDK.EdsInitializeSDK();   
8.   
9.     //here we subscribe to the CameraAddedEvent and tell the SDK we did so  
10.     CameraAddedEvent += new EDSDK.EdsCameraAddedHandler(SDKHandler_CameraAddedEvent);  
11.     EDSDK.EdsSetCameraAddedHandler(CameraAddedEvent, IntPtr.Zero);  
12.       
13.     //here we subscribe to the rest of the camera events  
14.     SDKStateEvent += new EDSDK.EdsStateEventHandler(Camera_SDKStateEvent);  
15.     SDKPropertyEvent +=