GPxCInfo
The GPxCInfo extension shows information about a car.
Custom panels
There can be a maximum of 100 panels for showing information. Each panel can
show information like gear, revs, speed, etc., as text or as images (which can
rotate, scale, move, etc), and show any number of static images.
There is a lot of flexibility to make the panel look the way you want. For
example, you can specify fonts, colors, and visibility ranges.
Items themselves can be track specific. Images can be track, car and/or team specific.
GPxPatch has an optional custom panel by default, if you chose to install it. It's called
the Lo2k Blue Theme panel, which was made by Laurent Rousseau exclusively for GPxPatch,
and is set as the default panel if no other panels are specified.
Keyboard shortcuts
In-game the first 10 panels can be toggled on/off with Ctrl+1 through Ctrl+0.
Pressing I (CInfo_ToggleOnOff key) will toggle showing text and images for all panels in 4 steps.
Panel distribution
Panels are designed to be able to be distributed with ease. If you decide to distribute your
own custom panel then it is recommended to use a rather unique name for your panel and put it
in its own directory under gpxpdata (this is done automatically if you use the 'new' button
to create the panel). If you use your own fonts then you should make them local (see below on how to
edit local fonts). If the font is non-standard, then you also have to include the font file(s) in your
panel directory and specify the file in the font editor. All paths are relative to the location of the
panel.ini file. If your panel is different for different versions of GPx, then include a .ini file
for each version (e.g. panel_gp3.ini and panel_gp4.ini). For best performance, delete all disabled
info items before release.
Configuration options
The following options are available for GPxCInfo:
- Panels. Upto 100 custom panels can be specified.
The checkbox before each panel denotes one of three states:
- Off: panel is disabled.
- On: panel is enabled.
- Indeterminate: panel is enabled but initially invisible. This is only useful for the first 10 panels.
Use Ctrl+<panel number> (1 through 9, and 0 for panel 10) in-game to toggle visibility.
Actions (panel list needs to have focus for the key shorcuts to work):
- Press the spacebar to toggle the checkbox in front of the selected panel.
- Press the 'new' button or press the 'Insert' key to create a new panel and add it to the list.
This will create a directory under gpxpdata with a panel.ini in it.
A dialog is opened to edit the panel. When this dialog is cancelled, the new panel will not be added.
- Press the 'open' button or press the 'o' key to add one or more existing panels to the list, for example one that was downloaded.
- Press the 'delete' button or press the 'Delete' key to remove the selected panel from the list (the panel.ini on disk is not deleted).
- Double click a panel to edit it. The same can be done by pressing the 'e' key, which will edit the selected panel.
- Press the 'up' or 'down' button to move the selected panel up or down, respectively.
The same can be done by pressing the Ctrl+Up or Ctrl+Down key.
The order of the panels is important if they overlap. The first panel is drawn first, so the other panels
could be drawing on top of it.
- Export. When enabled, exports data to shared memory.
Custom panel
A panel has the following options:
- Enable filter. This will enable the filter settings, to turn off the panel under certain conditions.
- Edit filter. Press this button to edit the filter options.
- Draw transparent panels. Will draw automatic half-transparent backgrounds behind
info item texts for easier reading.
- Left, Top, Right, Bottom. These values can have two meanings, depending on their value.
If Left and Top are 0, and Right or Bottom is larger than 1024 or 768 respectively,
then the Right/Bottom specifies the resolution for which the panel is designed (e.g. 1920x1080).
Otherwise, the assumed design area is 1024x768, and Left/Top/Right/Bottom indicate which part of 1024x768 is used by the panel.
The coordinates of the info items, images and controls will be relative to this design area, and will be scaled in-game if a different
resolution is used. See below for how it is scaled.
- Scaling. When the panel is used in a different resolution than the one specified above, this setting controls how the
coordinates of each info item are scaled to the other resolution:
- Move to edges. Scale x and y while maintaining the aspect ratio, keeping items near the edges and remaining space in the center
(if the actual resolution is lower, space will be taken away from the center). This is the default.
- Stretch. Scale x and y independently to cover the whole screen.
- Center. Scale x and y while maintaining the aspect ratio, centering the panel within the remaining space.
- Enable ranges. This will enable ranges that can limit the visibility of the panel in
space and time.
- Edit ranges. Press this button to specify a range. The edited range
will be shown as text below the button.
- Enable images. This will enable drawing of images.
- Edit underneath. Press this button to specify what images to draw underneath the info items.
- Edit on top. Press this button to specify what images to draw on top of the info items.
- Default font. This font will be used for each info item that does not specify its
own specific font. The list of fonts includes local and global fonts.
Local fonts are only available to the current panel and can be distributed. Global fonts are
edited through the main GPxPatch tab, are available to each panel, but cannot be distributed.
- Edit local fonts. Press this button to add or edit local fonts. These settings are stored
in a fonts.ini in the same directory as the panel (panel must be in its own directory).
The fonts dialog is the same as the one used for global fonts.
- Default color. This colour will be used for each info item that does not specify its
own specific colour.
- Default alpha. This alpha value will be used for each info item that does not specify its
own specific alpha value. Value should be between 0 (transparent) and 1 (opaque).
- Info items. Lists all available info items. Each enabled item will show its coordinates
behind its name: text coordinates if applicable, or else control co-ordinates if a control is set.
Details of each item can be edited to the right. Some items have specific settings to edit.
- New. Adds a new item to the list.
- Delete. Deletes the selected item from the list.
- Up. Moves the selected item up in the list. Items are drawn from top to bottom.
- Down. Moves the selected item down in the list.
The item type of the currently selected info item is shown below the list.
Info item
Currently, the available info items are:
- Gear. Selected gear: -1, N, 1, 2, 3, 4, 5, 6, 7.
- Suggested gear. 1, 2, 3, 4, 5, 6, 7, or hidden.
- Gear changes. The number of gear up- or downshifts within the current lap.
- Revs. Revs in rpm.
- Speed. Speed in kph or mph.
- Longitudal acceleration. In G.
- Lateral acceleration. In G.
- Fuel. Fuel laps.
- Water temperature. Engine water temperature.
- Lap. Lap number or laps remaining/done.
- Position. Race position.
- Pit. Request to pit indicator.
- Lap time. Split or lap time.
- Best lap time. Personal best split or lap time.
- Session time. Time elapsed since the start of the session.
- Game time. Time elapsed since the start of the game.
- Pit timer. Time elapsed since the start of a pitstop during a race, until end of pitstop.
- Gap front. Gap to driver in front. Both driver name and gap is shown.
- Gap behind. Gap to driver behind. Both driver name and gap is shown.
- Steer. Steering input. The value is the angle of the front wheel in degrees. Negative is left, positive is right.
- Throttle. Throttle input: 0.00 to 1.00.
- Brake. Brake input: 0.00 to 1.00.
- Name. Driver name.
- Fx help. Help items F1 through F9.
- Blue flag
- Yellow flag
- Warning. On when car has a failure or if there is some other warning.
- Hotseat state. One of the transition states during hotseat mode when player or computer takes control.
- PO. Processor occupancy.
- Label. Static text label. Will render the item name.
Each info item shares the following settings:
- Enable. Enables or disables the selected info item.
- Name. This name will be shown in the list of info items. If empty the item type name is used.
It is also used as static text for the Label item.
- Mask. Lets you edit an item mask. It allows you to enable this item for specific tracks only.
If no tracks are selected, it is enabled for all tracks.
- Enable text. Enables or disables drawing the selected info item text.
Disable it if the item has a control and only the control should be visible.
- X. Specifies the X coordinate of the info item text. A negative X value will be an offset from the right of the panel area.
- Y. Specifies the Y coordinate of the info item text. A negative Y value will be an offset from the bottom of the panel area and align the bottom of the text to it.
- Alignment. Specifies how the text is aligned with regard to the X value.
- Default: Use left alignment for positive X values, and right alignment for negative X values.
- Left: The left of the text will aligned to the X value.
- Center: The middle of the text will aligned to the X value.
- Right: The right of the text will aligned to the X value.
- Decimals. Specifies the number of decimals to show for floating point items,
like speed. It does not have any effect on integral items, like gear.
- Prefix. This text will be put before the item value.
- Postfix. This text will be put behind the item value.
- Font. Specifies a specific font to use for the item text.
- Color. Specifies a specific color mode and color to use for the item text.
Possible modes:
- Default. Use the specified color, or the color used by certain info items internally, according to the
item value.
- Fixed. Always use the specified color.
- Blend. Blend between the two specified colors and alpha values. The first color and alpha is used at the minimum value,
and the second color and alpha is used at the maximum value.
- Alpha. Specifies an alpha value to use for the item text.
Value should be between 0 (transparent) and 1 (opaque). Leave it empty to use the default
alpha specified in the panel settings. When color blending is used, alpha blending will also be used between the two specified alpha values.
- Control. Select a control to use for this item. Currently the available
controls are a rotating line control and an image control.
Press the 'Edit' button to edit the control settings.
- Min. Specifies the minimum value for this item. Currently only useful
for a control, except Brake and Throttle, which use it to scale the rendered value.
- Max. Specifies the maximum value for this item. Currently only useful
for a control, except Brake and Throttle, which use it to scale the rendered value.
- Freeze. Specifies the number of milliseconds the value should freeze at a local maximum.
It will also unfreeze if the actual value becomes higher. When it unfreezes it will linearly
decrease until it reaches the actual value.
The 'Lap' info item has the following specific settings:
- Show laps left. If checked, shows the number of laps remaining, else the current
lap number.
- Show total laps. If checked, also shows the total number of laps.
- Race mode. If checked, it is only visible in a race session,
and shows the lap of the leader instead of the selected car.
In qualify, when either or both of the settings above are checked, the lap counter will be based
on the total number of laps done instead of the current lap number.
The 'Gap front' and 'Gap behind' info items have the following specific settings:
- Name length. Specifies the number of characters to use for the driver's
last name.
- Sign. Specifies the character to show in front of the gap.
Default is '+' for 'Gap front' and '-' for 'Gap behind'.
The 'Pit' info item has the following specific settings:
- Use images. Makes the pit item use images. The images won't
be on a transparent panel and the item text is automatically disabled.
There is an image for when the pit light is on, one for when the light is off,
and one for when the light indicates that light of the team mate is on (busy).
If not checked then normal text will be used.
- Use X/Y for images. If checked then the X and Y position of the
images use the X and Y position of the pit info item.
- Edit images. Edits the settings of the three pit images.
- Off. If images are not used, edits the color of the text when the pit light is off.
- Busy. If images are not used, edits the color of the text when the pit light of the team mate is on.
The 'Lap time' info item has the following specific settings:
- Show milliseconds. If checked then milliseconds are shown, else only minutes and seconds.
- Freeze duration. Specifies how long the split/lap time should freeze at the end a sector.
The 'Best lap time' info item has the following specific settings:
- Show difference with lap time when frozen. If checked then the difference
between the best split/lap time and the current split/lap time is shown at the end of a sector.
- Freeze duration. Specifies how long the best lap time (or difference with current
lap time) should freeze at the end of the lap. If the value is smaller than 0 then
it uses the value specified at the 'LapTime' item.
- Color when faster. Specifies the color to use when a split/lap time is improved.
- Color when slower. Specifies the color to use when a split/lap time is not improved.
The 'Game time' info item has the following specific settings:
- Count down. If checked then the time will count down instead of up.
- Start countdown at. If counting down, it will start at the specified number of minutes.
If the remaining time goes below zero, it will show red.
The 'Fx help' info items have the following specific settings:
- Use images. Makes the help item use images. The images won't
be on a transparent panel and the item text is automatically disabled.
There is an image for when the help item is on, one for when the help item is off,
and one for when the help item is disabled. For F8 (steering help) there is
an additional image for when steering help is on and cannot be turned off (because
digital input is used).
If not checked then normal text will be used.
- Use X/Y for images. If checked then the X and Y position of the
images use the X and Y position of the help info item.
- Edit images. Edits the settings of the three or four pit images.
- Off. If images are not used, edits the color of the text when the help item is off.
- Always off. If images are not used, edits the color of the text when the help item is disabled.
- Always on (F8 help only). If images are not used, edits the color of the text when the help item is on and cannot be turned off.
The 'Blue flag', 'Yellow flag' and 'Warning' info items have the following specific settings:
- Use images. Makes the item use images. The images won't
be on a transparent panel and the item text is automatically disabled.
There is an image for when the value is 'on', and one for when the value is 'off'.
If not checked then normal text will be used.
- Use X/Y for images. If checked then the X and Y position of the
images use the X and Y position of the info item.
- Edit images. Edits the settings of the two images.
- Off. If images are not used, edits the color of the text when the value is 'off'.
The 'PO' info item has the following specific settings:
- Average over. Specifies over how many frames the PO value should be averaged.
E.g. a value of 50 means that the value shown is the average value of the last 50 frames.
Note that PO values over 1000% are not taken into consideration, because the PO
value can have very high peaks, especially right after you enter the cockpit.
Filter
Filter settings turn off the panel under certain conditions.
The filter dialog contains the following settings:
- Show in session modes. This list lets you select the session modes
for which the panel should be enabled. If no modes are selected,
it is enabled for all modes.
- Show in camera views. This list lets you select the camera views
for which the panel should be enabled. If no views are selected,
it is enabled for all views.
- Show in replay. This checkbox can have three states.
If unchecked, the panel is disabled in replays.
If checked, the panel is enabled in replays too.
If indeterminate, the panel is only shown in replays.
- Show in pitlane. This checkbox can have three states.
If unchecked, the panel is disabled in the pitlane.
If checked, the panel is enabled in the pitlane too.
If indeterminate, the panel is only shown in the pitlane.
- Show for player. This checkbox can have three states.
If unchecked, the panel is only shown for computer cars.
If checked, the panel is enabled for all cars.
If indeterminate, the panel is only shown for player cars.
- Show in GPxSAT. This checkbox can have three states.
If unchecked, the panel is disabled when GPxSAT is showing a panel.
If checked, the panel is enabled even when GPxSAT is showing a panel.
If indeterminate, the panel is only shown when GPxSAT is showing a panel.
Ranges
Ranges limit the visibility of the panel.
The range dialog contains the following settings:
- Enable. Enables or disables this range (and all following ranges).
- Type. The range type can be either Track or Session. With a track range the
constraints are based on the track (one lap). With a session range the constraints are based
on the complete session.
- Negate. Reverses the constraints of this range (but not the following ranges),
so the panel is shown when the specified conditions are NOT met.
- From. Specifies the start of the range. For a track range this is either the
number of meters, a percentage of the lap, or the number of seconds, after the start of the
track (lap) or before the end of the track. For a session range this is
either the number of laps, a percentage of the total number of laps, or the number
of seconds into session, after the start of the session, or before the end of the session.
It is not possible to specify the number of seconds before the end, obviously.
- To. The same as From, but there's a third option, 'After start', to make
it relative to what's specified at From.
- It's possible to specify another range that should be combined with this range. The
other range is either intersected ('AND') or united ('OR') with the current range.
Press 'Edit next range' to specify the range to intersect or unite. Any number of
ranges can be intersected or united.
Images
The images dialog contains the following settings:
- New. Press this button to add an image. A new entry will be added to the list.
- Delete. Press this button to delete an image from the list.
- Up. Press this button to move the selected list entry upwards.
Images at the top will be drawn first, so if images overlap the images at
the bottom are the most visible.
- Down. Press this button to move the selected list entry downwards.
- Enable. Enables or disables the selected image.
- Path. Specifies the path of the bitmap file. The path is relative to the
panel directory. The file type should either be .tga or .bmp. The size of the bitmap
should be a power of 2 (1, 2, 4, 8, 16, 32, 64, 128, 256, etc.). It is recommended
to not use larger sizes than 256 or 512, because older videocards do not support
them.
- Destination. Specifies the position and size of the image. The position
is relative to the panel area. If the width and/or height is zero then the size
of the source is used. If non-zero then the bitmap is stretched to the specified
size when it is drawn.
- Scale. Determines how the image size is mapped from the panel design area to
the actual resolution in-game.
The value "No" will disable scaling. "Default" will either stretch or scale, depending on
how the panel is scaled (if the panel scaling is set to "Stretch", then the image size will also be
stretched, otherwise it will be scaled while maintaining the aspect ratio).
"Yes" will scale the image while maintaining the aspect ratio.
"Stretch" will scale the image width and height independently.
- Source. Specifies the position and size of the image within the specified
bitmap file. This way multiple images can be created from the same bitmap file.
Internally there will only be one texture loaded into memory from which the images
are drawn. This is useful if there are a lot of small images that are drawn in one
bitmap (to keep the number of textures limited) If the width and/or height is zero
then the width/height of the bitmap is used.
- Alpha. Specifies the transparency of the complete image. Values should be
between 0 (transparent) and 1 (opaque).
- Show for team. If checked, the image is only shown for the selected team.
- Show for car. If checked, the image is only shown for the selected car.
- Show for tracks. The image is only shown for the selected tracks.
If no tracks are selected, it is shown for all tracks.
It's possible to draw your own transparent panel by specifying a black bitmap with a size of 1x1
pixel and then stretching it to fill the desired area, and setting the alpha value to the desired transparency.
Rotating line control
The rotating line control dialog contains the following settings:
- Enable. Enables or disables this control.
- Angle start. Specifies the start angle in degrees (0 to 360). The line
will be drawn at this angle when the item value is equal to the specified minimum value.
- Angle end. Specifies the end angle in degrees (0 to 360). The line
will be drawn at this angle when the item value is equal to the specified maximum value.
- Clockwise. If checked, the line will rotate clockwise with increasing values, else anti-clockwise.
- Cut off at min/max. If checked, values smaller than the minimum value or larger than
the maximum value will not make the line rotate below/beyond the start/end angles, respectively.
- X, Y. Specifies the position of the middle (center) of the rotating line.
- Offset. Specifies the start of the line, which is the distance to the center.
- Length. Specifies the end of the line, which is the distance to the offset.
- Scale. If checked, the position, offset and length will be scaled from 1024x768
to the actual resolution. The offset and length are both based on horizontal units (1024).
- Color. Specifies the line color.
Image control
The image control dialog contains the following settings:
- Enable. Enables or disables this control.
- Cut off at min/max. If checked, values smaller than the minimum value or larger than
the maximum value will be limited to stop the image animation at that point.
It can be checked again to enter a third state. This state means the image will be hidden beyond the
minimum and maximum value, as if the image control is disabled.
- Mode. Can be one of the following values:
- Truncate. Will make both image source rectangle and destination rectangle smaller,
according to the weights, so only part of the image will be visible. At the
maximum value, the image will be completely visible.
- Scale. Will make only the image destination rectangle smaller, according to the
weights. This has the effect of zooming in and out. At the maximum value the
image will have its normal size.
- Rotate. Will rotate the image around its center.
- Transpose. Will move the image between two positions. At the minimum value the
image will be placed at its original position. At the maximum value the image
will be placed at the specified position .
- Toggle. Will show one image if the item value is below or above a threshold range and
will show the other image if the item value is within that threshold range.
To combine this mode with other modes, don't use this Toggle mode, but use the other mode
and the third "Cut off at min/max" state instead, then add other items of the same type.
Those items can be given the same settings, except the min/max value and the image.
- Radial fill. Will render the part of an image that is between two angles, with the
center of the image as radial center, the start angle static, and the end angle dynamic.
Angle value 0 is at six o'clock, increasing clockwise.
- Weights
- Specify the left, top, right, and bottom weight for truncation or scaling.
A weight of 0.0 will not affect that side at all, and a weight of 1.0 will have made the
image smaller all the way to the other side at the minimum value. If two opposite sides
both have a weight of 1.0, the image will be mirrored at the minimum value. A negative
weight will swap minimum and maximum, so a weight of -1.0 will make the image smaller all
the way to the other side at the maximum value, and unaffected at the minimum value.
- Specify optional offsets for truncation or scaling.
The X and Y offsets are added to the width and height after the weights
have been applied. In combination with truncation this enables the creation of a window that
moves over the image.
- Rotation
- Angle start. Specifies the start angle in degrees (0 to 360). For Rotate mode, the image
will be drawn at this angle when the item value is equal to the specified minimum value.
For Radial fill mode, this is the end angle when the item value is equal to the specified minimum value.
- Angle end. Specifies the end angle in degrees (0 to 360). For Rotate mode, the image
will be drawn at this angle when the item value is equal to the specified maximum value.
For Radial fill mode, this is the end angle when the item value is equal to the specified maximum value.
- Clockwise. If checked, increasing values will rotate or fill clockwise, else anti-clockwise.
- Position end. Specifies the X and Y value of the position at which the image
should be placed when the item reaches its maximum value.
- Threshold. Specifies the threshold range between which the other image will be shown instead.
If both threshold values are equal then the other image will be shown if the item value is above that threshold value.
- All other settings are image settings.
Export
This feature is intended for people who build their own wheels or even cockpits,
and also make their own software for it. Click here
for information about how to access the exported data.
Main |
GPxPatch |
GPxSet |
GPxTrack |
GPxLap |
GPxSAT |
GPxCInfo |
GPxSound