Adobe 65007312 Programming Guide - Page 74
Defining a metadata tagset, inserts a dividing line in the Metadata panel before the first
UPC - 883919154398
View all Adobe 65007312 manuals
Add to My Manuals
Save this manual to your list of manuals |
Page 74 highlights
CHAPTER 4: Working with Metadata Adding custom metadata tagsets 74 The metadata-tagset provider can appear in the same plug-in with export-service and export-filter providers, and with simple Metadata Providers. The metadata-tagset provider is a Lua file that returns a tagset definition. You can use the LrMetadataTagsetFactory entry to specify more than one such file in a single plug-in. For example: LrMetadataTagsetFactory = { 'Tagset1.lua', 'Tagset2.lua', 'Tagset3.lua' }, Defining a metadata tagset Each tagset definition file must return a table listing the fields that should appear in the Metadata panel when that tagset is selected. The file can return an array of such tables to define multiple tagsets. The table contains these entries: id title items string string table Required. An identifier for this tagset that is unique within this plug-in. The name must conform to the same naming conventions as Lua variables; that is, it must start with a letter, followed by letters or numbers. Case is significant. Required. The localizable display name of the tagset, which appears in the popup menu for the Metadata panel. Required. An array of metadata fields that appear in this tagset, in order of appearance. Each entry in the items array identifies a field to be included in the Metadata menu. It can be a simple string specifying the field name, or an array that specifies the field name and additional information about that field: fieldname label string string The first element in the array is the unique identifying name of the field, or one of the special values described below. Optional. When the field name is the special value 'com.adobe.label', this is the localizable string to use as the section label. Certain special values are defined for field names. See the API Reference documentation for metadata plug-in-defined functions, and the metadata sample plug-in. X You can include all visible metadata from a plug-in by specifying the field name with the wild-card character "*"; for example, "com.mycompany.uploader.*". The visible fields are included in the sequence in which they are defined in the definition script. The fields for each plug-in are preceded by a dividing line and the plug-in's name. If you refer to a plug-in that is missing or that defines no visible metadata, it is not an error; the block and separator for that plug-in are simply not displayed. X You can include all visible metadata from a plug-in by specifying the special field name "com.adobe.allPluginMetadata". This is the field name used by the built-in "All Plug-in Metadata" preset. X The special name 'com.adobe.separator' inserts a dividing line in the Metadata panel before the first field from this plug-in.