Resource Summary

  • Depthmap data is encoded and serialized before being embedded within the image using the Adobe XMP standard.

  • The XML namespace URI for the depthmap data is http://ns.google.com/photos/1.0/depthmap/.

  • Several properties are used to describe the depthmap, including format, near and far values, MIME types for depth and confidence images, units, measure type, manufacturer, model, software, and original image dimensions.

  • When the image is modified, specific properties like GDepth:Data, GDepth:Confidence, GDepth:ImageWidth, and GDepth:ImageHeight may require updates.

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.