The Aperture 2.1 SDK introduces the ability to build Edit plug-ins. These plug-ins are compatible with the Edit functionality built into Aperture 2.1 and later.
The Aperture 1.5.5 SDK lets you create plug-ins that run under Aperture 1.5 or later. Aperture 1.5.1 introduced several changes to the ApertureExportManager protocol that are not available in Aperture 1.5. In particular, version 2 of the ApertureExportManager protocol includes changes for hierarchical keywords, thumbnails, and image properties. Specifically:
You can now obtain a dictionary of image properties that does not include a thumbnail by using propertiesWithoutThumbnailForImageAtIndex:.
You can now obtain various sizes of a given thumbnail using the method thumbnailForImageAtIndex:size: and the constants kExportThumbnailSizeThumbnail, kExportThumbnailSizeMini, and kExportThumbnailSizeTiny.
The dictionary returned from propertiesForImageAtIndex: and propertiesWithoutThumbnailForImageAtIndex includes an object containing the hierarchy of each keyword attached to the image. The key for that object is kExportKeyHierarchicalKeywords.
You can now add keywords to an image, including the full hierarchy for each keyword using addHierarchicalKeywords:toImageAtIndex:.
Before using any of the updated Export functionality, your plug-in must first check whether version 2 of the ApertureExportManager protocol is supported by the version of Aperture the plug-in is currently running under. To do this, you can call the following method from the PROAPIAccessing header file:
- (BOOL)conformsToProtocol:(Protocol *)aProtocol version:(unsigned int)versionNumber;
For example, you can decide which SDK features to use based on the results of calling this method:
if ([_exportManager conformsToProtocol:@protocol(ApertureExportManager) version:2]) |
// Use Export API features only available in Aperture 1.5.1 and later |
else |
// Use Export API features available in Aperture 1.5 and later |
Last updated: 2008-04-23