===== Viewer SDK Options for Plugins =====

This page describes the available Viewer SDK configuration options for the Orbit Desktop Plugins.

==== Configuration File ====

Configuration options are added to a configuration file.

Here are the locations for the main plugins : 
  * QGis: ''C:\plugins\plugin_qgis.ini''
  * ArcGIS: ''C:\plugins\plugin_arcmap.ini''
  * ArcGIS Pro: ''C:\plugins\plugin_arcpro.ini''

==== Local Publisher ====

The plugin can be configured to connect to a local 3DM Publisher. E.g. to be loaded offline, without connecting to the online CDN, or to avoid HTTPS-HTTP mixed content issues when connecting secure Https to the CDN and insecure Http to the local Publisher.

Add the following setting.  Modify 'http://localhost:1111' to the specs of the installed 3DM Publisher.

ESRI:
<code>
publisherURL=http://localhost:1111/viewer_sdk/?mode=websocket&protocol=ws&hostname=localhost&port=7200&endpoint=/endpoint
</code>

QGIS
<code>
publisherURL=http://localhost:1111/viewer_sdk/?mode=websocket&protocol=ws&hostname=localhost&port=7201&endpoint=/endpoint
</code>

==== Default Attribute Value ====

An extra line ''default.attribute.value.MyAttribute=MyValue'' can be added to this configuration file to set a default value for an attribute. In the example underneath, the default value for the attribute 'type' will be 'cable' when saving a measurement from the 3D Mapping Viewer to a layer. 

<code>
default.attribute.value.type=cable
</code>

<code>
default.attribute.value.type=cable
</code>

==== Communication CRS ====

The CRS of geometries that are communicated between the Viewer SDK and the Plugin is WGS84 by default.

In some cases, differences in transformation from and to the WGS84 datum between Viewer SDK and Plugin Host can lead to coordinate shifts when overlaying vector data or measurements.  These shifts can be resolved by configuring a projected CRS that matches your data, so transforming to WGS84 and back is not necessary.

The setting can be added as follows.\\ The value is an [[dev/technology/3d_mapping/crs|EPSG code]].

<code>
communication.crs=25837
</code>