Sensor -Data Compensator Overview

Description -

The sensor channel APIs retrieve coordinate information and angle -data from different sensors when a display or device orientation change is -detected. The data is bound to the device form factor and hardware configuration -using device based coordinate system. Using the data, the sensor data compensator -APIs can adjust the coordinate system to match the changed system characteristics. -This procedure is called sensor data compensation.

For example, if -a display orientation change (as illustrated in the following figure) is detected, -the accelerometer sensor provides axis data using the device base coordinate -system. To convert the axis data to match the current display orientation, -sensor data compensator APIs can be used. The data compensator APIs enable -you to adjust the coordinate system to match the changed system characteristics.

-Example to illustrate adjustment of the coordinate system due to device -orientation change - -

To convert the sensor data to the compensated values, the adjustment -values (for example, interchanged x-axis with y-axis) for each device state -that the compensation is applied to, must be configured and taken as an input -for calculations.

-Correcting the coordinate system of a Symbian device -The figure depicts the correction of coordinate system in the Symbian -device - -

The following example explains how the sensor data compensation works, -by illustrating the behavior of maps application of the Symbian device when -the keyboard is in opened and closed state.

- - - -Symbian device position -Symbian device movement -Application behavior - - - - -The keyboard is closed and the display is upward and parallel with -the table surface -The Symbian device spins around the z-axis -The compass needle points to the north and the map does not move on -the screen. - - -The keyboard is opened and the display is upward and parallel with -the table surface -The Symbian device spins around the z-axis -The compass needle points to the north and the map is always in the -north-south direction on the screen. - - - -

APIs - - - -API -Description - - - - -CSensorDataCompensator -The sensor data compensator class provides functions to -compensate sensor data. - - - -

Typical Uses

Compensating -Sensor Data

+ + + + + +Sensor +Data Compensator OverviewThe Sensor Data Compensator provides APIs to correct sensor data, +based on device or display orientation. That is, using the APIs, the coordinate +system can be adjusted appropriately to get correct sensor axis data in relation +to the Symbian device user's current display orientation. +

Description +

The sensor channel APIs retrieve coordinate information and angle +data from different sensors when a display or device orientation change is +detected. The data is bound to the device form factor and hardware configuration +using device based coordinate system. Using the data, the sensor data compensator +APIs can adjust the coordinate system to match the changed system characteristics. +This procedure is called sensor data compensation.

For example, if +a display orientation change (as illustrated in the following figure) is detected, +the accelerometer sensor provides axis data using the device base coordinate +system. To convert the axis data to match the current display orientation, +sensor data compensator APIs can be used. The data compensator APIs enable +you to adjust the coordinate system to match the changed system characteristics.

+Example to illustrate adjustment of the coordinate system due to device +orientation change + +

To convert the sensor data to the compensated values, the adjustment +values (for example, interchanged x-axis with y-axis) for each device state +that the compensation is applied to, must be configured and taken as an input +for calculations.

+Correcting the coordinate system of a Symbian device +The figure depicts the correction of coordinate system in the Symbian +device + +

The following example explains how the sensor data compensation works, +by illustrating the behavior of maps application of the Symbian device when +the keyboard is in opened and closed state.

+ + + +Symbian device position +Symbian device movement +Application behavior + + + + +The keyboard is closed and the display is upward and parallel with +the table surface +The Symbian device spins around the z-axis +The compass needle points to the north and the map does not move on +the screen. + + +The keyboard is opened and the display is upward and parallel with +the table surface +The Symbian device spins around the z-axis +The compass needle points to the north and the map is always in the +north-south direction on the screen. + + + +

APIs + + + +API +Description + + + + +CSensorDataCompensator +The sensor data compensator class provides functions to +compensate sensor data. + + + +

Typical Uses

Compensating +Sensor Data

\ No newline at end of file