Extract Metadata from Image File

This statement is used to extract metadata from an image file. You supply a path to a file and the name of a container to receive the metadata. Both text fields may contain any of the escape sequences described in Escape Sequences. You can request any combination of EXIF and GPS metadata.

Any pre-existing container of the specified name is removed.

The action test state will be set to true if a container was created. When false, named variable Container Error will contain the error text. Note that if there is no returned metadata, it is reported as an error.

The statement is only performed once for all execution modes.

The returned container is formatted dependent on the requested metadata:

EXIF

The extracted metadata is embedded directly in the created object container

GPS

The extracted metadata is embedded directly in the created object container

EXIF & GPS

The created object container will contain at most two keys. If EXIF data was returned it will be in an object with a key of EXIF. If GPS data was returned it will be in an object with a key of GPS.

Note that older versions of the the OS may not return GPS metadata.

Additional information about image metadata can be found in Image Metadata.