Image Metadata

Image locations in the document and data can be included for analysis of images and for automatic display at user preferred locations in VR/AR.

An example of this is all photographs appearing on a wall in frames and all graphs and charts on a table, with live data.

The method has been modelled on the way glossary entries are included. An image entry can be as simple as a location and a description/definition, but the author can also assign categories to further clarify what the image represents and how it relates to other information, to allow for flexible views.

Everything here is optional and it is expected that producing software include as much metadata as possible when adding the image to the document. The end user author should have to enter as little as possible manually.

Adding Metadata

Here is a 2 min video of an approach for the interaction for how this metadata could be added, when preparing the final PDF. We see it as one step beyond tagging pictures on social media or polishing a presentation for clarity:

The Metadata

The following metadata is for experimental use.

@entry{named-image-same-as-title-below-plus-time-added-start},

Location in document
location-page = {logical page where image is found},
location-page-pixels = {xy top left coordinates and xy bottom right coordinates-in-pixels: 10,10, 300,300 height 290, length 290},
location-on-page-percent = {percent of page from top left coordinates and percent of page from bottom right coordinates: 10,% 10%, 300%,300% height 20%, length 20%},
size-in-pixels = 290, 290},
size-in-percent = 290%, 290%},

Title
title = {title of image},
caption = {caption for image},
description = {plain text definition description},
keywords = {list of keywords for this image},
created-by = {name of image maker as person or institution},
rights = {usage rights},
type = {how image was produced: Photograph, drawing, chart, AI, CGI, painting, etc},

File
filename = {filename of image, if available externally, such as with includes ZIP file},
imageurl = {url of image, if available online},
3dfilename = {filename of 3d version, if available externally, such as in included ZIP file},
3dimageurl = {url of 3d version, if available online},
datafilename = {filename of data presented, if available externally, such as in included ZIP file},
sceneurl = {URL for access of what image portrays},

Time
created = {time and date created},
refers-to-time = {period of time image refers to},

People
people = {names of people in image},

Location
location-coordinates = {location portrayed, in coordinates},
location-name = {named location of map location, if image is a map},
coordinates = {coordinates of top left of map to real world and bottom right},

Chart Values
x-axis-values = {values for x axis, from bottom to top},
x-axis-label = {name of x axis data},
y-axis-values = {values for y axis, from left to right},
y-axis-label = {name of y axis data},
z-axis-values = {values for z axis, from back of page to front},
pie-chart-values = {divisions and labels from 12 o’clock position going clockwise: 0-2 blue, 2-4 yellow},
scatter-plot-values = {data points with x,y from for each location and label: 100,20 ‘London’},
location = {x,y location start of interactive element to x,y end, followed by ‘label’ and location, which will be a page number if a number, web location if URL or other image if other image name},

Interactions
codefilename = {filename of code, if available externally, such as in included ZIP file},
codeurl = {url to code, if available online},

3D
preferred default spatial coordinates (where author prefers images to appear in a XR environment)
spatial-location-to-document-frame-top-left = {x,y,z coordinates for where the top left of the image should appear, in relation to the top left of the document’s location, but not angle},
spatial-location-to-user-head = {x,y,z coordinates for where the top left of the image should appear, in relation to the middle of the users vision},
where the top left of the image should appear, in relation to the top left of the document’s location, but not angle},
administrative metadata

@entry{named-image-same-as-title-below-plus-time-added-end},