distancia#

Inicializando la clase de distancia #

Un sensor de distancia se crea utilizando el siguiente constructor:

El constructor distancia crea un objeto de la clase distancia en el puerto especificado.

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 Distance1 = distance(PORT1);

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

Métodos de clase #

Distancia del objeto()#

El método objectDistance(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	Una unidad de distancia válida.

Devuelve: Un doble que representa la distancia al objeto detectado en las unidades especificadas.

// Get the distance detected by the Distance Sensor in inches.
double value = Distance1.objectDistance(inches);

objectSize()#

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

Devuelve: Un sizeType que representa el tamaño estimado del objeto detectado.

// Get the object size detected by the Distance Sensor.
sizeType size = Distance1.objectSize();

objectVelocity()#

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

Devuelve: Un doble que representa la velocidad del objeto detectado en metros por segundo.

esObjetoDetectado()#

El método isObjectDetected() regresa si se detecta un objeto.

Devuelve: true si se detecta un objeto. false si no se detecta un objeto.

cambió()#

El método changed(callback) 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.

Devoluciones: Ninguna.

// Define the distanceChanged function with a void return
// type, showing it doesn't return a value.
void distanceChanged() {
  // The Brain will print that the distance changed on the
  // Brain's screen.
  Brain.Screen.print("distance changed");
}

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Drive the robot forward.
  Drivetrain.drive(forward);

  // Run distanceChanged when the value of the distance 
  // detected by the Distance Sensor changes.
  Distance1.changed(distanceChanged);
}

objectRawSize()#

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

Devuelve: Un entero con signo de 32 bits que representa el tamaño sin procesar del objeto detectado.

// Get the raw size of the object detected by the distance sensor.
int32_t size = Distance1.objectRawSize();

marca de tiempo()#

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

Devuelve: Marca de tiempo del último paquete de estado como un entero de 32 bits sin signo en milisegundos.

instalado()#

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

Devuelve: true si el sensor de distancia está conectado. false si no lo está.