Adobe 65007312 Programming Guide - Page 68
Working with Metadata, Adding custom metadata, Declaring a Metadata Provider
UPC - 883919154398
View all Adobe 65007312 manuals
Add to My Manuals
Save this manual to your list of manuals |
Page 68 highlights
4 Working with Metadata X A plug-in can define customized metadata fields for photos by declaring a Metadata Provider in the information file, and defining type and version information for each field. See "Adding custom metadata" on page 68. X A plug-in can specify metadata tagsets that affect the display of custom metadata fields in the Library module's Metadata panel. See "Adding custom metadata tagsets" on page 73. X Plug-ins can define complex searches that find photos according to metadata values. See "Searching for photos by metadata values" on page 75. Adding custom metadata Your plug-in can define custom metadata fields for photos that are imported into Lightroom. These fields can be visible and even editable in Lightroom's Metadata panel, or can be invisible and used to store private data. Declaring a Metadata Provider Like an Export Service or Export Filter Provider, you declare a Metadata Provider in the information file (Info.lua) for your plug-in. See "Writing standard plug-ins for Lightroom" on page 22. To declare a Metadata Provider, include an LrMetadataProvider entry in the Info.lua file; for example: return { LrSdkVersion = 3.0, LrToolkitIdentifier = 'com.adobe.lightroom.metadata.sample', LrPluginName = LOC "$$$/CustomMetadata/PluginName=Metadata Sample", LrMetadataProvider = 'SampleMetadataDefinition.lua', } The information file that declares a Metadata Provider can also declare metadata tagsets (see "Adding custom metadata tagsets" on page 73), export services and/or filters, but need not do so. Limitations of custom metadata in this release In the current implementation, custom metadata defined by a plug-in has these limitations, which will be addressed in future versions of the Lightroom SDK: X Values stored in custom metadata fields are stored only in Lightroom's database. In the current release, a plug-in cannot link custom metadata fields to XMP values or save them with the image file. X A plug-in cannot specify complex data types. You can define simple fields per photo, but you cannot define a whole spreadsheet per photo. 68