Sensor de distancia#

Introducción#

The distance class is used to control and access data from the V5 Distance Sensor. This sensor measures the distance between the sensor and nearby objects, allowing your robot to detect obstacles and determine proximity.

Constructores de clases#

distance( int32_t  index );

Instructor de clase#

Destroys the distance object and releases associated resources.

~distance();

Parámetros#

Parámetro

Tipo

Descripción

index

int32_t

The Smart Port that the Distance Sensor is connected to, written as PORTx, where x is the port number (for example, PORT1).

Ejemplos#

// Create a distance instance in Port 1
distance Distance1 = distance(PORT1);

Funciones de los miembros#

The distance class includes the following member functions:

  • objectDistance — Returns the distance currently detected by the sensor.

  • objectSize — Returns an estimate of the detected object’s size.

  • objectVelocity — Returns the velocity of the detected object.

  • isObjectDetected — Returns whether an object is currently detected.

  • changed — Registers a callback function that runs when the detected object changes.

  • installed — Returns whether the sensor is installed.

Before calling any distance member functions, a distance instance must be created, as shown below:

/* This constructor is required when using VS Code.
Distance Sensor configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create a distance instance in Port 1
distance Distance1 = distance(PORT1);

objectDistance#

Devuelve la distancia detectada actualmente por el sensor de distancia.

Available Functions 
double objectDistance( distanceUnits units );
Parameters

Parámetro

Tipo

Descripción

units

distanceUnits

The unit of measurement for the returned distance value:

  • mm — millimeters
  • cm — centimeters
  • inches — inches
Return Values

Returns a double representing the distance to the detected object in the specified units.

objectSize#

Devuelve una estimación del tamaño del objeto detectado.

Available Functions 
sizeType objectSize();
Parameters

Esta función no requiere ningún parámetro.

Return Values

Returns a sizeType indicating the estimated size of the detected object:

  • none — No object is detected.
  • small — The detected object is small.
  • medium — The detected object is medium in size.
  • large — The detected object is large.

objectVelocity#

Devuelve una estimación de la velocidad del objeto detectado.

Available Functions 
double objectVelocity();
Parameters

Esta función no requiere ningún parámetro.

Return Values

Returns a double representing the velocity of the detected object in meters per second.

isObjectDetected#

Indica si el sensor de distancia está detectando un objeto en ese momento.

Available Functions 
bool isObjectDetected();
Parameters

Esta función no requiere ningún parámetro.

Return Values

Devuelve un valor booleano que indica si se ha detectado un objeto:

  • true — An object is detected.
  • false — No object is detected.

changed#

Registra una función de devolución de llamada que se ejecuta cuando cambia el valor de distancia detectado.

Available Functions 
void changed( void (* callback)(void) );
Parameters

Parámetro

Tipo

Descripción

callback

void (*)(void)

A pointer to a function that will be called when the detected distance value changes. The function must take no parameters and return void.
Return Values

Esta función no devuelve ningún valor.

installed#

Indica si el sensor de distancia está conectado.

Available Functions 
bool installed();
Parameters

Esta función no requiere ningún parámetro.

Return Values

Devuelve un valor booleano que indica si el sensor de distancia está conectado:

  • true — The sensor is connected and responding.
  • false — The sensor is not connected or not detected.
En esta página