blob: 765b4c92ff0bda03ec68535c3d7524e89b54a75d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
---
title: Exif
description: Applicable to JPEG and TIFF images, returns an EXIF object containing image metadata.
categories: []
keywords: []
action:
related: []
returnType: exif.ExifInfo
signatures: [RESOURCE.Exif]
toc: true
---
Applicable to JPEG and TIFF images, the `Exif` method on an image `Resource` object returns an [EXIF] object containing image metadata.
## Methods
Date
: (`time.Time`) Returns the image creation date/time. Format with the [`time.Format`]function.
Lat
: (`float64`) Returns the GPS latitude in degrees.
Long
: (`float64`) Returns the GPS longitude in degrees.
Tags
: (`exif.Tags`) Returns a collection of the available EXIF tags for this image. You may include or exclude specific tags from this collection in the [site configuration].
## Examples
To list the creation date, location, and EXIF tags:
```go-html-template
{{ with resources.Get "images/a.jpg" }}
{{ with .Exif }}
<p>Date: {{ .Date }}</p>
<p>Lat/Long: {{ .Lat }}/{{ .Long }}</p>
{{ with .Tags }}
<p>Tags</p>
<table>
<thead>
<tr><th>Tag</th><th>Value</th></tr>
</thead>
<tbody>
{{ range $k, $v := . }}
<tr><td>{{ $k }}</td><td>{{ $v }}</td></tr>
{{ end }}
</tbody>
</table>
{{ end }}
{{ end }}
{{ end }}
```
To list specific values:
```go-html-template
{{ with resources.Get "images/a.jpg" }}
{{ with .Exif }}
<ul>
{{ with .Date }}<li>Date: {{ .Format "January 02, 2006" }}</li>{{ end }}
{{ with .Tags.ApertureValue }}<li>Aperture: {{ lang.FormatNumber 2 . }}</li>{{ end }}
{{ with .Tags.BrightnessValue }}<li>Brightness: {{ lang.FormatNumber 2 . }}</li>{{ end }}
{{ with .Tags.ExposureTime }}<li>Exposure Time: {{ . }}</li>{{ end }}
{{ with .Tags.FNumber }}<li>F Number: {{ . }}</li>{{ end }}
{{ with .Tags.FocalLength }}<li>Focal Length: {{ . }}</li>{{ end }}
{{ with .Tags.ISOSpeedRatings }}<li>ISO Speed Ratings: {{ . }}</li>{{ end }}
{{ with .Tags.LensModel }}<li>Lens Model: {{ . }}</li>{{ end }}
</ul>
{{ end }}
{{ end }}
```
{{% include "methods/resource/_common/global-page-remote-resources.md" %}}
[exif]: https://en.wikipedia.org/wiki/Exif
[site configuration]: /content-management/image-processing/#exif-data
[`time.Format`]: /functions/time/format
|