Please Read First
======================================================================
[Software Name] Gymkhana Lap Timer
[Version] 1.4.0.5
[Author] aiken
[License] Freeware (Donation Welcome)
[Environment] Windows 11 (.NET 10.0 or later)
======================================================================

■ Overview
This software is a tool for measuring lap times, recording history, 
and managing data via CSV file export.

■ Installation
No special installation is required. 
This application does not modify the Windows registry and runs directly 
from the executable file.

1. Run "Gymkhana Lap Timer.exe" in the extracted folder.
2. A ".xml" configuration file will be automatically created on 
   the first launch. Please keep it in the same folder as the .exe.
3. Deleting the .xml file will fully reset the application settings.

To uninstall, simply delete the entire folder.

Note: .NET 10.0 Desktop Runtime is required. If it is not installed on 
your PC, the official download site will open automatically on the first launch.

----------------------------------------------------------------------

Thank you for downloading "Gymkhana Lap Timer."

I originally developed this tool for my own use, but decided to polish 
the interface and release it for anyone who might find it helpful. 
I hope it serves you well, despite any minor bugs or missing features.

While accuracy is crucial for lap timing, I have not had the opportunity 
to perform professional-grade verification. However, I believe it is 
reliable enough for general use.

The 7-segment font used for time display is "DSEG7 Classic" 
by "Keshikan."

Although designed for Gymkhana with photoelectric sensor measurement 
in mind, the UI buttons can also be operated manually. Most major 
functions can be assigned to custom shortcut keys.

As my own environment relies on key inputs, the system is optimized 
for this. You can connect the On/Off contacts of a photoelectric 
sensor to an external physical key (via USB, etc.) to interface 
with the PC.

Please note that connection methods for professional-grade 
competition timing devices may not be supported, as I do not have 
the environment to test such hardware.

----------------------------------------------------------------------
■ Usage Guide (Buttons are described using default shortcut keys)

[Basic Behavior]
Buttons and the Car No. field will be grayed out and disabled when input is not allowed. 
The lockout duration can be adjusted in the settings.
If the main window loses focus, an alert will appear to ensure stable operation. 
Please follow the on-screen instructions if this happens during a measurement.

● 1. Basic Operation (PC Standalone Mode)

- Selecting Measurement Mode:
  First, select the measurement mode via the settings or the mode selection buttons. 
  Please refer to the diagrams provided for guidance (I hope they are clear despite my limited drawing skills!).

- Starting the Measurement:
  Press START (Space key) to begin. Connect the start-line photoelectric sensor here. 
  If a Bib Number is entered beforehand, it will be reflected in the history. 
  Alphanumeric characters can be used, but characters assigned as shortcut keys 
  will prioritize button actions over text input, so please choose shortcuts carefully. 
  Operation is possible even without a Bib Number (can be edited later).

- Single Sensor Layouts:
  For courses where the start and finish are at the same location, use a single 
  sensor and connect it to the START button/input. 
  After starting, the button function will automatically switch to STOP.

- Multiple Vehicles:
  Lap starts are supported, allowing up to two vehicles on the track simultaneously.

- Chattering Prevention (Debounce):
  A chattering prevention time is set (and adjustable) to prevent duplicate triggers 
  immediately after starting. The finish line also has independent prevention. 
  Setting this too short may cause malfunctions; a longer setting is recommended.

- Penalties (Pylon Touch / Fall):
  If a pylon is hit or a rider falls, use the UI buttons: TOUCH (Q) or FALL (W). 
  Up to 4 icons are shown on the indicator, but the system continues to count 
  internally beyond that. Entries can be canceled if needed. 
  Penalties are added to the final time and recorded in the history after the finish.

- Penalty Attribution:
  When only the 1st rider is running, penalties are attributed to them. 
  If a 2nd rider is also on the track, penalties are attributed to the 2nd rider 
  (using the 2nd rider's indicator). 
  To avoid confusion, it is recommended that the 2nd rider starts just before 
  the 1st rider reaches the finish line.

- Course Errors (Missed Course):
  Press MISS COURSE (M) to stop timing; the screen will then wait for the rider 
  to exit. If a rider exits the course without crossing the finish line, 
  you must stop the timer manually using the STOP button. 
  Penalty attribution for two vehicles follows the same logic as pylon penalties.

- Results and History:
  Press STOP (Z) to read out the time and save the result to the history log. 
  The result display time on the main screen can be adjusted. 
  New starts are possible even while results are being displayed.

- Editing Records:
  Double-click a row in the history list to edit the Bib Number or pylon penalties. 
  If the 1st rider commits a foul or penalty while the 2nd rider is running, 
  please correct the record in the history after the finish. 
  Since the raw time data cannot be edited, "Missed Course" records can be 
  distinguished by setting the penalty count to an unrealistically high number (e.g., 10).

- Exporting Data:
  History can be exported as a CSV file for editing in spreadsheet software.


● 2. Using an Additional Time Display Monitor
Adding a second monitor enhances the visual experience for both the driver and spectators.

- Setup:
  Click "Open Time Window" on the main UI and drag the window to your secondary monitor.
  Window operations and resizing can be managed via the settings menu. 
  (The aspect ratio is partially fixed to maintain visibility.)
  Right-clicking inside the window also provides control options. 
  Note: On extremely wide monitors, the time display and visual effects may overlap. 
  Since the window frame has been removed for a cleaner look, use the settings menu 
  to relocate the window if it goes off-screen.

- Display Features:
  You can choose between "Always Show Time" or "Hide Progress" (showing the time 
  only upon crossing the finish line).

- Visual Effects:
  1. Penalty Icons: Appear on the monitor when a Pylon Touch/Fall is recorded.
  2. Split Time Comparison: Displays the difference between the current split 
     and the split from your Overall Best Run (not the best individual split).
     To record splits, press SPLIT (X) manually or use a dedicated split sensor.
  3. Disqualification: Displays "Missed Course" or other DQ alerts.

*Note: To maximize visibility, the font size is optimized for times up to 1:59.999. 
Times exceeding this will still be measured accurately even if they exceed 
the optimized display range.

● 3. Using an Additional Signal Monitor
This mode adds professional racing tension and a starting sequence for the driver.

- Setup:
  Window operations are the same as the Time Monitor (though the aspect ratio is flexible).
  Click "Open Signal Window" on the main UI and drag it to the starting line monitor.

- Signal Logic:
  Red lights turn on one by one. After all three are lit, the Blue (start) light 
  will trigger after a random delay of 2 to 3 seconds. 
  Because the interval is randomized, the start timing is unpredictable.
  Simply entering a Car No. and pressing Enter will begin the countdown 
  (works even if Car No. is blank).

- Effects and Rules:
  1. Start Sequence: Starts on the Blue (Green-Yellow) light after three Red lights.
     - In "Sensor Start Mode": Measurement does not start on the Blue light. 
       The driver starts at their own timing, and timing begins when the sensor is tripped.
       However, tripping the sensor before the Blue light triggers a "False Start" (DQ).
     - In "Signal Start Mode": Measurement starts exactly when the Blue light turns on. 
       False start detection is also active.
  2. False Start Alert: Large warning text (customizable) appears upon a jump start.
  3. Standby Mode: You can display a course map or any chosen image during downtime. 
     Includes a color inversion feature.

● 4. Using All Monitors (Full Setup)
Combining all monitors provides the ultimate racing environment and maximizes 
the software's potential. Highly recommended for the best experience.

--------------------------------------------------------------

■ Copyright and Disclaimer
- The copyright of this software belongs to the author, aiken.
- The author shall not be held liable for any damages (including data loss, 
  PC malfunctions, or disputes arising from measurement results) incurred 
  through the use of this software. Please use it at your own risk.
- Copyright (C) 2026 aiken. All rights reserved.

■ Redistribution and Republication
- Unauthorized republication or secondary distribution of this software 
  to other websites is prohibited without prior permission.
- Features and reviews are highly welcome!

■ Contact
support@tyamacup.sakura.ne.jp

■ Update History
2026/03/13  ver 1.0.0.0  Initial Release
2026/03/17  ver 1.1.1.0  Implemented English support. The UI automatically switches to English based on your system language.
                         Minor UI adjustments.
2026/03/20  ver 1.2.0.0  Added BGM ducking support: The system now automatically lowers the volume of background music apps during voice announcements.
2026/03/22  ver 1.2.0.1  Fixed an issue where the ducking duration was incorrect when using BouyomiChan for text-to-speech.
2026/03/24  ver 1.3.0.0  Added an expandable right panel to the main screen with 10 customizable announcement phrase slot.
2026/03/27  ver 1.4.0.1  Overhauled the program to improve measurement accuracy. Added support for custom chime sounds. Also fixed several bugs and refined the UI.
2026/04/02  ver 1.4.0.2  UI adjustments.
2026/04/05  ver 1.4.0.3  Fixed Chatter prevention issue for the stop button in single photoelectric sensor mode.
2026/04/10  ver 1.4.0.4  Fixed split diff display scaling issues across different monitor resolutions. Other UI tweaks.
2026/04/12  ver 1.4.0.5  UI adjustments.

■ Support
This software was developed as my first programming project. While I have 
tried my best to remove bugs, please contact me if you encounter any critical 
issues during normal use. I will do my best to provide a fix, though please 
understand it may take some time.

I personally use this software with a DIY wireless photoelectric sensor system. 
I can provide technical advice and know-how regarding this setup.

Support Address: support@tyamacup.sakura.ne.jp

■ Final Note
If you find this software useful, your support (donations) would be greatly 
appreciated! It motivates me to continue development. 
I look forward to hearing from you on the OFUSE site!

Author Support Page: https://ofuse.me/tyamacup

