Exporting Holograms

Holographic Object Package (.hop)

In Looking Glass Studio 1.1, we introduced the Holographic Object Package (.hop) file format! .hop files are intended to be used as a sharing format that allow you to keep all your settings you've applied in Looking Glass Studio, like Depthiness, Focus, Quilt rows & columns and light field direction. Every type of hologram can be exported as a .hop file. To create a .hop file you'll need to right-click your playlist item, then select Export. Choose the folder you want your .hop file saved in, and then name it whatever you'd like! Looking Glass Studio will then export your hologram!

Technical Details

This information is for folks who want to build their own apps that can parse .hop files, if you're just looking to export and share .hop files you can ignore this section.

The .hop format is using the same compression style as a normal zip archive. You can rename a hologram.hop file to a hologram.zip file to view the contents inside the HOP file.

Currently, a HOP file will contain the source hologram (quilt, RGB-D, light field set) and a JSON file, which contains the settings used by Looking Glass Studio.

The JSON structure is the same regardless of the hologram type, however, there are settings that will not be used for certain holograms.

General Settings

These settings apply to all three hologram types. position_x and position_y only apply once the Holograms have been zoomed in.

position_x: controls the position of the hologram. Valid values are floats between -1 and 1.

position_y: controls the position of the hologram. Valid values are floats between -1 and 1.

zoom: controls how zoomed in the hologram is. Valid values are floats between 0 and 1.

duration: controls how long an image will be displayed, for videos this is not modifiable.

RGB-D

The important settings for RGB-D are:

depthiness: Controls the extrusion of the 3D mesh in Looking Glass Studio. Valid values are floats between 0 and 3.

depthInversion: Changes the direction of the depth. Valid values are true or false.

chromaDepth: changes the depth to use a hue/saturation based depth method, common in exports from DepthKit or Record3D. Valid values are true or false.

depthPosition: controls the position of the depth map relative to the RGB part of the image. Valid values are: top, bottom, left and right.

focus: controls the z-depth position of the 3D mesh in Looking Glass Studio. Valid values are floats from 0 to 0.5

{
    "movie": false, //for videos this will be set to true.
    "mediaType": "rgbd",
    "quilt_settings": {
        "viewX": 1,
        "viewY": 1,
        "viewTotal": 80,
        "invertViews": false,
        "aspect": -1.0
    },
    "depthiness": 1.4299999475479127,
    "depthInversion": false,
    "chromaDepth": false,
    "depthPosition": "right",
    "focus": 0.25999999046325686,
    "viewOrderReversed": false,
    "zoom": 0.39708244800567629,
    "position_x": -0.11979150027036667,
    "position_y": 0.07582521438598633,
    "duration": 10.0
}

Quilt

The important settings for quilts are:

viewX: number of columns. Valid values are whole numbers.

viewY: number of rows. Valid values are whole numbers.

viewTotal: total number of views. Valid values are whole numbers.

invert views: changes view direction. This is not currently used or recommended to change.

aspect: changes the aspect ratio of the footage. Valid values are any float. The valid aspect ratios for the different Looking Glass displays are: Looking Glass Go = 0.56 Looking Glass Portrait = 0.75 Looking Glass 16", 32", and 65" = 1.77

    "movie": false, // for videos this will be set to true.
    "mediaType": "quilt",
    "quilt_settings": {
        "viewX": 8,
        "viewY": 6,
        "viewTotal": 48,
        "invertViews": false,
        "aspect": 0.75
    },
    "depthiness": 1.0,
    "depthInversion": false,
    "chromaDepth": false,
    "depthPosition": "right",
    "focus": 0.0,
    "viewOrderReversed": false,
    "zoom": 1.0,
    "position_x": 0.0,
    "position_y": 0.0,
    "duration": 10.0
}

Light Field Photoset

The important settings for light field photosets are:

focus: changes the focal point of the light field photoset, allowing you to change the focus. Valid values are floats between 0 and 0.5

viewOrderReversed: changes the direction which the views of a photoset are loaded in.

{
    "movie": false,
    "mediaType": "photoset",
    "quilt_settings": {
        "viewX": 1,
        "viewY": 1,
        "viewTotal": 46,
        "invertViews": true,
        "aspect": -1.0
    },
    "depthiness": 1.0,
    "depthInversion": false,
    "chromaDepth": false,
    "depthPosition": "right",
    "focus": 0.0,
    "viewOrderReversed": false,
    "zoom": 1.0,
    "position_x": 0.0,
    "position_y": 0.0,
    "duration": 10.0
}