The depthmap data is encoded and serialized as described in the encoding section and embedded inside the image as described by the Adobe XMP standard.
The XML namespace URI is http://ns.google.com/photos/1.0/depthmap/
| Name | Type | Required | Default value | Property description | Action required if image is modified |
|---|---|---|---|---|---|
| GDepth:Format | String | Yes | "RangeInverse" | The format that describes how to convert the depthmap data into a valid float-point depthmap. Current valid values are "RangeInverse" and "RangeLinear". | No change. |
| GDepth:Near | Real | Yes | N/A | The near value of the depthmap in depth units. | No change. |
| GDepth:Far | Real | Yes | N/A | The far value of the depthmap in depth units. | No change. |
| GDepth:Mime | String | Yes | "image/jpeg" | The mime type for the base64 string describing the depth image content, e.g. “image/jpeg” or “image/png”. | No change. |
| GDepth:Data | String | Yes | "N/A" | The base64 encoded depth image, see the encoding section for more details. The depthmap will be stretched-to-fit the corresponding color image. | The data needs to be decoded into an image, scaled/cropped/rotated, then re-encoded again. |
| GDepth:Units | String | No | "m" | The units of the depthmap, e.g. "m" for meters or "mm" for millimeters. | No change. |
| GDepth:MeasureType | String | No | "OpticalAxis" | The type of depth measurement. Current valid values are "OpticalAxis" and "OpticRay". | No change. |
| GDepth:ConfidenceMime | String | no | "image/png" | The mime type for the base64 string describing the confidence image content, e.g. “image/png”. | No change. |
| GDepth:Confidence | String | No | "N/A" | The base64 encoded confidence image, see the encoding section for more details. The confidence map should have the same size as the depthmap. | The data needs to be decoded into an image, scaled/cropped/rotated, then re-encoded again1. |
| GDepth:Manufacturer | String | No | "N/A" | The manufacturer of the device that created this depthmap. | No change. |
| GDepth:Model | String | No | "N/A" | The model of the device that created this depthmap. | No change. |
| GDepth:Software | String | No | "N/A" | The software that created this depthmap. | No change. |
| GDepth:ImageWidth | Real | No | "N/A" | The width in pixels of the original color image associated to this depthmap. This is NOT the depthmap width. If present, apps must update this property when scaling, cropping or rotating the color image. Clients use this property to verify the integrity of the depthmap w.r.t. the color image. | Update anytime the original color image resolution is modified. This includes crop, scale and rotation. |
| GDepth:ImageHeight | Real | No | "N/A" | The height in pixels of the original color image associated to this depthmap. This is NOT the depthmap height. If present, apps must update this property when scaling, cropping or rotating the color image. Clients use this property to verify the integrity of the depthmap w.r.t. the color image. | Update anytime the original color image resolution is modified. This includes crop, scale and rotation. |
1. Note that scaling the confidence map is a non trivial operation and may significantly alter its accuracy.