Differences

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

--- controlpanel [2023/08/14 07:32] – [Manual Camera Type Selection] 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-with-target.png?direct&600|}}
+It is divided into three segments -
+  - Race Status
+  - Camera Control
+  - Overlay Control
-===== Target =====
+===== Race Status =====
-At the very top of the control panel tab are five target text boxes.  They are:
+This part of the control panel gives the current status information about the iRacing simulator.
-  * The target car number
-  * The target driver name
-  * The target camera group
-  * The target reason
-  * Camera switch timer
-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.
+==== 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.
-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.)
+==== Session Name ====
+This is the current iRacing session name. Examples of typical session names are “PRACTICE”, “QUALIFY”, and “RACE”.
-The target reason would be one of the director rules, or "manual" if the camera is being manually controlled by you.
+==== Session Type ====
+This is the current iRacing session type. Examples of typical session types are "Practice", "Lone Qualify", and "Race".
-The camera switch timer indicates how much time is left on the current camera group before it will be allowed to switch to a different camera group.
+==== Session State ====
+This is the current iRacing state of the session. The possible session states are:
-===== Manual Camera Type Selection =====
+  * StateGetInCar
-Immediately below the target text boxes are some buttons in a single row.  These buttons allow you to select the camera type to use while manual control is active.  They are:
+  * StateWarmup
-  * Scenic
+  * StateParadeLaps
-  * Pits
+  * StateRacing
-  * S/F (abbreviation for "Start / Finish" line)
+  * StateCheckered
-  * Inside
+  * StateCoolDown
-  * Close
-  * Medium
-  * Far
-  * Very Far
-  * AutoCam
-  * C1 through C6
-The camera groups that these camera type buttons are defined in the [[director:cameras|Director | Cameras]] tab.
+==== Sim Time ====
+This is the current iRacing simulator time.
-The current selection is indicated by the button with the light blue border.  If that light blue border is blinking, then manual control is active.  You can click on that button to turn off manual control.
-===== Drivers =====
+==== Rem. Time ====
-In the main part of the control panel, you will see a grid of driver names.  At the top are driver names for drivers that are on the track.  At the bottom are driver names for drivers that are off the track (PIT or OUT), and also the pace car is located there as well.
+This is the amount of time remaining for the current session.
-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.
+==== Rem. Laps ====
+This is the number of laps remaining for the current session.
-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.
+===== 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.
-====== Director and Manual Control ======
+==== Timer ====
-There are two different modes for controlling the iRacing cameras, automatic (using the director) and manual.
+This is the time remaining before we will send the next camera and target car selections to the iRacing simulator.
-To turn on automatic camera control, you can enable the director by clicking on the ''Enable Director'' button.  Then to disable automatic camera control, you can click on the same button (which now says ''Disable Director'').
+==== Car Number ====
+This is the car number of the next target car.
-During automatic camera control, the driver box with the steady green border is the currently focused driver.
+==== Driver Name ====
+This is the driver name of the next target car.
-To turn on manual control, just click on any driver.  While manual control is on, the currently focused driver will have a blinking blue box.  To turn off manual control, click on that same driver, or click on the currently selected camera type button.
+==== 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.
-====== Drivers ======
+==== Reason ====
-The control panel will show up to 63 drivers, plus the pace car. The drivers are split up into an 8x8 grid.
+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".
-{{ :controller:driver-box-1.png?nolink|}}
+==== Driver Grid ====
-The image to the right shows an example of what a driver box looks like.
+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 top left corner of the driver box shows the current leaderboard position for that driver. In the image it is indicating P4 which means 4th place.
+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 top right corner of the driver box shows the car number for that driver. In the image it is indicating car number 14.
+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 bottom left corner of the driver box shows the current attacking heat of that driver. In the image it is indicating 0.9 for this driver.  When the driver is completely cold (heat = 0) then it will display nothing at the bottom left corner.
+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.
-The bottom right corner will be blank if the driver is on the track, or it will indicate either "OUT" or "PIT" when the driver is off the track.
+{{:control_panel:control_panel_driver_grid.png?direct&600|}}
-The background color of the box will change depending on the attacking heat of the driver.  When the heat is between 0 and 1 the box color changes from white to yellow.  As the heat approaches 2, it transitions to orange, and then as the heat approaches 3, it transitions to red.
+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
-{{ :controller:driver-box-2.png?nolink |}}
+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.
-====== Overlay Toggles ======
+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.
+  * Enabled - This turns on and off iRacing-TV camera control.
+  * Director - Click on this to enable automatic camera control.
+  * Manual - Click on this to enable manual camera control.
+  * Scenic - Click on this to enable manual control and to select the scenic camera.
+  * Pits - Click on this to enable manual control and to select the pits camera.
+  * S/F - Click on this to enable manual control and to select the start/finish line camera.
+  * Inside - Click on this to enable manual control and to select the inside camera.
+  * Close - Click on this to enable manual control and to select the close camera.
+  * Medium - Click on this to enable manual control and to select the medium camera.
+  * 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.
+  * C1 through C6 - Click on these to enable manual control and to select the corresponding custom camera.
+These camera buttons are defined in the [[director:cameras|Director | Cameras]] tab.
+The current selections are indicated by the buttons with the green border.
+====== 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.
@@ Line 84: / Line 128: @@
   * Subtitles
   * Intro
+  * HUD
   * C1 through C6