GET PICTURE KEYWORDS
GET PICTURE KEYWORDS ( picture ; arrKeywords {; *} )
| Parameter | Type | Description | |
|---|---|---|---|
| picture | Picture, Picture | → | Picture for which to get associated keywords |
| arrKeywords | Text array | ← | Array containing extracted keywords |
| * | Operator | → | If passed = use distinct values |
Description
The GET PICTURE KEYWORDS command returns, in the arrKeywords array, the list of keywords associated with the picture passed as parameter.
Only keywords set using IPTC/Keywords metadata are taken into account. Other types of metadata are ignored by the command. The command only works with picture types that support this type of metadata (JPEG, TIFF, etc.).
Note: Metadata of the IPTC/Keywords type are now indexable in 4D (see the Design Reference manual).
If you pass the * parameter, the method only returns "distinct values" of keywords, in other words, a list with no duplicates.
If the picture does not contain keywords or IPTC/Keywords metadata, the command returns an empty array and no error is generated.
Note: Results returned by this command can differ according to the current value of the "Consider only non-alphanumeric chars for keywords" database setting (see the DOM GET XML CHILD NODES).
See also
GET PICTURE METADATA
SET PICTURE METADATA
Properties
| Command number | 1142 |
| Thread safe | ✓ |