ch.aplu.android.ev3

Class NxtUltrasonicSensor

java.lang.Object

ch.aplu.android.ev3.Part

ch.aplu.android.ev3.Sensor

ch.aplu.android.ev3.NxtUltrasonicSensor

public class NxtUltrasonicSensor
extends Sensor

Class that represents a NXT ultrasonic sensor.

Constructor Summary

Constructors

Constructor and Description
NxtUltrasonicSensor() Creates a sensor instance connected to port S1.
NxtUltrasonicSensor(SensorPort port) Creates a sensor instance connected to the given port.

Method Summary

Methods

Modifier and Type	Method and Description
void	addLightListener(UltrasonicListener ultrasonicListener) Registers the given ultrasonic listener with default trigger level 500.
void	addLightListener(UltrasonicListener ultrasonicListener, int triggerLevel) Registers the given ultrasonic listener for the given trigger level.
void	eraseBeamArea() Erases the beam area (if it is currently shown).
int	getDistance() Polls the sensor.
void	setBeamAreaColor(java.awt.Color color) Sets the color of the beam area (two sector border lines and axis).
void	setMeshTriangleColor(java.awt.Color color) Sets the color of the triangle mesh lines.
void	setProximityCircleColor(java.awt.Color color) Sets the color of the circle with center at sensor location and radius equals to the current distance value.
int	setTriggerLevel(int triggerLevel) Sets a new trigger level and returns the previous one.

Methods inherited from class java.lang.Object

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

Constructor Detail

NxtUltrasonicSensor

public NxtUltrasonicSensor(SensorPort port)

Creates a sensor instance connected to the given port.

Parameters:

port - the port where the sensor is plugged-in

NxtUltrasonicSensor

public NxtUltrasonicSensor()

Creates a sensor instance connected to port S1.

Method Detail

addLightListener

public void addLightListener(UltrasonicListener ultrasonicListener,
                    int triggerLevel)

Registers the given ultrasonic listener for the given trigger level.

Parameters:

ultrasonicListener - the UltrasonicListener to become registered.

triggerLevel - the trigger level where the callback is triggered

addLightListener

public void addLightListener(UltrasonicListener ultrasonicListener)

Registers the given ultrasonic listener with default trigger level 500.

Parameters:

ultrasonicListener - the UltrasonicListener to become registered.

setTriggerLevel

public int setTriggerLevel(int triggerLevel)

Sets a new trigger level and returns the previous one.

Parameters:

triggerLevel - the new trigger level

Returns:

the previous trigger level

getDistance

public int getDistance()

Polls the sensor.

Returns:

the current value the sensor reported (in cm), 255 if the sensor does not detect a target.

setMeshTriangleColor

public void setMeshTriangleColor(java.awt.Color color)

Sets the color of the triangle mesh lines. Empty method for compatibility with NxtSim.

Parameters:

color - the color of the mesh

setBeamAreaColor

public void setBeamAreaColor(java.awt.Color color)

Sets the color of the beam area (two sector border lines and axis). Empty method for compatibility with NxtSim.

Parameters:

color - the color of the beam area

eraseBeamArea

public void eraseBeamArea()

Erases the beam area (if it is currently shown). Empty method for compatibility with NxtSim.

setProximityCircleColor

public void setProximityCircleColor(java.awt.Color color)

Sets the color of the circle with center at sensor location and radius equals to the current distance value. If value = 0, no circle is shown. Empty method for compatibility with NxtSim.

Parameters:

color - the color of the circle