EFILive Home Page | Downloads | Support Forum
Home
Up
 

 

 

Ini file parameters

EFILive V4 stores all non vehicle specific configuration data in the file: EFILiveV4.ini in the current directory (not in the Windows directory). 

EFILiveV4.ini is a standard Microsoft Windows® ini file. Each section is described below.

[f<name>]

There are many sections with names beginning with the letter 'f'. These sections correspond to the different windows used by EFILive V4. (The 'f' stands for form).

Each  [f<name>] section contains the window position:

Key Description Value
Left The horizontal position of the window. A number
Top The vertical position of the window. A number

Some [f<name>] sections may also include the window size and state

Key Description Value
Width The horizontal width of the window A number
Height The vertical height of the window. A number
State The state of the window Minimised, Maximised or Normal

Some [f<name>] sections will contain splitter bar positions. Splitter bars enable you to resize frames within a window.

Key Description Value
<name>Split The position of the named splitter bar. A number

 

[License]

The license section contains your license details. Your unique key can only be used to activate EFILive on the machine on which it was installed. None of the license key values may be changed.

Key Description Value
Serial Number Your unique serial number. Encrypted data.
Key Your unique license key. Encrypted data.
LicenseType Your license type. Professional or Evaluation.
Expiry The license expiry date. A date in the form YYYYMMDD.
LicenseTo The contact person responsible for the license. Licensee's name.
Company The name of the company to which the software is licensed. Company name and address.

 

[ColumnWidths]

Some windows present tabular data. You can adjust the size of the columns in the tables. The column sizes are saved here.

 

[fMain]

The main window stores extra information about the configuration of EFILive V4.

Key Description Value
Aldl_ViewStyle The display layout of the Aldl (F7) tab page. LargeIcon, SmallIcon, List or Report.
DTC_ViewStyle The display layout of the DTC (F10) tab page. LargeIcon, SmallIcon, List or Report.
Flag_ViewStyle The display layout of the Bit flags (F11) tab page. LargeIcon, SmallIcon, List or Report.
ProcMacros Determines if the Macros (F6) tab page will be updated while capturing data. 0: Will not updated
1: Will be updated.
ProcAldl Determines if the Aldl (F7) tab page will be updated while capturing data. 0: Will not updated
1: Will be updated.
ProcVirtualDash Determines if the Dashboard (F8) tab page will be updated while capturing data. 0: Will not updated
1: Will be updated.
ProcCharts Determines if the Charts (F9) tab page will be updated while capturing data. 0: Will not updated
1: Will be updated.
ProcDTCs Determines if the DTC (F10) tab page will be updated while capturing data. 0: Will not updated
1: Will be updated.
ProcBitFlags Determines if the Status flags (F11) tab page will be updated while capturing data. 0: Will not updated
1: Will be updated.
mruVehicle The most recently used vehicle. This is the vehicle that is loaded when EFILive V4 starts. A *.xml file name.
mruMacro The most recently used macro. This is the macro that is selected when EFILive V4 starts. The macro number.
Test Determines if "Macro test mode" is checked. 0: Not checked
1: Checked.
ViewIO Determines if ViewIO is checked. 0: Not checked
1: Checked.
ViewToolbar Determines if the toolbar is visible. 0: Not visible
1: Visible.

 

[Comm]

Comm port settings.

Key Description Value
Port The com port name Com1, Com2, ... Com9
Baud The baud rate A number
DataBits The number of data bits 7 or 8
Parity The parity Even, Odd, Mark, Space or None
StopBits The number of stop bits 1, 1.5 or 2
In The input buffer size in bytes A number
Out The output buffer size in bytes A number
Echo Determines if an echo is expected from the max232 interface. 0: No echo expected.
1: Echo expected.
DTR Determines if the DTR line will be held high. 0: Not held high.
1: Held high.
RTS Determines if the RTS line will be held high. 0: Not held high.
1: Held high.

 

[Properties]

General properties.

Key Description Value
VehicleDir The directory name where the *.xml vehicle definitions are stored. A fully qualified directory name.
SaveVehicle Determines how EFILive behaves when there is a vehicle definition to be saved. 0: Auto save
1: Prompt the user.
2: Discard the changes.
DataDir The directory name where the *.alg (and *.bin) log files are stored. A fully qualified directory name.
SaveData Determines how EFILive behaves when there is logged data to be saved. 0: Auto save
1: Prompt the user.
2: Discard the changes.
8.3FileNames Determines if EFILive should save the *.alg logged data files with 8.3 filenames. 0: Use standard long names.
1: Use 8.3 filenames.
HelpDir The directory containing "index.htm", the documentation home page. A fully qualified directory name.
PopupRows The maximum vertical size of popup menus. 0: Let EFILive figure it out.
>0: Maximum rows.
FrameCaptureRate Determines the frame capture rate in frames per second. A number
PlayBackSpeed The playback speed multiplier. A floating point number:
1.0: Normal speed
0.5: Half normal speed
2.0: Twice normal speed
etc...

 

[CHART_COMMON]

General chart settings. 

Colors are set using an RGB color specification, that is color = Red+(Green*256)+(Blue*65536). See below for a list of commonly used colors.

Key Description Value
LineWeight The width of the lines used to draw the charts. 0, 1, 2 or 3.
Speed The number of pixels that the chart scrolls at a time. 1..8
NotesColor The background color for the chart notes. RGB color
RulerColor The background color for the chart ruler. RGB color
NotesVisible Determines if the notes are visible. 0: Not visible.
1: Visible.
RulerVisible Determines if the ruler is visible. 0: Not visible.
1: Visible.
RulerTickColor The color of the ruler's tick marks. RGB color
RulerFontColor The color of the ruler's labels. RGB color
RulerInterval The number of milliseconds between the ruler's large tick marks. A number
RulerSubInterval The number of milliseconds between the ruler's small  tick marks. A number
RulerLabelInterval The number of milliseconds between the ruler's labels. A number
RulerFormat The format of the ruler's labels. A format string consisting of the mnemonics:

hh: Hour
nn: Minute
ss: Second

F2Delta The number of frames to move the cursor when using arrow keys to control the chart inspector. A number
F2DeltaCtrl The number of frames to move the cursor when using ctrl-arrow keys to control the chart inspector. A number
Note<n>Color The colors of each of the 32 notes. RGB color

 

[CHART_n]

Specific chart settings.

Colors are set using an RGB color specification, that is color = Red+(Green*256)+(Blue*65536). See below for a list of commonly used colors.

Key Description Value
Color The background color of the chart. RGB color
GridColor The color of the grid lines. RGB color
GridCount The number of grid lines, not including the bottom gridline. A number
YaxisFontColor The y-axis font color RGB color
DisplayMin The chart's minimum display value. See DisplayMinOverride below. A number
DisplayMax The chart's minimum display value.See DisplayMaxOverride below. A number
DisplayMinOverride Determines if the "DisplayMin" value is used as the chart's minimum display value. 0: Auto calc the minimum value.
1: Use DisplayMin as the minimum value.
DisplayMaxOverride Determines if the "DisplayMax" value is used as the chart's maximum display value. 0: Auto calc the maximum value.
1: Use DisplayMax as the maximum value.
Series1Color The color of chart series 1 RGB color
Series2Color The color of chart series 2 RGB color
Series3Color The color of chart series 3 RGB color
Series4Color The color of chart series 4 RGB color

 

[Dash_<n>] Version 4.3.2 and earlier

Specific dashboard item settings.

Colors are set using an RGB color specification, that is color = Red+(Green*256)+(Blue*65536). See below for a list of commonly used colors.

It is not necessary to modify these dashboard settings via the ini file. You can right click on any dashboard gauge to set its properties.

Key Description Value
Color The background color of the chart.

This is NOT the face color of the gauge - the face color must always be black - because of the drawing optimisations that are necessary for real-time gauges.

RGB color
BorderColor The color of the border. RGB color
BorderWidth The width of the line used to draw the border. A number between 2 and 10
MinColorA The color of the part of scale that is less than AlarmMin. RGB color
MaxColorA The color of the part of scale that is greater than AlarmMax. RGB color
ScaleColor The color of the part of scale that is between AlarmMin and AlarmMax - i.e. the range o9f acceptable values for the gauge. RGB color
BrightMinMax Determines if the minimum and maximum indicators are displayed in full brightness or half brightness. 0: Half brightness.
1: Full brightness.
ShowMinMax Determines if the minimum and maximum indicators are visible. 0: Not visible.
1: Visible.
ShowUnits Determines if the gauge's units are displayed next to the gauge's value. 0: Units are not displayed.
1: Units are displayed.
ShowValue Determines if the gauge's value is displayed. 0: Value is not displayed.
1: Value is displayed.
CaptionFontName The name of the font used to draw the text on the gauge. A font name (i.e. Arial)
CaptionFontStyle The font style used to draw the text on the gauge. Any sum of the following:

0: Normal
1: Bold
2: Underline
4: Italics
8: Strikethrough. 

CaptionFontColor The color of the font used to draw the text on the gauge. RGB Color
ValueFontName The name of the font used to draw the value and units on the gauge. A font name (i.e. Arial)
ValueFontStyle The font style used to draw the value and units on the gauge. Any sum of the following:

0: Normal
1: Bold
2: Underline
4: Italics
8: Strikethrough. 

ValueFontColor The color of the font used to draw the value and units on the gauge. RGB Color
 

[Dash_<n>] Version 4.3.3 and later

EFILive version 4.3.3 and later implements the dashboard items differently than before. Dashboard item configuration information is stored in the system registry under the key: HKEY_CURRENT_USER\Software\Starr Performance\EFILive V4\dash\DashNN.<attribute>

EFILive version 4.6.0 and later implements the dashboard items differently than before. Dashboard item configuration information is stored in the system registry under the key: HKEY_CURRENT_USER\Software\EFILive\V4\dash\DashNN.<attribute>

Where NN is the gauge's number and .<attribute> is listed below.

Specific dashboard item settings.

Key Description Value
Color The background color of the chart. RGB color
Background The name of a bitmap file to be displayed as the gauge's background. Fully qualified pathname
ShowBackground Determines whether or not the background bitmap image will be displayed or not. 0: Do not show background
1: Show background
CaptionFont.Name
CaptionFont.Size
CaptionFont.Style
CaptionFont.Color
Font settings for the gauge's caption Font settings
ShowCaption Determines whether or not the caption is visible. 0: Do not show caption
1: Show caption
PositionFont.Name
PositionFont.Size
PositionFont.Style
PositionFont.Color
Font settings for the gauge's value Font settings
ShowPosition Determines whether or not the gauge's value is visible. 0: Do not show value
1: Show value
HAlignment The value's horizontal alignment 0: Left
1: Center
2: Right
UnitFont.Name
UnitFont.Size
UnitFont.Style
UnitFont.Color
Font settings for the gauge's units Font settings
ShowUnits Determines whether or not the units are visible. 0: Do not show units
1: Show units
Precision
ScalePrecision
The display format of the gauge's value and scale. 0: 1000's
1: 100's
2: 10's
3: 1's
4: None
5: #.9
6: #.99
7: #.999
8: x1000
9: x100
10: x10
NeedleLength The length of the needle is given as a percentage of the gauge's radius. Percentage
NeedleWidth The needle width is given in pixels. 2<=width<=10
VBorder
HBorder
The number of pixels to allow for horizontal and vertical borders. Adjust these figures to position the gauge's scale display. Number
Border Thickness of the gauges border line Number
ScaleFont.Name
ScaleFont.Size
ScaleFont.Style
ScaleFont.Color
Font settings for the gauge's Scale Font settings
MinMaxFont.Name
MinMaxFont.Size
MinMaxFont.Style
MinMaxFont.Color
Font settings for the gauge's MinMax Font settings
ShowMinMax Determines whether or not the MinMax is visible. 0: Do not show MinMax
1: Show MinMax
ColorMin
ColorOk
ColorMax
ColorFace
ColorLine
Colors for various parts of the chart. See below for a discussion on the effect of setting chart colors. RGB colors
AutoPosition
AutoCaption
AutoUnit
AutoMinMax
AutoScale
Determines if the corresponding font is auto-scaled to fit in the gauge. 0: Not scaled.
1: Scaled.

How to set the gauges' colors

If the gauge's face color and scale font color are identical then the gauge's scale will be displayed using the ColorMin, the ColorOk and the ColorMax color settings.

Commonly used colors

Color Red Green Blue RGB color
Black 0 0 0 0
Maroon 128 0 0 128
Green 0 128 0 32768
Olive 128 128 0 32896
Navy 0 0 128 8388608
Purple 128 0 128 8388736
Teal 0 128 128 8421376
Gray 128 128 128 8421504
Silver 192 192 192 12632256
Red 255 0 0 255
Lime 0 255 0 65280
Yellow 255 255 0 65535
Blue 0 0 255 16711680
Fuchsia 255 0 255 16711935
Aqua 0 255 255 16776960
White 255 255 255 16777215
 

Copyright 1998-2006 EFILive Limited