# LKGDisplaySystem.cs

Contains access to Looking Glass display calibration data for all currently-connected Looking Glass displays to the system.

{% hint style="warning" %}
Note that this class is NOT thread safe and is expected to only be accessed on the Unity main thread.
{% endhint %}

This class automatically connects to LKG Bridge on start (via static constructor, and `InitializeOnLoad` in the editor) and queries for connected displays, but you may manually call `LKGDisplaySystem.Reconnect()` or `LKGDisplaySystem.ReloadCalibrations()` yourself as well.

Additionally, LKG Bridge is queried every few seconds to detect device changes. LKG Bridge uses web sockets events to notify listeners of display changes, but these currently don't work with WebSocketSharp and Unity currently.

## Fields & Properties

### bool IsLoading

Is the system currently connecting to LKG Bridge and/or awaiting the list of connected LKG displays and their calibrations?

## Methods

### static LookingGlass.Toolkit.Display Get(int index)

Gets a copy of the LKG display in the array of connected displays that are found to be currently connected. `int index` is an arbitrary index, and should NOT be relied on for persistence.

### static Task WaitForConnected()

If `LKGDisplaySystem.Reconnect()` is currently waiting to connect to LKG Bridge, this returns a Task that will complete once that connection has been established. If there is no in-progress connection attempt at the moment, a completed Task is returned instead.

### static Task WaitForCalibrations()

Waits for all currently-pending requests resulting from `LKGDisplaySystem.ReloadCalibrations()` at the moment of calling this method.

Subsequent calls to `LKGDisplaySystem.ReloadCalibrations()` after this method is called will not be awaited in this call.<br>

### static Task\<bool> Reconnect()

Attempts to asynchronously connect to Looking Glass Bridge and query it for the Looking Glass displays that are currently connected to your system.

Note that this is automatically called on start (via static constructor, and `InitializeOnLoad` in the editor), but you may manually call this method yourself as well.

This includes a call to `LKGDisplaySystem.ReloadCalibrations()`.<br>

### static Task\<bool> ReloadCalibrations()

Asynchronously queries LKG Bridge for all currently connected LKG displays, updates this class's list of them (see `LKGDisplaySystem.LKGDisplayCount` and `LKGDisplaySystem.Get(int index)`), and updates all Hologram Cameras to ensure they are targeting the correct, up-to-date displays.

Returns true upon successful calibration reload from LKG Bridge and successful handling of the data internally, false otherwise.