Adobe 65007312 - Photoshop Lightroom Programmer's Manual page 71

C 4: Working with Metadata
HAPTER
values
readOnly
searchable
browsable
Custom metadata example
This sample Metadata Provider script defines three metadata fields of representative types.
return {
metadataFieldsForPhotos = {
{
},
{
},
{
table Required when
values. Each entry in the array is a table that must contain a value and a title.
The title is shown in the popup menu; the corresponding value (which must
be a string, number, or Boolean, or nil) is written to the database. The
table can have only one entry where
the corresponding label is used when no value has been assigned to this
property for a photo.
The
values
.
true
If present, your plug-in can store values outside of the enumerated values
in this field.
If not, an attempt to set such a value triggers a Lua error and does not
change the value stored in the database.
Boolean Optional. Use only when
Metadata panel, but not editable by the user. The value can still be set
programmatically, using
Boolean Optional. Use only when
separate table and indexed for faster searching; this also means that the field
can be chosen by a user as a search criterion for smart collections. Strings
stored in this field must not exceed 511 bytes. Default is false.
Boolean Optional. Use only when
true, this field can be used as a filter in the Library metadata browser.
id = 'siteId',
-- This field is not available in the metadata browser because
-- it does not have a title field. You might use a field like this
-- to store a photo ID from an external database or web service.
id = 'randomString',
title = LOC "$$$/Sample/Fields/RandomString=Random String",
dataType = 'string', -- Specifies the data type for this field.
id = 'modelRelease',
title = LOC "$$$/Sample/Fields/ModelRelease=Model Release",
dataType = 'enum',
values = {
{
value = nil,
=
dataType "enum"
table can also have an entry
is provided. When true, the field is visible in the
title
LrPhoto:setPropertyForPlugin()
is provided. When true, this field is stored in a
title
is provided and
title
Adding custom metadata 71
, otherwise disallowed. An array of allowed
. If such an entry is present,
value = nil
allowPluginToSetOtherValues =
searchable
values
.
is true. When