Differences

This shows you the differences between two versions of the page.

--- built_in:sensors [2014/12/05 13:48]
162.252.85.172 [Methods]
+++ built_in:sensors [2018/01/03 10:23] (current)
@@ Line 1: / Line 1: @@
-====== Sensor control ======
+====== Sensors ======
-===== Create =====
-Create Sensor objects using the CreateSensor function of the app object:
+//(Information and examples taken from the DroidScript documentation). Information provided by Nick Weber//
+===== Description =====
+Create Sensor objects using the **CreateSensor** function of the **[[built_in:app|app]]** object:
 <code>sns = app.CreateSensor( type, options );</code>
-Types available are: "Accelerometer", "MagneticField", "Orientation", "Light" and "Proximity".
+Types available are:
+  * **Accelerometer**
+  * **MagneticField**
+  * **Orientation**
+  * **Light**
+  * **Proximity**
+  * **Temperature**
+  * **GameRotation**
+  * **GeomagneticRotation**
+  * **Gravity**
+  * **Gyroscope**
+  * **HeartRate**
+  * **Acceleration**
+  * **Pressure**
+  * **Humidity**
+  * **Rotation**
+  * **Motion**
+  * **StepCounter**
+  * **StepDetector**
+Try **sns.GetNames()** which lists all the sensor information. You can probably scan for certain keywords.
+You can also use a sensor id number instead of the name (just in case a future sensor is added).
+You can use the **SetOnChange** function of the Sensor to set the name of a function you want to be called when a the changes occur.
+Change the rate that a sensor checks for changes by adding one the options **"Fastest"**, **"Fast"**, **"Medium"** or **"Slow"**.
+"Slow" is the default.
-You can use the SetOnChange function of the Sensor to set the name of a function you want to be called when a the changes occur.
-Change the rate that a sensor checks for changes by adding one the options "Fastest", "Fast", "Medium" or "Slow". "Slow" is the default.
 ===== Methods =====
-^Method ^Description ^
+Some controls use the same methods.\\
-|Sensor.Destroy() | |
+For examples of the **[[same methods]]** look here.
-|Sensor.GetAbsHeight() | |
+^ Method                          ^ Description                              ^
-|Sensor.GetAbsWidth() | |
+| Sensor.GetAzimuth()             |                                          |
-|Sensor.GetAzimuth() | |
+| Sensor.GetHeight()              |                                          |
-|Sensor.GetHeight() | |
+| Sensor.GetNames()               | returns a list of all available sensors  |
-|Sensor.GetPitch() | |
+| Sensor.GetPitch()               |                                          |
-|Sensor.GetPosition() | |
+| Sensor.GetRoll()                |                                          |
-|Sensor.GetRoll() | |
+| Sensor.GetType()                |                                          |
-|Sensor.GetType() | |
+| Sensor.GetValues()              |                                          |
-|Sensor.GetVisibility() | |
+| Sensor.SetMaxRate( rate )       | default 20ms                             |
-|Sensor.GetWidth() | |
+| Sensor.SetMinChange( value )    | a value between 0 and 1                  |
-|Sensor.Release() | |
+| Sensor.SetOnChange( callback )  |                                          |
-|Sensor.SetBackColor( p1 ) | |
+| Sensor.Start()                  |                                          |
-|Sensor.SetBackGradient( p1,p2,p3,p4,p5,p6,p7 ) | |
+| Sensor.Stop()                   |                                          |
-|Sensor.SetBackGradientRadial( p1,p2,p3,p4,p5,p6,p7 ) | |
-|Sensor.SetBackground( p1,p2 ) | |
+===== Examples =====
-|Sensor.SetMargins( left,top,right,bottom ) | |
+^Sensor Type ^Code Example ^
-|Sensor.SetMinChange( p1 ) | |
+|Accelerometer | <code javascript>function OnStart()
-|Sensor.SetOnChange( p1 ) | |
+{
-|Sensor.SetPadding( p1,p2,p3,p4 ) | |
+  lay = app.CreateLayout( "Linear", "VCenter,FillXY" );
-|Sensor.SetPosition( p1,p2,p3,p4 ) | |
-|Sensor.SetScale( x,y ) | |
+  txt = app.CreateText( "", 0.8, 0.3, "Multiline" );
-|Sensor.SetSize( p1,p2 ) | |
+  lay.AddChild( txt );
-|Sensor.SetVisibility( p1 ) | |
+  app.AddLayout( lay );
-|Sensor.Start() | |
-|Sensor.Stop() | |
+  sns = app.CreateSensor( "Accelerometer" );
+  sns.SetOnChange( sns_OnChange );
+  sns.Start();
+}
+function sns_OnChange( x, y, z, time )
+{
+  txt.SetText( "x="+x + "\n y="+y + "\n z="+z );
+}
+</code> |
+|Orientation | <code javascript>function OnStart()
+{
+  lay = app.CreateLayout( "Linear", "VCenter,FillXY" );
+  txt = app.CreateText( "", 0.8, 0.3, "Multiline" );
+  lay.AddChild( txt );
+  app.AddLayout( lay );
+  sns = app.CreateSensor( "Orientation" );
+  sns.SetOnChange( sns_OnChange );
+  sns.Start();
+}
+function sns_OnChange( azimuth, pitch, roll, time )
+{
+  var msg = " azimuth = " + azimuth.toFixed(1);
+  msg += "\n pitch = " + pitch.toFixed(1);
+  msg += "\n roll = " + roll.toFixed(1);
+  txt.SetText( msg );
+}
+</code> |
+|Light | <code javascript>function OnStart()
+{
+  lay = app.CreateLayout( "Linear", "VCenter,FillXY" );
+  txt = app.CreateText( "", 0.8, 0.3 );
+  lay.AddChild( txt );
+  app.AddLayout( lay );
+  sns = app.CreateSensor( "Light" );
+  sns.SetOnChange( sns_OnChange );
+  sns.Start();
+}
+function sns_OnChange( lux )
+{
+  txt.SetText( "level = " + lux + " lux" );
+}
+</code> |

DroidScript Wiki

User Tools

Site Tools

Differences

Page Tools