====== Configuration Settings ======

ZRound is deeply configurable allowing different settings for views, data columns, sounds, text to speech, etc.

This chapter defines all setting options in detail.

Configuration options form offers a tree-view menu at left to select the configuration section to work with.

  * Selected item is marked with a red arrow
  * Active lapcounter is highlighted with yellow on red colors.

{{:zround:zround_safqo0rdp9.png?600 |}}

===== Options =====

==== Display ====
Main display settings

^Setting^Description^
|Language|User interface language|
|Show all race events|If unchecked, some events are not dumped to the log (racer start/end/classification)|
|Force showing time interval in Le Mans races|Time intervals are always displayed on secondary monitor for Le Mans start mode runs|
|Lock real-time graphic update|Position chart is not updated while race is running. It needs a powerful computer on endurance races with large number of laps. Disabling it can help with performance issues|
|Time to group racers(colors)|Time difference between racers (in seconds) to show them in the same color on console|
|Car number|Defines which numer is used as racer's number on displays: Number (on run), Dorsal (number on race), License (user's defined)|
|Time to remove car registration from training|Elapsed minutes to wait before removing a car from the practice session (0 = infinite). It helps to keep clear the console for racers who abandoned the track|
|Countdown time|Clock is countdown mode|

==== Lap Control ====

=== TRANSPONDER/ LAP REGISTERING ===
^Setting^Description^
|Start counter in last detection for //min. lap time//|It won't count a new lap if car doesn't abandon the detection are for //min. lap time// setting|
|Noisy lap control (laps under 1sec. will be ignored)|Some lapcounters (ie GiroZ/Kyosho) fires lots of messages when car is passing. This settings prevents extra processing/log dumps on this situation|
|Ignore freq colissions|Nowadays it should be always ignored as no more analog transmitter are used. This setting was used to prevent to racers running with the same frecuency on their transmitters|
|Ignore unregistered transponders in races|When checked, any unregistered transponder will be ignored if detected. Otherwise, it is shown as "unregistered" transponder on console and it can be assigned to registered racers. Feature introduced due issues with //GiroZ// lapcounter which fired laps when nobody was passing (due interferences, electrical issues, ...)|

=== UNATTENDED RACE ===
^Setting^Description^
|Start next race automatically (only Staggered runs)|When a race finishies and it was started from Championship manager, next race will start automatically. It only works for staggered start (commonly during classification heats runs) because Le Mans start requires cars to be placed on the right position in the starting grid.|

=== PRACTICE MODE ===
^Setting^Description^
|Free practice restarts automatically in Le Mans Mode|it is useful when you want to manage limited practice session times to stabish turns. For example: if practice time is 5min., after 5min the end of practice time is announced and automatically a new practice time is fired (to allow next group of racers tu practice).|
|Save free practice laps to database|Free practice times are not saved to database unless this option is checked.|


==== Web output <deprecated> ====
^Setting^Description^
|Generate real time web output|Generate a .html file with lapcounter results on every pass|
|HTML classification file|Path to the file to be created|
|Refresh every ... sec|Include a meta "refresh" to reload the page on the specified interval|

This feature is <color #ed1c24>deprecated</color> and the functionality will be removed on future releases.

There is available a new and better feature to publish realtime data using //**[[#Live|ZRound Live]]**// service.
==== Printing  ====

^Setting^Description^
|Ask for printing after races|When the race finishes application will ask for printing the run results|
|Logo|File path with the logo to be used on reports (recommended size 180x50)|
|Field list|Field checked will be used on the report output|
|Font size|Font size used on classification table|
|Font Size (laps)|Font size used on lap time table|
===== Monitor =====

Secondary monitor settings

{{:zround:monitor2_settings.png?400 |}}

^Option^description^
|Font size|Font size used to display data (0 for automatic selection)|
|Field list|You must check the data column required to be displayed. It can be configured on monitor2 context menu|
|Decimal places in times|You can select how many precission digits you want to use in times (i.e 0.235; 0.23; 0.2)|
|Show start lights|Simulate a traffic light during the count down on race start|
|Full screen on secondaryt monitor|You can choose which monitor (0,1,2..) will be used to display data on full screen mode. You can also place the window where required manually|
|Show top qualify on heats|On championship races, the Top Qualify results for all heats will be shown at right|
|Show top best laps|On practice time, racer's best lap will be displayed at right|
|Logo|You can define your own logo to be shown at right-bottom corner|

===== Sound =====
There are two pages of sound settings


==== Sounds 1 ====

^Sound^Event^Default value^
|Unregistered car|An unregistered car was detected during a race practice/run|resources\alarma.wav|
|Suspected reading|A ghost lap was detected. Fired on these conditions:\\ * A racer exceeds time on limited time practice session\\ * On practice session, lap time < 1sec when lap noise control is enabled\\ * lap time < min. lap time setting|(disabled)|
|Finish line pass|transponder detected on detector line|resources\count.wav|
|Lights|starting light on|resources\count.wav|
|Staggered start|Warn racer to start race on staggered start mode|resources\prestartbeep.wav|
|LapZ Bridge Alarm|LapZ Bridge max time running alarm|resources\ding.wav|
|Race finished driver|Racer finishes its run|(disabled)|
|Race starts|Race start horn|resources\init.wav|
|End of race|Race ends horn|resources\init.wav|
|Time finished|Run time finished. Last lap time counter starts|(disabled)|

	
==== Sounds 2 ====

^Sound^Event^Default value^
|Better own time|Best own time on current session|resources\veloz.wav|
|Best lap|Best lap on the current session|resources\best.wav|
|First rank|First position in race|resources\bocina.wav|
|Track best lap time|Best lap time on this track layout|resources\sirena.wav|
|Best own time|Best own time on this track layout|resources\personal.wav|
|Best lap target|Lap time under racer's target lap time|resources\target.wav|

  * The button "Default" will restore factory setting.
  * You can set the volume of sounds with the volume bar. It only affects to sounds, not text to speech.

===== Colors =====

There are two color settings for both main console and secondary monitor.

==== Main Monitor ====
{{:zround:zround_color_main.png?400|}}

  * Night vision mode uses low luminance colors
  * With //Apply// button you will check colors combination before confirm them.

=== General ===
^Setting^Description^
|Background|Application background color|
|Text|Application text color|

=== Qualifying ===
^Setting^Description^
|First position|Color used to hightlight the first position car|
|Best lap|Color used to highlight the best lap time|
|Ranking|Color for the racer's panel|

=== Stopwatch ===
^Setting^Description^
|Active|Color when running|
|Pause|Color when paused|
|Stopped|Color when stopped|

==== Secondary Monitor ====

{{:zround:color_monitor2.png?400|}}
===== Speaker =====

**Activate SAPI 5.1** option must be checked to enable the text to speech function.

You must have installed a Microsoft SAPI compliant voice (Windows include default voices you can use). You should use a voice compatible with the user interface language configured. Otherwise you will get an annoying result (i.e. italian voice speaking text written in english).

If your native language is not supported on the user interface you should use the [[#Language]] settings to setup the resources needed to grant a reasonable automatic reading. You should edit Events text as well.

{{ :zround:tts-settings.png?600 |}}
==== Speaker ====

  * **Voice**: Select the voice to be used on reading
  * **Test text**: You can enter a text to test out the reading clicking on **Listen** button
  * **Speed** and **Vol.** controls the text reading speed and volume
==== Events(1) ====

Events define the text to be read out when they occurs. Only checked events are read.

{{ :zround:tts-events1.png?600 |}}

^Setting^Description^
|Track open|Only on practice time on championship/event races. It announces track is open and the list of allowed racers|
|Practice time|//Practice time// is read after the configured text|
|Cars ready|It announces the practice/run time is going to start|
|Staggeder start|Announce start time to every racer. Symbol %s will be replaced by the racer's name|
|Stop and Go|Give a stop and go to the selected racer. Symbol %s will be replaced by the racer's name|
|End of race|It announces the race is finished|
|Car finished|It announces the car has finished the run. Symbol %s will be replaced by the racer's name|
|End of practice|It announces practice time has finished|
|End race alarm|It announces the time to finish the race before the configured text|
|Finish line pass|It announces a racer passes the finish line. Symbol %s will be replaced by the racer's name and %p the racer's position|
|Lap time < Min. time|It announces a missed lap due lap time is under min. lap time. Symbol %s will be replaced by the racer's name and %t will be the lap time|

You can use the //Default// button to restore default settings
==== Events(2) ====

{{ :zround:tts.events2.png?600 |}}

^Setting^Description^
|First position|A new racer gets the first position. Racer's name is read after the configured text|
|Best lap in race|A racer do the best lap in the race|
|Best own lap|A racer do his best lap time on the current session. Racer's name and lap time will be read out after configured text|
|Best own time|A racer do his ever best lap time. Racer's name and lap time will be read out after configured text|
|Track best lap time|A racer do the track best lap time. First %s symbol will be replaced by the racer's name, second %s symbol will be replaced by the lap time|
|Lap estimation|Estimation result for the racer. It uses three parameters with this order %s %d %s -> racer's name; %d -> number of laps; %s -> total time. Example: //%s estimate finish %d laps in %s//|
|Interval gap reading|It defines how to read interval and gaps. First %s symbol will be replaced by the racer's name, second %s symbol will be replaced by the lap time|
|Call racers using|If defines how to call racers. Name -> Racer's name; Number -> Racer's number on the run; Dorsal -> racer's number on the race.|

You can use the //Default// button to restore default settings

==== Options ====

{{ :zround:tts-options.png?600 |}}

^Setting^Description^
|Speak time to finish|Time to go in seconds to start announcing|
|repeat on|seconds interval to repeat announce en of race at a time basis|
|Positions to read on head changes|Number of positions (position/racer) to announce if race head changes|
|Results reading after finishing race|Run results are read out when it goes when checked|
|Read training result times|Practice session results are read out when checked|
|Read estimation when value changes|Force estimations read out if the value changes when checked|
|Read estimation every X laps|Estimation is read out every X laps|
|Read best lap record in all heats/mains (up to 3rd)|If a racer gets up to the 3rd best lap on a race it will be announced (default text: Position X on best laps)|
|All laps reading on free training|All lap times are read out on free practice sessions. If //name// is checked then the racer's name will be announced as well|
|Read classification each|Classification will be announced periodically every X minutes when checked|
|Start reading on lap number X|Announces won't be read out before the lap X. Reading from the first lap could be annoying because too many events occurs on the firsts laps|
|Decimal places in lap time|Number of decimal places to read out times (1=tenths of seconds, 2=cents, 3=milliseconds)|
|Skip lap times greather than|Avoid to announce wrong lap times, usually due to a lapcount failure or a race incident|
|Classification reading during the race|Value used to announce the classification Raking/Interval/Gap/Laps result as shown bellow|

^Classification Option^Description^
|Ranking|Race position|
|Interval|Difference with the first position|
|Gap|Difference with the previows racer|
|Laps|Number of laps|
==== Language ====

ZRound Suite are available in several languages. However, you could need to use voice announces on your mother language despite the user interface uses another one.

You can do it using these language settigs. Select the language you want to use and edit the key-words needed. Other text are configured as documented on [[#Events(1)]] & [[#Events(2)]] sections

{{ :zround:tts-language.png?600 |}}


===== Network =====

==== Live ====

==== Remote ====
===== Layout =====

===== ScoreBoard/Lights =====

===== Relay races =====

===== Lapcounters =====

Visit [[:lapcounters|Lapcounters Referece]]