Package 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.

Field Summary

Fields

Modifier and Type	Field	Description
static int	MAX_MULTIPLIER	Maximum value for the GPU multiplier: .
static int	MIN_MULTIPLIER	Minimum value for the GPU multiplier: .

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	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

Field Detail

MIN_MULTIPLIER

public static final int MIN_MULTIPLIER

Minimum value for the GPU multiplier: .

See Also:

Constant Field Values

MAX_MULTIPLIER

public static final int MAX_MULTIPLIER

Maximum value for the GPU multiplier: .

See Also:

Constant Field Values

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.

java.lang.UnsupportedOperationException - If this functionality is not supported.

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.

java.lang.UnsupportedOperationException - If this functionality is not supported.

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)

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()