Battery + Wireless Gui Controls

Download Code File

This resource implements two gui controls that display wireless connectivity and battery levels using the Intel Laptop Gaming TDK. Many of the TDK functions are also exposed to script. By monitoring the battery level of a laptop and throttling game performance accordingly, it is possible to significantly extend battery life.


Add the following files your VC++ (or whatever) project:
--------------------------------------------------------
guiIntelBatteryMeter.cc
guiIntelBatteryMeter.h
guiIntelConnectivityMeter.cc
guiIntelConnectivityMeter.h
laptopConsoleFunctions.cc
IntelLaptopGaming.lib
IntelGamingTDKAPI.h


Place this file in the same folder as your Torque executable
--------------------------------------------------------
IntelLaptopGaming.dll


Other Files:
--------------------------------------------------------
BatterySaving.cs - An example script of how to throttle game performance based on remaining battery life.

The source code for the dll file as well as more information on the Intel Laptop Gaming TDK can be found here: http://softwarecommunity.intel.com/articles/eng/1017.htm




The GuiIntelConnectivityMeter switches between 5 different images depending on wireless signal strength, plus a 6th image for wired mode. The thresholds for each image are configurable through the "wirelessThresholds" field of the gui control.

The GuiIntelBatteryMeter is a bar graph that changes smoothly in size and color depending on the battery level (colors and thresholds for each color are configurable). One of two images overlayed on top of the bar depending on if you are using ac power or the battery. When you are on ac power the battery level is still displayed, but it is always displayed in the top color threshold (green in this example)

The following console functions are implemented:
--------------------------------------------------------
IsLaptop()
IsWirelessAdapterConnected()
IsWirelessAdapterEnabled()
GetConnectedAdapter()
GetNumCoresPerProcessor()
GetCurrentCPUUtilization()
GetCurrentCPUFrequency()
GetMaxCPUFrequency()
GetSecBatteryLifeTimeRemaining()

GetPowerSrc()
Returns one of the following strings:
Battery_Power
AC_Power
Undefined
Error

GetPercentBatteryLife()
Returns a value from 0.0 to 1.0

GetCurrentPowerScheme();
Returns one of the following strings:
Throttle_None
Throttle_Constant
Throttle_Degrade
Throttle_Adaptive
Throttle_Undefined
Error

SetCurrentPowerScheme();
Accepts the following strings and sets the power scheme accordingly
Throttle_None
Throttle_Constant
Throttle_Degrade
Throttle_Adaptive
If an invalid string is specified, an error message is displayed

Get80211SignalStrength();
Returns a value from 0.0 to 1.0

These two functions are provided for testing purposes:
--------------------------------------------------------
SetFakeConnectivityLevel(float);
Accepts a number from 0.0 to 1.0 to use for the fake battery level.

SetFakeBatteryLevel(float);
Accepts a number from 0.0 to 1.0 to use for the fake battery level.