com.digi.android.system.gpu

Class GPUManager

java.lang.Object

com.digi.android.system.gpu.GPUManager

public class GPUManager
extends java.lang.Object

This class provides access to the GPU.

This manager allows applications to get and set the current GPU multiplier and the multiplier that will be applied when the module's temperature reaches the hot trip point.

Unless noted, all GPU API methods require the com.digi.android.permission.GPU permission. If your application does not have this permission it will not have access to any GPU service feature.

Constructor Summary

Constructors

Constructor and Description
GPUManager(android.content.Context context) Class constructor.

Method Summary

Methods

Modifier and Type	Method and Description
int	getMinMultiplier() Returns the the GPU multiplier that will be set when the module's temperature reaches the hot trip point.
int	getMultiplier() Returns the current GPU multiplier.
int	setMinMultiplier(int multiplier) Configures the GPU multiplier that will be set when the module's temperature reaches the hot trip point.
int	setMultiplier(int multiplier) Configures the new GPU multiplier.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GPUManager

public GPUManager(android.content.Context context)

Class constructor.

Instantiates a new object of type GPUManager with the given context.

Parameters:

context - The context to get the internal GPU handler.

Throws:

java.lang.NullPointerException - If context == null.

Method Detail

getMultiplier

public int getMultiplier()
                  throws java.io.IOException

Returns the current GPU multiplier.

The value of the multiplier is between 1 and 64. When set to 1, the GPU is configured with the minimum frequency, while when set to 64 it is configured with the maximum one.

Returns:

The current GPU multiplier.

Throws:

java.io.IOException - If an I/O error occurs.

See Also:

setMultiplier(int)

setMultiplier

public int setMultiplier(int multiplier)
                  throws java.io.IOException

Configures the new GPU multiplier.

The value of the multiplier must be between 1 and 64. When set to 1, the GPU is configured with the minimum frequency, while when set to 64 it is configured with the maximum one.

Note that in some modules the minimum allowed value of the GPU multiplier may be more than 1, so it is recommended to check the returned value.

Parameters:

multiplier - The new GPU multiplier.

Returns:

The configured GPU multiplier.

Throws:

java.lang.IllegalArgumentException - If multiplier < 1 or multiplier > 64.

java.io.IOException - If an I/O error occurs.

See Also:

getMultiplier()

getMinMultiplier

public int getMinMultiplier()
                     throws java.io.IOException

Returns the the GPU multiplier that will be set when the module's temperature reaches the hot trip point.

The value of the multiplier is between 1 and 64. When set to 1, the GPU is configured with the minimum frequency, while when set to 64 it is configured with the maximum one.

When the module's temperature drops 10 degrees from the hot trip point, the previous configured multiplier is restored.

Returns:

The current GPU multiplier that will be set when the module's temperature reaches the hot trip point.

Throws:

java.io.IOException - If an I/O error occurs.

See Also:

setMinMultiplier(int), CPUManager.getHotTemperature(), CPUManager.setHotTemperature(float)

setMinMultiplier

public int setMinMultiplier(int multiplier)
                     throws java.io.IOException

Configures the GPU multiplier that will be set when the module's temperature reaches the hot trip point.

The value of the multiplier must be between 1 and 64. When set to 1, the GPU is configured with the minimum frequency, while when set to 64 it is configured with the maximum one.

When the module's temperature drops 10 degrees from the hot trip point, the previous configured multiplier is restored.

Note that in some modules the minimum allowed value of the GPU multiplier may be more than 1, so it is recommended to check the returned value.

Parameters:

multiplier - The GPU multiplier that will be set when the module's temperature reaches the hot trip point.

Returns:

The configured GPU multiplier that will be set when the module's temperature reaches the hot trip point.

Throws:

java.lang.IllegalArgumentException - If multiplier < 1 or multiplier > 64.

java.io.IOException - If an I/O error occurs.

See Also:

getMinMultiplier(), CPUManager.getHotTemperature(), CPUManager.setHotTemperature(float)