4D Doc Center : GET PICTURE KEYWORDS

Home

4D v14.3

GET PICTURE KEYWORDS


GET PICTURE KEYWORDS ( picture ; arrKeywords {; *} )

Parameter	Type	Description
picture	Picture field, Picture variable	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 Database/Data storage page).