====== Orbit Desktop Startup Configurations ======

This glossary page bundels all system startup configurations which cannot be set via the user interface [[201:desktop:preferences:index|Preferences Panel]]. 

<note tip>
Open and edit the system configuration files using a simple text editor (e.g. Notepad). \\
Restart Orbit to take advantage of the updated configurations.
</note>

===== Charset =====

Configuration to set charset.

The charset is used to read and write the Attribute Component of Vector Data. \\
The System Charset is overruled by the optional [[201:technology:supported_formats:other:cpg|Dataset Code Page definition]] file at reading the Dataset Attribute Component. 

  * File : ''<install_folder>/program/config/orbit.ini''
  * Parameter : ''system.charset''
  * Value : Java Charset Canonical Name or Alias, see  https://docs.oracle.com/javase/7/docs/technotes/guides/intl/encoding.doc.html 
  * Default Value : ISO-8859-1
  * Example \\ <code>system.charset       cp1255</code>

===== Datum Transformation Z coordinate =====

Configuration to enable datum transformation on Z coordinate, see [[201:technology:core:crs|]].

  * File: ''<install_folder>/program/config/orbit.ini''
  * Parameter: ''orbit.wgs84.transform.change.z''
  * Value : ''true'' or ''false''
  * Default value : true
===== Download Time-Out =====

Configuration to set Url connect and download time-out.

  * File: ''<install_folder>/program/config/orbit.ini''
  * Parameters : 
    * ''urldownloader.timeout.connect''
    * ''urldownloader.timeout.read''
  * Value : Milliseconds as integer value
  * Default Value : 60000
  * Increase value : if due to special internet checks and restrictions applicable in some countries the connection with the [[201:technology:core:online_license_activation|Orbit Online Licence Server]] is not possible or lost, the value can be increased to several times the default value
  * Example \\ <code>urldownloader.timeout.connect      120000
urldownloader.timeout.read         120000</code>

===== Keyboard Shortcuts =====

Configuration to set custom Keyboard Shortcuts. 

  * File : ''<Orbit installation directory>/program/config/orbit.language.ini''
  * Parameter : List of all actions and functions available for keyboard Shortcuts, see [[201:desktop:workspace:mnemonic|]].
  * Value : Keystroke value
  * Example : \\ <code>
function.select.activate.mnemonic S
function.zoomhistory.next.mnemonic RIGHT
interactive.pointeditor.add.point.mnemonic I
ext_panorama.measure.control.panel.button.point.mnemonic G
inventarisatie_suite.fast.inventory.step.registration.next.object.button.mnemonic N
</code>

===== Language =====

Configuration to set language and load available translations.

Orbit Support manages the english tags, partners maintain other available translations. \\
Feedback on english tags, contact customer.success@orbitgt.com. If you would like to adjust, complete or start a translations, contact sales@orbitgt.com.

  * File : ''<install_folder>/program/config/orbit.ini''
  * Parameter : ''system.languagename''
  * Value : ''arabic'', ''deutsch'', ''english'', ''espagnol'', ''francais'', ''greek'', ''hebrew'', ''lithuanian'', ''nederlands'', ''polski'', ''russian'', ''simplified_chinese'', ''turkce''.
  * Default Value : english
  * Example for Spanish \\ <code>
system.languagename       espagnol   
</code>

===== Logfile Timer Event =====

Configuration to let the system timers log a message at each timer event.

  * File : ''<install_folder>/program/config/orbit.ini''
  * Parameter : ''system.log.timer.events.1s'' \\ Available timers are ''.1s'', ''.1m'', ''.5m'', ''.15m'' and ''.60m''.
  * Value : ''true'' or ''false''

===== Map-Tab split ratio =====

Configuration to set split screen ratio of Map and Tabs at start up.

  * File : ''<install_folder>/program/config/orbit.ini''
  * Parameter : ''app.element.orbitgis_extensions_tab.parameter_value''
  * Value range : 0.00 - 1.00
  * Example \\ <code>app.element.orbitgis_extensions_tab.parameter_value 0.80</code>

===== Memory =====

Configuration to set minimum and maximum memory usage. 

Get more Orbit out of your powerful machine by increasing the maximum memory amount (RAM) that can be used by Orbit. \\
All Orbit products operate 64Bit. The maximum memory you can allocate to Orbit depends on the hardware. Reserve at least 2GB for the Operating System. 

At installation, Orbit is configured to maximally use 6GB Memory. \\
We do advise to set a minimum and maximum amount of memory. At startup, Orbit will take the minimum amount of memory if it's available. During processing, Orbit will take up to the maximum amount of memory.\\
If no maximum is set, Orbit will allocate 1/4 of the total available memory. 

  * File : ''<install_folder>/program/bin/Orbit.ini''
  * Parameter : 
    * Minimum RAM :''-Xms[Value]m''
    * Maximum RAM :''-Xmx[Value]m''
  * Value : expressed in Mega Bytes, 
    * 4GB : ''-Xmx4096m''
    * 6GB : ''-Xmx6144m''
    * 8GB : ''-Xmx8192m''
    * ...
  * Example <code>
[..]\jre\bin\javaw.exe -Xms4096m -Xmx4096m -splash:...
</code>

===== OVT Writer =====

Configuration to write [[201:technology:supported_formats:vector:ovt|*.ovt]] resource files that are compatible with Orbit version 17.0 and older. \\
At installation, the newest *.ovt files, that are compatible with Orbit's 3D Mapping Cloud, are created. \\

  * File : ''<install_folder>/program/config/orbit.ini''
  * Parameter : ''ovt.writer.old''
  * Value : ''true'' or ''false''
  * Default value : false
  * Example \\ <code>ovt.writer.old    true</code>

===== Preferences =====

Expand the [[201:desktop:preferences:index|]] panel with Workspaces and Constructions. 

  * File : ''<install_folder>/program/config/orbit.ini''
  * Parameter : ''app.element.orbitgis_preference_settings.visible''
  * Value : ''true'' or ''false''
  * Default value : false


===== Procedures =====

Configuration to merge the administrator procedures per mapping type.
  * File : ''<install_folder>/program/config/orbit.ini''
  * Parameter : ''merge.admin.operator.procedures''
  * Value : ''true'' or ''false''
  * Default value : true


===== Proxy =====

Configuration to set Http or Https Proxy arguments for Orbit Java JRE VM.

  * File : ''<install_folder>/program/bin/Orbit.ini''  \\ Add proxy configuration in between the -Xmx and -splash arguments.
  * Parameters for Http : -Dhttp.proxyHost, Dhttp.proxyPort, Dhttp.proxyUser, Dhttp.proxyPassword
  * Parameters for Https : -Dhttps.proxyHost, Dhttps.proxyPort, Dhttps.proxyUser, Dhttps.proxyPassword
  * Example for Https \\ <code>
-Dhttps.proxyHost=0.0.0.0
-Dhttps.proxyPort=0000
-Dhttps.proxyUser=xxx
-Dhttps.proxyPassword=xxx
</code>

===== Window Position =====

The position on screen of Orbit Windows (main frame, preference panel, dataset properties, crs selection, ... ) is automatically saved and re-used at next display of the given Orbit Window. \\ 
If the last used position on screen is no longer available, e.g. 2nd monitor is not attached, the Orbit Window might not be accessible. \\
Hereby the steps to reset the the position on screen for all Orbit Windows : 
  - Close Orbit
  - Delete Widow configuration file : ''%localappdata%/Orbit/<Product>/settings/window.ini''
  - Restart Orbit

===== Temp =====

Orbit Software creates caching and logs files in the Operating Systems Temp folder. All other application and Orbit user settings are saved in the Orbit configurable systemdatapath and userdatapath. 

  * File : ''<install_folder>/program/config/orbit.ini''
  * Parameter : ''system.systemdatapath'' and ''system.userdatapath''
  * Value : path of your choice
  * Default value : <USERHOME>/AppData/Local/Orbit GT/<Orbit Software>