OMNISXI.INI Configuration Information
=====================================

The omnisxi.ini file controls how the omnisxi X11 supporting layer communications with
XWindows. It is divided into various sections and can be edited to support user preferences
and/or to improve server performance.

omnisxi.ini is created by OMNIS the first time you run OMNIS.

[Setup] Section
===============
Version (Default=4)          - Leave this value set to 4 - other values are not supported.
BellLevel (Default=100)      - XWindows supports bell levels of between 0 (no sound) and 100 (load).
ColorX                       - The OMNIS GUI uses these color values to determine what colors are
                               used when draw. These values are in 24bit BGR.
Color1 (Default=12632256)    - GDI_COLOR_SCROLLBAR
Color2 (Default=8421376)     - GDI_COLOR_BACKGROUND
Color3 (Default=8388608)     - GDI_COLOR_ACTIVECAPTION
Color4 (Default=8421504)     - GDI_COLOR_INACTIVECAPTION
Color5 (Default=12632256)    - GDI_COLOR_MENU
Color6 (Default=16777215)    - GDI_COLOR_WINDOW
Color7 (Default=0)           - GDI_COLOR_WINDOWFRAME
Color8 (Default=0)           - GDI_COLOR_MENUTEXT
Color9 (Default=0)           - GDI_COLOR_WINDOWTEXT
Color10 (Default=16777215)   - GDI_COLOR_CAPTIONTEXT
Color11 (Default=12632256)   - GDI_COLOR_ACTIVEBORDER
Color12 (Default=12632256)   - GDI_COLOR_INACTIVEBORDER
Color13 (Default=8421504)    - GDI_COLOR_APPWORKSPACE
Color14 (Default=8388608)    - GDI_COLOR_HIGHLIGHT
Color15 (Default=16777215)   - GDI_COLOR_HIGHLIGHTTEXT
Color16 (Default=12632256)   - GDI_COLOR_BTNFACE
Color17 (Default=8421504)    - GDI_COLOR_BTNSHADOW
Color18 (Default=8421504)    - GDI_COLOR_GRAYTEXT
Color19 (Default=0)          - GDI_COLOR_BTNTEXT
Color20 (Default=12632256)   - GDI_COLOR_INACTIVECAPTIONTEXT
Color21 (Default=16777215)   - GDI_COLOR_BTNHIGHLIGHT
Color22 (Default=0)          - GDI_COLOR_3DDKSHADOW
Color23 (Default=14737632)   - GDI_COLOR_3DLIGHT
Color24 (Default=0)          - GDI_COLOR_INFOTEXT
Color25 (Default=14811135)   - GDI_COLOR_INFOBK
Color26 (Default=0)          - SPARE
Color27 (Default=0)          - SPARE
Color28 (Default=0)          - SPARE
Color29 (Default=0)          - SPARE
Color30 (Default=0)          - SPARE
Color31 (Default=0)          - GDI_COLOR_QBLACK
Color32 (Default=8388608)    - GDI_COLOR_QDKBLUE
Color33 (Default=32768)      - GDI_COLOR_QDKGREEN
Color34 (Default=8421376)    - GDI_COLOR_QDKCYAN
Color35 (Default=128)        - GDI_COLOR_QDKRED
Color36 (Default=8388736)    - GDI_COLOR_QDKMAGENTA
Color37 (Default=32896)      - GDI_COLOR_QDKYELLOW
Color38 (Default=8421504)    - GDI_COLOR_QDKGRAY
Color39 (Default=16711680)   - GDI_COLOR_QBLUE
Color40 (Default=65280)      - GDI_COLOR_QGREEN
Color41 (Default=16776960)   - GDI_COLOR_QCYAN
Color42 (Default=255)        - GDI_COLOR_QRED
Color43 (Default=16711935)   - GDI_COLOR_QMAGENTA
Color44 (Default=65535)      - GDI_COLOR_QYELLOW
Color45 (Default=12632256)   - GDI_COLOR_QGRAY
Color46 (Default=16777215)   - GDI_COLOR_QWHITE
Color47 (Default=16777215)   - GDI_COLOR_QBACKFILL
Color48 (Default=0)          - GDI_COLOR_QFOREFILL
Color49 (Default=0)          - GDI_COLOR_QFRAME
Color50 (Default=0)          - SPARE
Color51 (Default=8421376)    - GDI_COLOR_DESKTOP
Color52 (Default=12632256)   - GDI_COLOR_3DFACE
Color53 (Default=8421504)    - GDI_COLOR_3DSHADOW
Color54 (Default=16777215)   - GDI_COLOR_3DHIGHLIGHT
Color55 (Default=16777215)   - GDI_COLOR_3DHILIGHT
Color56 (Default=16777215)   - GDI_COLOR_BTNHILIGHT
Color57 (Default=8388608)    - GDI_COLOR_MENUHILIGHT  
Color58 (Default=0)          - SPARE
Color59 (Default=0)          - SPARE
Color60 (Default=0)          - SPARE
Color61 (Default=0)          - SPARE
Color62 (Default=0)          - SPARE
Color63 (Default=0)          - SPARE
BlinkRate (Default=500)      - Number of milliseconds between caret blinking.
TimerRate (Default=50)       - Minimum number milliseconds between TIMER interrupts. Decrease this
                               to improve OMNIS WebServer performance but it will have an impact
                               on the OMNIS user interface (but this is of no consequence when using
                               OMNIS as a WebServer only).
NoFreeLib (Default=0)        - Software developers who want to debug OMNIS Extensions may experience
                               problems maintaining their breakpoints as OMNIS may unload their .so
                               file after use. To prevent this, set NoFreeLib to 1 but remember that
                               .so files will be remain loaded after any use, which will increase memory.
BackingStore(Default=1)      - BackingStore enables the server to provide smoother redrawing than when
                               this is switched off (BackingStore=0). However it does increase server
                               memory usage and should be used on high-performance machines only.
DClickTime(Default=400)      - DClickTime specifies the number of milliseconds between mouse clicks
                               which indicates that the action is a double click.
CacheWinTrees(Default=1)     - CacheWinTrees provides a significant speed improvement when using 
                               windows with a large amount of child windows and/or window components.
                               Switching this on does increase memory on a per window basis.                              
MenuBarHeight(Default=22)    - The height of menu bars in pixels.
OverrideDPI                  - The DPI of the screen - used when creating fonts for example.  By default, OMNIS attempts to calculate this using
                               information from the system, but this information is not always reliable.  If your fonts are not sized as you would
                               like, you can set this entry to a DPI value e.g. 192. 

                          
[Localize] & [Language] Sections
================================
The localize section contains one entry under the key of "Language" (this defaults to English).
There must also be a section which is named after that entry.
These sections contains the language translations of various strings used in the omnisxi layer. 
For example "Ok messages" and "File dialogs". 
To translate simply add a new section (use the existing one as a template) and modified the right
operand of each identifier. Then change the Language to the new created sections' name.

March 2016
