|
|
|
|
|
|
|
|
|
|
- Use conditions
- Device orientation: definitions
- Stopping the detection
SensorDetectChangeOrientation (Function) Allows you to be notified when the orientation of the device changes on any one of its 3 axes.
SensorDetectChangeOrientation(DetectOrientation, snrAzimuth + snrPitch + snrRoll)
PROCEDURE DetectOrientation(nAzimuth is int, nPitch is int, nRoll is int)
IF nAzimuth = 0 OR nAzimuth = 360 THEN
ToastDisplay("The device is oriented to the North.")
END
SensorEnd()
Sintaxis
<Result> = SensorDetectChangeOrientation(<WLanguage procedure> [, <Orientation> [, <Frequency> [, <Threshold>]]])
<Result>: Boolean - True if the detection was triggered,
- False otherwise.
<WLanguage procedure>: Procedure name Name of the WLanguage procedure ("callback") called when the device changes orientation. This procedure has the following format:PROCEDURE <Procedure name> (<Azimuth>, <Pitch>, <Roll>) where: - <Azimuth> is an integer corresponding to the angle between the direction of the magnetic North and the direction of the longitudinal axis (Y) of the device,
- <Pitch> is an integer corresponding to the rotation angle of the device around the horizontal axis (X)
- <Roll> is an integer corresponding to the rotation angle of the device around the longitudinal axis (Y).
The parameters of this procedure are optional. There is no need to pass parameters to this procedure. Indeed, these parameters are automatically filled during each call providing that the corresponding type of orientation is specified in <Orientation>. Otherwise, these parameters are set to 0. If the name of the procedure corresponds to an empty string (""), the notifications for change of orientation corresponding to <Orientation> will not be sent anymore. <Orientation>: Optional Integer constant (or combination of constants) Type of orientation change that must be noted: | | | snrAzimuth | Notification when the orientation changes around the vertical axis (Z). | | snrPitch | Notification when the orientation changes around the horizontal axis (X). | | snrRoll | Notification when the orientation changes around the longitudinal axis (Y). |
By default, a notification will be sent when the orientation changes on any one of the three axes (equivalent to snrAzimuth + snrPitch + snrRoll). <Frequency>: Optional Integer constant Frequency according to which the notifications for changes of orientation must be sent: | | | snrFrequencyGame | Notification frequency required when using SensorDetectChangeOrientation in a game. | snrFrequencyNormal
(Default value) | Standard frequency of notification. | | snrFrequencyQuick | Fast frequency of notification. |
<Threshold>: Optional integer Threshold for tolerance in changing (in degrees). The notifications will be sent for the changes of orientation greater than this threshold. If this parameter is not specified, no tolerance threshold will be set: notifications will be sent for each change of orientation (equivalent to a threshold of 0). Observaciones Use conditions - This function cannot be used in the emulator or in the simulator. In both cases, the result of the function will always be set to False.
- The detection of orientation changes uses the accelerometer sensor found on the device. No detection of orientation changes will be performed if this sensor is not found on the device. The sensitivity of the detection depends on the quality of the sensor in the device.
- Only the last call to SensorDetectChangeOrientation is taken into account. Indeed, there can only be one detection at a time. To perform a detection according to multiple axes, you must combine the orientations.
Device orientation: definitions The change of orientation can be specified according to the three following dimensions: - Azimuth Direction of object snapping with respect to magnetic North around vertical axis (Z). This direction is expressed in degrees (from 0 to 360 degrees). In this case, 0 or 360 corresponds to the North, 90 corresponds to the East, 180 corresponds to the South and 270 corresponds to the West.
- Pitch Rotation of the device around the horizontal axis (X). This rotation is expressed in degrees (from -180 to 180). Its value is set to 0 degree when the device lies down flat with the screen pointing to the ceiling, -90 degrees when the device stands still with the top of the device pointing to the ceiling, 90 degrees when the device stands still with the top of the device pointing to the ground and -180/180 degrees when the device lies down flat with the screen pointing to the ground.
- Roll Rotation of the device around the longitudinal axis (Y). This rotation is expressed in degrees (from -90 to 90). Its value is set to 0 degree when the device lies down flat with the screen pointing to the ceiling, -90 degrees when the screen is oriented to the left and 90 degrees when the screen is oriented to the right.
Coordinate system (assuming the device is laying flat, with the screen facing up): - The origin is found in the lower-left corner of the screen.
- The X-axis represents the horizontal axis and it points to the right of the screen.
- The Y-axis represents the longitudinal axis and it points to the top of the screen.
- The Z-axis represents the vertical axis and it points outside the front of the screen.
Stopping the detection It is advisable to stop detecting changes in orientation if no longer required, in order to save battery power.. To do so, <WLanguage procedure> must correspond to an empty string (""). SensorEnd is used to stop all the current detections.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|