---

Working with the SDK

The software development kit (sdk) contains several helpful items, including tools and sample applications. Developers should also be aware that the header files include a number of deprecated functions that are present for backwards compatibility, and should not be used in new applications.

Files and Folders

The SDK includes folders for device modules, documentation, sample applications, tools, and TWAIN modules and applications.

Tools Folder

All developers should check out the tools folder. It contains tools that will help you to write code, debug your applications and device modules, and understand the API. In particular, you should run the ICAAPITest application to generate code snippets and test the results of various functions when different devices are connected.

Applications Folder

Applications developers should look in the sample applications folder for applications similar to the ones you wish to develop.

If you are writing a device module, the SimplePTPCamera sample application should serve as a template to guide you.

TWAIN Folder

The TWAIN folder is useful for developing TWAIN modules and plug-ins that are compatible with Mac OS X.

Header Files

The ICAApplication.h header file contains a number of deprecated functions that are there for backward compatibility. These functions are marked as deprecated in the Image Capture Applications Reference. You don’t need them, and you shouldn’t use them in new applications. Don’t be confused by their presence. For image capture applications, just stick to the API described in this document.

There are functions in the ICAApplication.hheader file that are not described in this document that you will need in order to work with scanners. There is also a separate header file for writing device modules, ICADevices.h. You are advised to obtain a paid ADC membership and consult with Apple engineering directly if you need assistance with writing scanner software or writing a device module.

---