Distancia#

Inicializando la clase de distancia #

Un sensor de distancia se crea utilizando el siguiente constructor:

Distancia(puerto)

Este constructor utiliza un parámetro:

Parámetro	Descripción
`puerto`	Un Puerto inteligente válido al que está conectado el sensor de distancia.

# Construct a Distance Sensor "distance" with the
# Distance class.
distance = Distance(Ports.PORT1)

Este objeto “distancia” se utilizará en todos los ejemplos posteriores a lo largo de esta documentación de API cuando se haga referencia a los métodos de la clase Distancia.

El método object_distance(units) devuelve la distancia que el sensor de distancia está leyendo actualmente. El sensor de distancia devolverá un número positivo grande si no se detecta ningún objeto.

Parámetros	Descripción
unidades	Opcional. Un tipo DistanceUnits válido. La unidad predeterminada es `MM`.

Devuelve: La distancia al objeto detectado en las unidades especificadas.

# Get the distance detected by the Distance Sensor in mm.
value = distance.object_distance()

# Get the distance detected by the Distance Sensor in inches.
value = distance.object_distance(INCHES)

object_size()#

El método object_size() devuelve una estimación del tamaño del objeto detectado.

Devuelve: El tamaño estimado del objeto detectado.

# Get the object size detected by the Distance Sensor.
size = distance.object_size()

object_velocity()#

El método object_velocity() devuelve la velocidad del objeto detectado. Esta velocidad se calcula mediante la variación de la distancia en función del tiempo.

Devuelve: La velocidad del objeto detectado en metros por segundo.

is_object_detected()#

El método is_object_detected() comprueba si se detecta un objeto.

Devuelve: «Verdadero» si se detecta un objeto. «Falso» si no se detecta un objeto.

changed()#

El método changed(callback, arg) registra una función de devolución de llamada para cuando cambia el objeto detectado.

Parámetros	Descripción
llamar de vuelta	Una función que se llamará cuando el objeto detectado cambie.
arg	Opcional. Una tupla que se utiliza para pasar argumentos a la función de devolución de llamada.

Devuelve: Una instancia de la clase Event.

# Define function distance_changed().
def distance_changed():
    # The Brain will print that the distance changed on
    # the Brain's screen.
    brain.screen.print("distance changed ")
# Run distance_changed() when the value detected by the 
# Distance Sensor changes.
distance.changed(distance_changed)

object_rawsize()#

El método object_rawsize() devuelve el valor bruto del tamaño del objeto que el sensor está detectando.

Devuelve: El tamaño sin procesar del objeto detectado.

# Get the raw size of the object detected by the
# Distance Sensor.
size = distance.object_rawsize()

installed()#

El método installed() verifica si el sensor de distancia está conectado.

Devuelve: «Verdadero» si el sensor de distancia está conectado. «Falso» si no lo está.

timestamp()#

El método timestamp() devuelve la marca de tiempo del último paquete de estado recibido del sensor de distancia.

Devuelve: La marca de tiempo del último paquete de estado recibido en milisegundos.