Distancia

Introducción

El sensor de distancia puede detectar objetos directamente frente a él y medir su distancia. El sensor de 1.ª generación utiliza un sonar para la detección, mientras que el sensor de 2.ª generación utiliza un láser apto para aulas y también puede estimar el tamaño y la velocidad de un objeto.

For the examples below, the configured Distance Sensors will be named distance_1 and will be used in all subsequent examples throughout this API documentation when referring to Distance and Sonar class methods.

A continuación se muestra una lista de todos los métodos disponibles:

Obtenedores: devuelven datos del sensor de distancia.

• is_object_detected – (1st and 2nd Gen) Returns whether an object is within range.

• distance – (1st Gen) Returns the distance to the nearest object.

• object_distance – (2nd Gen) Returns the distance to the nearest object in inches, millimeters, or centimeters.

• object_velocity – (2nd Gen) Returns the speed of a detected object in meters per second.

• object_size – (2nd Gen) Returns the estimated size of the detected object (small, medium, large).

• installed – (1st and 2nd Gen) Returns whether the Distance Sensor is connected to the Brain.

Constructores: inicializan y configuran manualmente un sensor de distancia.

• Sonar – Create a (1st Gen) Distance Sensor.

• Distance – Create a (2nd Gen) Distance Sensor.

Captadores

is_object_detected

is_object_detected returns a Boolean indicating whether the Distance Sensor detects an object within range.

• True - The Distance Sensor detects an object.

• False - The Distance Sensor does not detect an object.

Usage:
distance_1.is_object_detected()

Parámetros	Descripción
	Este método no tiene parámetros.

# Example coming soon

distance

distance returns the current distance from the Distance Sensor and a detected object as a float.

Nota: Este es un método de sensor de distancia (1.ª generación).

Usage:
distance_1.distance(units)

Parámetros	Descripción
units	Optional. The unit that represents the distance: INCHES MM (default) – Millimeters

# Example coming soon

object_distance

object_distance returns the distance between the Distance Sensor and the nearest object as a float.

Nota: Este es un método de sensor de distancia (2.ª generación).

Usage:
distance_1.object_distance(units)

Parámetros	Descripción
units	Optional. The unit that represents the distance: INCHES MM (default) – Millimeters DistanceUnits.CM – Centimeters

# Example coming soon

object_velocity

object_velocity returns the velocity of a detected object as a float, measured in meters per second. A positive value indicates the object is moving toward the Distance Sensor (2nd gen), while a negative value indicates it is moving away.

Nota: Este es un método de sensor de distancia (2.ª generación).

Usage:
distance_1.object_velocity()

Parámetros	Descripción
	Este método no tiene parámetros.

# Example coming soon

object_size

object_size returns an ObjectSizeType, which represents the estimated size of the detected object based on how much of the Distance Sensor (2nd gen)’s field of view it occupies:

• ObjectSizeType.NONE – No object is detected, or the object is so close that it fills the entire field of view.

• ObjectSizeType.SMALL – The object occupies a small portion of the field of view.

• ObjectSizeType.MEDIUM – The object occupies roughly half of the field of view.

• ObjectSizeType.LARGE – The object occupies most of the field of view.

Nota: Este es un método de sensor de distancia (2.ª generación).

Usage:
distance_1.object_size()

Parámetros	Descripción
	Este método no tiene parámetros.

# Example coming soon

installed

installed returns a Boolean indicating whether the Distance Sensor is connected to the Brain.

• True - The Distance Sensor is connected to the Brain.

• False - The Distance Sensor is not connected to the Brain.

Usage:
distance_1.installed()

Parámetros	Descripción
	Este método no tiene parámetros.

# Example coming soon

Constructores

Constructors are used to manually create Distance and Sonar objects, which are necessary for configuring a Distance Sensor (2nd gen) or (1st gen) outside of VEXcode.

Sonar

Sonar creates a Distance Sensor (1st gen).

Usage:
distance_1 = Sonar(port)

Parámetro	Descripción
port	Which Smart Port that the Distance Sensor (1st gen) is connected to as Ports.PORT followed by the port number, ranging from 1 to 12.

# Example coming soon

Distance

Distance creates a Distance Sensor (2nd gen).

Usage:
distance_1 = Distance(port)

Parámetro	Descripción
port	Which Smart Port that the Distance Sensor (2nd gen) is connected to as Ports.PORT followed by the port number, ranging from 1 to 12.

# Example coming soon