Differences

This shows you the differences between two versions of the page.

--- controlpanel [2023/07/10 08:25] – created marvin
+++ controlpanel [2023/09/07 13:34] (current) – marvin
@@ Line 1: / Line 1: @@
 ====== Control Panel ======
 The control panel tab is the first and main tab of the controller.
+{{:control_panel:control_panel.png?direct&600|}}
-{{:controller:control-panel-tab.png?direct&600|}}
+It is divided into three segments -
+  - Race Status
+  - Camera Control
+  - Overlay Control
-===== Status =====
+===== Race Status =====
-At the top right of the iRacing-TV window you will see a few things relating to the status of iRacing and iRacing-TV. In the screenshot to the right you will see that the current status is "RACE" - "StateGetInCar" - 38040 - green light - red light.
+This part of the control panel gives the current status information about the iRacing simulator.
+==== Sim Frame ====
+This is the current frame number of the live telemetry or playback of the recording. The data comes in at 60 frames per second.
 ==== Session Name ====
-This is the session name that is given by iRacing.  Typical session names are "PRACTICE", "QUALIFY", and "RACE".  There might be others.
+This is the current iRacing session name. Examples of typical session names are “PRACTICE”, “QUALIFY”, and “RACE”.
+==== Session Type ====
+This is the current iRacing session type. Examples of typical session types are "Practice", "Lone Qualify", and "Race".
 ==== Session State ====
-This is the current session state. This will be one of the following:
+This is the current iRacing state of the session. The possible session states are:
-  * StateInvalid (you should not ever see this)
   * StateGetInCar
   * StateWarmup
@@ Line 20: / Line 30: @@
   * StateCoolDown
-==== Frame Number ====
+==== Sim Time ====
-This is the current frame number of the live telemetry or playback of the recording.  The data comes in at 60 frames per second.
+This is the current iRacing simulator time.
+==== Rem. Time ====
+This is the amount of time remaining for the current session.
+==== Rem. Laps ====
+This is the number of laps remaining for the current session.
+===== Camera Control =====
+This part of the control panel allows you to control the camera and select the target car. Control can be done automatically (using the Director), or manually.
+==== Timer ====
+This is the time remaining before we will send the next camera and target car selections to the iRacing simulator.
+==== Car Number ====
+This is the car number of the next target car.
+==== Driver Name ====
+This is the driver name of the next target car.
+==== Camera Group ====
+This is the name of the next camera group. Some camera groups will only have one camera in it, such as the blimp camera group. Other camera groups will have multiple cameras in it, such as the TV1 camera group.
+==== Reason ====
+This is the reason for the selection of the next target car and the next camera group. If the camera is being controlled automatically by the director, this reason will be one of the enabled director rules. If the camera is being manually controlled by you, the reason will be "Manual camera control".
+==== Driver Grid ====
+The main part of the camera control section consists of the driver grid. The driver grid is an 8x8 grid, for a maximum total of 64 drivers including the pace car. Drivers on-track are sorted at the top, and off-track drivers are sorted at the bottom.
+The first on-track driver name is always the P1 driver.  Following the P1 driver are all of the rest of the drivers on the track, in order of physical (not leaderboard) position.  This means it is possible for it to show P1, then P20, then P2 - this means the P20 driver is a lap down and is currently physically located between the P1 and P2 drivers.
+The off-track car list starts with the car furthest from the pit exit and ends with the car closest to the pit exit. The pace car is always in the final position, regardless of where it is actually located on the track.
+The driver with the green border around it is the currently selected target car. Clicking on any of the drivers in the grid automatically selects that driver and turns on the manual camera control.
+{{:control_panel:control_panel_driver_grid.png?direct&600|}}
+Each driver box has five parts:
+  - The current leaderboard position at the top left
+  - The car number at the top right
+  - The calculated heat at the bottom left
+  - "OUT" or "PIT" at the bottom right
+  - The driver name
+The background color of the box will change depending on the total heat of the driver. When the total heat is between 0 and 1 the box color changes from white to yellow. As the total heat approaches 2, it transitions to orange, and then as the total heat approaches 3, it transitions to red.
+Lap down drivers are indicated with a down arrow ↓ on both sides of the driver name.
+The calculated heat consists of three numbers, and from left to right they are:
+  - Base Heat
+  - Bonus Heat
+  - Bias Heat
+=== Base Heat ===
+The base heat is a simple calculation based on the gap time to the car in front.  It is "1" when the gap time to the next car is 0, and falls off to "0" as the gap time approaches the maximum gap time setting. For example, if the maximum gap time is set to be 5 seconds, when the gap time to the next car is 2.5 seconds the base heat is calculated to be 0.5.
+=== Bonus Heat ===
+The bonus heat is a calculation based on the change in gap time. When the gap time to the next car decreases, the bonus increases.  If the gap time to the next car increases or does not change, the bonus fades away towards 0.
+=== Bias Heat ===
+The bias heat is applied to any car that has a non-zero base or bonus heat. The amount of bias is controlled by the heat bias slider in the settings and the leaderboard position of the car.
+==== Camera Control Buttons ====
+To the right of the driver grid is a series of buttons, arranged vertically.
-==== iRacing Connection Light ====
+  * Enabled - This turns on and off iRacing-TV camera control.
-This is the first of the two indicator lights.  If this light is red, then the iRacing game is not loaded and running.  If it is green, then the iRacing game is loaded and running, and iRacing-TV is receiving data from the game.
-==== Director Light ====
+  * Director - Click on this to enable automatic camera control.
-This is the second of the two indicator lights.  If this light is red, then the director is not enabled.  If it is green, then the director is enabled and is automatically managing the iRacing camera.
+  * Manual - Click on this to enable manual camera control.
-===== Target =====
+  * Scenic - Click on this to enable manual control and to select the scenic camera.
-At the very top of the control panel tab are five target text boxes.  They are:
+  * Pits - Click on this to enable manual control and to select the pits camera.
-  * The target car number
+  * S/F - Click on this to enable manual control and to select the start/finish line camera.
-  * The target driver name
+  * Inside - Click on this to enable manual control and to select the inside camera.
-  * The target camera group
+  * Close - Click on this to enable manual control and to select the close camera.
-  * The target reason
+  * Medium - Click on this to enable manual control and to select the medium camera.
-  * Camera switch timer
+  * Far - Click on this to enable manual control and to select the far camera.
+  * Very far - Click on this to enable manual control and to select the very far camera.
+  * AutoCam - Click on this to enable manual control and to select the AutoCam camera.
-The target is the car and driver that iRacing-TV is trying to focus the iRacing camera on.  If this car is not in the game (indicated as "OUT") then iRacing will tend to switch to the scenic camera, or freeze the current camera.
+  * C1 through C6 - Click on these to enable manual control and to select the corresponding custom camera.
-The target reason would be one of the director rules, or "manual" if the camera is being manually controlled by you.
+These camera buttons are defined in the [[director:cameras|Director | Cameras]] tab.
+The current selections are indicated by the buttons with the green border.
-The target camera group is one of the camera groups in iRacing, such as "Blimp", or "TV1" or "TV2".  Some camera groups have only one camera (Blimp) while other camera groups have multiple cameras (TV2, etc.)
+====== Overlay Control ======
+At the bottom of the control panel is a series of buttons to temporarily toggle individual overlays on or off.  The default status of these buttons correspond to the saved "Enabled" setting for each overlay.
-The camera switch timer indicates how much time is left on the current camera group before it will be allowed to switch to another camera group.
+  * MASTER - This is the master off switch - turning this off turns off all overlays
+  * Race Status
+  * Leaderboard
+  * Track Map
+  * Start Lights
+  * Voice Of
+  * Subtitles
+  * Intro
+  * HUD
+  * C1 through C6